ExMachina Telegram Bridge - Asesor Experto para MetaTrader 5

QUÉ HACE

El EA detecta los eventos de operaciones a través de dos mecanismos independientes: el gestor OnTradeTransaction para la detección en tiempo real, y un análisis periódico del historial de operaciones como alternativa. Un sistema de deduplicación garantiza que nunca reciba la misma notificación dos veces, incluso si ambos mecanismos se activan en el mismo evento.

Notificaciones compatibles:

- Operación abierta: símbolo, dirección (COMPRA/VENTA), volumen, precio, SL, TP, número mágico, ticket de operación.

- Operación cerrada: símbolo, volumen, precio de cierre, P/L bruto, comisión, swap, P/L neto, saldo actualizado.

- SL/TP modificados: los valores antiguos y nuevos se muestran uno al lado del otro (por ejemplo, SL: 1924,00 → 1926,50)

- Órdenes pendientes: tipo (Buy Limit, Sell Limit, Buy Stop, Sell Stop, Buy Stop Limit, Sell Stop Limit), precio, volumen.

- Inversión de posiciones: nueva dirección, P/L cerrado

- Depósitos y retiradas: importe y saldo actualizado

- Resúmenes periódicos de la cuenta: saldo, fondos propios, margen libre, P/L flotante, P/L de sesión, posiciones abiertas, fondos propios máximos/mínimos del día, porcentaje de detracción

- Mensajes de conexión y desconexión con estadísticas de la sesión

CONFIGURACIÓN - PASO A PASO

Necesitas dos cosas de Telegram: un Bot Token y tu Chat ID.

Paso 1: Crear un Bot de Telegram

Abre Telegram, busca @BotFather e inicia una conversación. Envía el comando /newbot. BotFather te pedirá que elijas un nombre para mostrar (el que quieras) y un nombre de usuario (debe terminar en "bot"). Una vez creado, BotFather te enviará un token API - una cadena larga parecida a 7123456789:AAH1bCdEfGhIjKlMnOpQrStUvWxYz. Copie este token.

Paso 2: Obtén tu ID de chat

En Telegram, busca @userinfobot (o @getmyid_bot) y envíale cualquier mensaje. Te responderá con tu ID de chat numérico (por ejemplo, 123456789). Copia este número.

Para notificaciones de grupo: añade tu bot a un grupo de Telegram, luego usa @getidsbot en el grupo para obtener el Chat ID del grupo (número negativo, por ejemplo -1001234567890).

Paso 3: Inicia una conversación con tu bot

Este paso es fácil de olvidar. Encuentra tu bot por su nombre de usuario en la búsqueda de Telegram, ábrelo y pulsa Iniciar. Si te saltas esto, la API de Telegram rechazará todos los mensajes.

Paso 4: Permitir WebRequest en MetaTrader 5

En MT5, ve a Herramientas → Opciones → Asesores Expertos. Marca la opción "Permitir WebRequest para la URL listada". Haga clic en Agregar e introduzca exactamente: https://api.telegram.org - a continuación, haga clic en Aceptar. Esta es una configuración de una sola vez. Si omite este paso, verá el error WebRequest 4014 en la pestaña Expertos y no se enviará ningún mensaje.

Paso 5: Instalar el EA

Copie ExMachina_TelegramBridge.mq5 en su carpeta MQL5/Experts/ (acceda a través de Archivo → Abrir carpeta de datos en MT5). Abra MetaEditor (F4), navegue hasta el archivo y pulse Compilar (F7). Debería ver 0 error(es), 0 advertencia(s).

Paso 6: Adjuntar a un gráfico

Arrastre el EA desde el panel Navegador a cualquier gráfico. En el diálogo de configuración, pegue su Bot Token y Chat ID. Haga clic en OK. En unos segundos, debería recibir un mensaje de conexión en Telegram mostrando su número de cuenta, servidor, saldo, equidad y número de posiciones abiertas.

PARÁMETROS DE ENTRADA

Configuración de Telegram:

- Bot Token: tu token API de @BotFather (obligatorio)

- Chat ID: tu ID numérico de chat (requerido, puede ser un ID de grupo)

Configuración de Notificación:

- Notify on Trade Open: true/false (por defecto: true)

- Notify on Trade Close: true/false (por defecto: true)

- Notificar Modificación SL/TP: true/false (por defecto: true)

- Notificar órdenes pendientes: true/false (por defecto: true)

- Notificar Depósito/Retirada: true/false (por defecto: true)

Resumen de cuenta:

- Intervalo de informe de resumen: Desactivado, Cada 1 hora, Cada 4 horas, Cada 8 horas, Cada 24 horas (por defecto: Cada 4 horas)

- Incluir capital en resumen: true/false (por defecto: true)

- Incluir información de reducción: true/false (por defecto: true)

Visualización y estilo:

- Estilo del mensaje: Mínimo (compacto de una línea), Detallado (información completa con etiquetas), o Rico en Emoji (detallado con iconos Unicode). Por defecto: Rico en emoji.

- Mostrar el panel en el gráfico: true/false (por defecto: true)

- Fondo del panel, color del texto, color de acento: personalizables. Por defecto utiliza la paleta de acero de ExMachina.

Filtros:

- Filtro de símbolos: lista separada por comas de los símbolos a supervisar. Dejar vacío para todos los símbolos. Ejemplo: "EURUSD,XAUUSD"

- Min Lot Size to Notify: volumen mínimo para activar una notificación. 0 = sin filtro. Útil para ignorar microlotes.

- Filtro de número mágico: sólo notifica operaciones con este número mágico específico. -1 = todas las operaciones (incluidas las manuales).

ESTILOS DE MENSAJE

Mínimo: formato compacto de una sola línea:

XAUUSD | COMPRA | 0.50 lotes @ 1928.45

Detallado - estructurado con campos etiquetados:

OPERACIÓN CERRADA

━━━━━━━━━━━━━━━━━━━━

Símbolo: XAUUSD

Cierre: VENTA (cierre COMPRA)

Volumen: 0,50 lotes

Precio: 1935.20

───────────────────

Ganancia bruta: +340,00

Comisión: -$2.50

Intercambio: -0,00

P/L neto: +$337.50

Saldo: 10.585,00 USD

Oferta #182947363

Rico en Emoji (por defecto) - igual que Detallado pero con iconos Unicode para cada campo. La apertura de la operación muestra un círculo verde para COMPRA y un círculo rojo para VENTA. Los cierres muestran una marca de verificación para las ganancias y una cruz para las pérdidas.

FILTROS

El filtro Número Mágico es especialmente útil si ejecuta varios EAs en la misma cuenta. Ajústelo al número mágico de un EA específico para recibir sólo notificaciones de ese EA. Establézcalo en -1 para recibir todo (incluyendo operaciones manuales).

El filtro Símbolo acepta una lista separada por comas: "XAUUSD,EURUSD,GBPUSD". Sólo las operaciones con esos símbolos generarán notificaciones. Déjelo vacío para supervisar todos los símbolos.

RESÚMENES DE CUENTA

Los resúmenes periódicos incluyen: saldo, capital, margen libre, número de posiciones abiertas, P/L flotante total (incluyendo swap), P/L de sesión desde que se inició el EA, capital máximo del día, capital mínimo del día y porcentaje de reducción calculado a partir del máximo del día.

Útil para los operadores que necesitan supervisar los límites de reducción diarios de forma remota. Ajuste el intervalo a 1 hora durante las sesiones activas.

PANEL DE CONTROL EN EL GRÁFICO

Un panel de estado compacto en la esquina superior izquierda del gráfico muestra:

- Estado de la conexión: CONECTADO (verde) o DESCONECTADO (rojo)

- Nombre de usuario del bot

- Contadores en funcionamiento: mensajes enviados y fallidos

- Eslogan de ExMachina

El cuadro de mandos utiliza por defecto la paleta de acero de ExMachina (fondo C'8,10,18', acento C'0,180,220') y puede personalizarse o desactivarse a través de las entradas de Pantalla.

CÓMO REALIZAR LA PRUEBA

Paso 1: Conecte el EA a cualquier gráfico de una cuenta demo. Compruebe en la pestaña Expertos "Conectado a bot @YourBotName". Compruebe el mensaje de conexión en Telegram.

Paso 2: Abra una pequeña orden de mercado manualmente (por ejemplo, 0,01 lotes EURUSD). Deberías recibir una notificación de "OPERACIÓN ABIERTA".

Paso 3: Modifica el SL o TP de tu posición abierta (click derecho → Modificar). Debería recibir una notificación de "SL/TP MODIFICADO" mostrando los valores antiguos → los nuevos.

Paso 4: Cierre la posición. Recibirá una notificación de "OPERACIÓN CERRADA" con el desglose de P/L.

Paso 5: Coloque una orden pendiente (por ejemplo, Buy Limit). Debería recibir una notificación de "ORDEN PENDIENTE COLOCADA".

Paso 6: Retire el EA del gráfico. Debería recibir un mensaje de "Desconectado" con las estadísticas de la sesión.

Prueba rápida de navegador: para verificar su token e ID de chat antes de utilizar el EA, pegue esta URL en cualquier navegador (sustituya los marcadores de posición):

https://api.telegram.org/bot<TU_TOKEN>/sendMessage?chat_id=<TU_ID_CHAT>&text=Test

Si ve {"ok":true} en la respuesta, sus credenciales son correctas.

Rápida prueba de humo de secuencia de comandos: guardar esto como una secuencia de comandos (no EA) en MQL5 / Scripts /, compilar y ejecutar en un gráfico de demostración:

#include <Trade\Trade.mqh>

void OnStart()

{

CTrade comercio;

trade.Buy(0.01, "EURUSD");

Sleep(3000);

for(int i = TotalPosiciones()-1; i >= 0; i--)

{

if(PositionGetSymbol(i) == "EURUSD")

trade.PositionClose(PositionGetTicket(i));

}

}

Debería recibir una notificación de apertura y cierre en Telegram.

Importante: este EA no funciona en el Probador de Estrategias. El Probador de Estrategias no soporta WebRequest (llamadas de red). El EA debe ejecutarse en un gráfico real o demo con acceso a Internet.

EJECUCIÓN JUNTO A OTROS EAs

MT5 sólo permite un EA por gráfico. Adjunte el Telegram Bridge a un gráfico separado (cualquier símbolo). Monitoriza toda la cuenta, no sólo el gráfico al que está conectado. Todas las operaciones de todos los EAs y operaciones manuales serán detectadas independientemente del gráfico en el que se esté ejecutando el Bridge.

Utilice el filtro Número Mágico para limitar las notificaciones a un EA específico.

SOLUCIÓN DE PROBLEMAS

No se reciben mensajes:

1. Compruebe que https://api.telegram.org está en Herramientas → Opciones → Asesores Expertos → Permitir WebRequest.

2. Verifique que el Bot Token y el Chat ID sean correctos (sin espacios extra)

3. Asegúrate de que has pulsado Start en el chat de Telegram de tu bot

4. Comprueba si hay mensajes de error en la pestaña Expertos (Ver → Caja de herramientas → Expertos)

WebRequest error 4014: la URL de Telegram no está en la lista permitida. Este es el problema más común.

HTTP 401 No autorizado: token de bot no válido. Cópialo de nuevo de @BotFather.

HTTP 400 Bad Request: ID de chat incorrecto, o no has iniciado una conversación con tu bot.

HTTP 429 Demasiadas Peticiones: Límite de tasa de Telegram. El EA tiene incorporada una lógica de reintento con backoff. Esto sólo ocurre con una frecuencia de operaciones extremadamente alta.

El EA muestra INIT_PARAMETERS_INCORRECT: Bot Token y Chat ID son ambos requeridos. Asegúrese de que ninguno de los dos campos está vacío.

El panel de control no se muestra: asegúrese de que "Mostrar panel de control en el gráfico" está establecido en true en las entradas del EA.

DETALLES TÉCNICOS

- Detección de operaciones: mecanismo dual vía OnTradeTransaction (tiempo real) + sondeo del historial de operaciones cada 2 segundos (fallback)

- Deduplicación: operaciones procesadas almacenadas en memoria (seguimiento de las últimas 500 operaciones)

- Detección SL/TP: matriz de instantáneas de posición comparada en cada tick, se activa en cualquier cambio

- API de Telegram: HTTPS POST vía WebRequest, carga codificada en URL, modo de análisis Markdown

- Lógica de reintentos: hasta 3 intentos por mensaje, retardo de 1 segundo entre reintentos, retardo de 3 segundos en HTTP 429

- Prueba de conexión: Llamada al punto final /getMe al inicio para validar el token y recuperar el nombre del bot.

- Temporizador de resumen: EventSetTimer(60) comprueba si ha transcurrido el intervalo configurado

- Objetos gráficos: todos los objetos del cuadro de mandos utilizan el prefijo "EXTB_" y se limpian al desiniciar

- Sin DLLs externas, sin servidores de terceros. Comunicación directa MT5 → Telegram a través de HTTPS.

Este EA es gratuito y de código abierto. Comentarios, valoraciones y sugerencias son bienvenidas.

ExMachina Trading Systems - Precisión antes que beneficio.