Private Trade Alerts to Telegram
- Utilidades
-
Themistokli Kola
MQL4 / MQL5 and Pine Script developer.
What I do:
- Pine Script to MQL5 / MQL4 conversions (TradingView indicators and strategies into MT5/MT4 indicators or EAs)
- Fixes and changes to existing EAs and indicators: bugs, new inputs, filters, daily limits, breakeven and trailing logic - Versión: 1.0
- Activaciones: 5
«Private Trade Alerts to Telegram» envía los eventos de tu propia cuenta de MetaTrader 5 a tu chat de Telegram, a través de tu propio bot de Telegram: posiciones abiertas y cerradas, cierres parciales, cambios en el SL y el TP, órdenes pendientes, un resumen diario y avisos opcionales. Solo informa de lo que ha ocurrido en la cuenta. Nunca abre, modifica ni cierra una operación, y no ofrece señales ni consejos.
Configuración en 5 pasos
- Crea tu bot. En Telegram, abre el chat oficial de BotFather, envía el comando «newbot» y sigue las instrucciones. Te proporcionará un token de bot (dos partes unidas por dos puntos). Manténlo en secreto: cualquiera que lo tenga podrá enviar mensajes en nombre de tu bot.
- Averigua tu ID de chat. Envía cualquier mensaje a tu nuevo bot y, a continuación, busca tu ID numérico de chat, por ejemplo, con un bot auxiliar de chat-id en Telegram. Si se trata de un grupo privado, añade el bot al grupo; los ID de grupo comienzan con un signo menos.
- Permite la dirección de Telegram en MetaTrader 5. En Herramientas, Opciones, Asesores expertos, marca la casilla «Permitir WebRequest para la URL indicada» y añade la dirección de la API del bot de Telegram. La dirección exacta aparece en el panel y en el registro de expertos cuando falta, por lo que puedes copiarla desde allí.
- Adjunta el asesor experto. Arrastra «Private Trade Alerts to Telegram» a cualquier gráfico de la cuenta. Introduce el token del bot y el ID del chat, selecciona los eventos que desees y pulsa Aceptar. Basta con un gráfico por cuenta: el asesor experto informa de todos los símbolos de la cuenta, a menos que los filtres.
- Comprueba el mensaje de prueba. Con la opción «Enviar un mensaje de prueba al iniciar» activada, recibirás «Alertas iniciadas» en tu chat en unos segundos y el panel mostrará el estado: Listo. Deja el gráfico abierto: las alertas se envían mientras la terminal está en funcionamiento.
Configuración de Telegram
- Token del bot: el token del paso 1. Solo se muestran sus últimos 4 caracteres en el panel o en el registro.
- ID del chat: tu ID de chat del paso 2.
- Segundo ID de chat (opcional): un segundo destino, por ejemplo, un grupo privado. Todos los mensajes se envían a ambos.
- Enviar un mensaje de prueba al inicio: envía «Alertas activadas» cada vez que se inicia el EA, para que puedas comprobar que la conexión funciona.
- Usar formato HTML: muestra los títulos de los mensajes en negrita. Desactivado = texto sin formato.
Eventos
- Posiciones abiertas: símbolo, compra o venta, volumen, precio, SL, TP, número mágico o «manual», comentario, hora.
- Cierres y cierres parciales: volumen cerrado, precio de cierre, precio de apertura, resultado en la divisa de la cuenta y, opcionalmente, en puntos, y el motivo: manualmente, mediante un asesor experto, activación de SL, activación de TP, stop out. Un cierre parcial también muestra el volumen restante.
- Cambios en SL y TP: SL y TP antiguos y nuevos de la posición.
- Órdenes pendientes: colocadas, modificadas (precio anterior y nuevo, SL, TP), eliminadas, caducadas. Una orden pendiente ejecutada se indica como «Orden pendiente ejecutada — posición abierta».
- Resumen diario: una vez al día: operaciones cerradas del día, suma de sus resultados, saldo, capital y posiciones abiertas.
- Hora del resumen diario: HH:MM en la hora del terminal (servidor de operaciones), por ejemplo, 23:55. Si el EA se inicia después de esta hora, se omite el resumen de ese día en lugar de enviarse con retraso.
- Aviso de nivel de margen por debajo de este %: un aviso cuando el nivel de margen cae por debajo de este valor, solo mientras haya posiciones abiertas. Solo se vuelve a enviar una vez que el nivel se ha recuperado. 0 = desactivado.
- Aviso de caída diaria del patrimonio en %: una advertencia, una vez al día, cuando el patrimonio se sitúe un porcentaje inferior al patrimonio al inicio de la jornada. 0 = desactivado.
- Alerta cuando el terminal se vuelve a conectar: un mensaje que aparece después de que la conexión con el servidor de operaciones se haya perdido durante más de unos segundos y se haya restablecido.
- Mensaje de «heartbeat» cada N horas: un breve mensaje indicando que «las alertas están activas», con el saldo y el patrimonio. 0 = desactivado.
Filtros y formato
- Símbolos: lista separada por comas, por ejemplo, EURUSD,XAUUSD. Vacío = todos los símbolos.
- Número mágico: muestra solo las operaciones con este número mágico del Asesor Experto; -1 = todas.
- Incluir operaciones manuales: muestra las operaciones abiertas manualmente (número mágico 0).
- Etiqueta de la cuenta: se muestra en la parte superior de cada mensaje entre corchetes. Si se deja en blanco = «Cuenta ****» y los últimos 4 dígitos del número de cuenta.
- Mostrar también los resultados en puntos: añade el resultado en puntos a los mensajes de cierre.
- Desfase horario para las horas de los mensajes: horas que se añaden a las horas que aparecen en los mensajes.
- Mostrar panel, Panel X, Panel Y: el pequeño panel del gráfico y su posición. El botón «menos» lo contrae a una sola línea; el botón «más» lo vuelve a abrir.
El panel
Nombre del producto; estado (Listo, Enviando, Añadir la dirección de Telegram en Opciones, Falta el token o el ID del chat, Token del bot rechazado por Telegram, Tester: envío en curso); chat y token (solo los 4 últimos caracteres); mensajes enviados hoy y longitud de la cola; la hora del último mensaje; y el último error en lenguaje sencillo.
Envío, límites y errores
- Los mensajes esperan en una cola y se envían a razón de uno por segundo, con un máximo de 20 por minuto (límites propios de Telegram). La cola tiene capacidad para hasta 200 mensajes; si se supera ese número, se descarta el más antiguo y así se indica en el registro de Experts.
- Si Telegram solicita reducir la velocidad, o si se produce un fallo en la red, el mensaje se vuelve a intentar tras una breve espera.
- Si falta el permiso WebRequest, el panel y el registro de Experts indican la dirección que hay que añadir; los mensajes esperan en la cola y se envían una vez que se permite la dirección.
- Si Telegram rechaza el token del bot, el envío se detiene y el panel lo indica; corrige el token en los campos de entrada.
- Los eventos que se producen mientras la terminal está cerrada no se envían posteriormente. Tras un reinicio, el EA no reenvía los eventos antiguos.
- En el Strategy Tester no se envía nada, ya que WebRequest no funciona allí; el registro de Experts lo indica una vez.
