MT5 to Telegram Professional Library - librería para MetaTrader 5

Características principales

• 📨 Notificaciones de negociación en tiempo real - Alertas instantáneas de apertura/cierre/modificación de posiciones.
• 📸 Capturas de pantalla de gráficos - Capturas automáticas de gráficos con anotaciones
• 📊 Informes de cuenta - Informes de rendimiento diarios, semanales y mensuales
• ⚠️ Alertas de gestión de riesgos - Avisos de reducción, nivel de margen y stop-out
• 🔄 S istema de cola de mensajes - Entrega fiable con mecanismo de reintento
• 👥 So porte multicanal - Transmisión a múltiples chats/canales de Telegram
• 📝 S istema de plantillas - Plantillas de mensajes personalizables.
• 🎯 Limitación inteligente de la tasa - Evita el estrangulamiento de la API

Requisitos

• MetaTrader 5 build 2375 o superior
• Telegram Bot Token (obtener de @BotFather)
• ID de chat o ID de canal
• Conexión a Internet

Instalación

Paso 1: Crear el Bot de Telegram

1. Abre Telegram y busca a @BotFather
2. Envía el comando /newbot
3. Elige un nombre para tu bot
4. Elige un nombre de usuario (debe terminar con 'bot')
5. Guarda el token proporcionado por BotFather

Paso 2: Obtener ID de Chat

1. Añade tu bot a un grupo/canal o inicia un chat privado
2. Envía cualquier mensaje al bot
3. Visita: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
4. Encuentra el ID del chat en la respuesta

Paso 3: Configurar MT5

1. Abra MT5 → Herramientas → Opciones → Asesores Expertos
2. Marca la opción "Permitir WebRequest para la URL listada"
3. Añadir URL: https://api.telegram.org
4. Haga click en OK

Paso 4: Instalar archivos

1. Copiar TelegramBot.mqh en MQL5/Include/
2. Copia TelegramBot_Example.mq5 en MQL5/Experts/
3. Compila ambos archivos

Inicio Rápido

#include <TelegramBot.mqh>

CTelegramBot bot;

int OnInit()
{
    // Inicializar bot
    if(!bot.Initialize("YOUR_TOKEN", "YOUR_CHAT_ID"))
    {
        Print("Failed to initialize bot");
        return INIT_FAILED;
    }
    
    // Enviar mensaje de prueba
    bot.SendMessage("Bot connected successfully!");
    
    // Enviar captura de pantalla del gráfico
    bot.SendChartScreenshot("Current market situation");
    
    return INIT_SUCCEEDED;
}

Referencia API

Mensajería Básica

bool SendMessage(string text);
bool SendHTMLMessage(string text);
bool SendMarkdownMessage(string text);
bool SendMessageToAll(string text);

Señales de Trading

bool SendTradeSignal(ENUM_SIGNAL_TYPE type, string symbol, double price);
bool SendPositionOpened(ulong ticket, string symbol, ENUM_POSITION_TYPE type, double volume, double price);
bool SendPositionClosed(ulong ticket, string symbol, double profit, double commission, double swap);

Medios

bool SendPhoto(string file_path, string caption);
bool SendDocument(string file_path, string caption);
bool SendChartScreenshot();
bool SendChartScreenshot(string caption);

Informes

bool SendAccountStatus();
bool SendDailyReport();
bool SendWeeklyReport();
bool SendMonthlyReport();

Gestión de riesgos

bool SendRiskAlert(double drawdown_percent);
bool SendMarginWarning(double margin_level);
bool SendStopOutWarning();

Ejemplo de Asesor Experto

El paquete incluye un EA de ejemplo totalmente funcional que demuestra:

• Monitorización de posiciones con notificaciones
• Capturas de pantalla automáticas de las operaciones
• Actualizaciones periódicas del estado de la cuenta
• Alertas de gestión de riesgos
• Informes diarios
• Señales de operaciones demo

Formato de los mensajes

Formato HTML (recomendado)

string message = "<b> Bold text</b>\n";
message += "<i> Italic text</i>\n";
message += "<code> Fixed-width code</code>\n";
message += "<a href='http://example.com'> Link</a>";
bot.SendHTMLMessage(message);

Formato Markdown

string message = "*Bold text*\n";
message += "_Italic text_\n";
message += "`Fixed-width code`\n";
message += "[Link](http://example.com)";
bot.SendMarkdownMessage(message);

Rendimiento

• Ritmo de mensajes: Hasta 30 mensajes por minuto
• Límite de tamaño de archivo: 50 MB por archivo
• Longitud del mensaje: 4096 caracteres
• Longitud del pie de foto: 1024 caracteres
• Tamaño de la cola: 100 mensajes
• Tiempo medio de respuesta: 50-200 ms

Gestión de errores

La biblioteca incluye un completo tratamiento de errores:

• Validación de la conexión
• Protección de limitación de velocidad
• Reintentos automáticos en caso de fallo
• Sistema de colas para mensajes fallidos
• Registro detallado de errores

Soporte

• Documentación: Documentación completa de la API incluida en el código fuente
• Ejemplo EA: Ejemplo funcional con todas las características
• Modo de depuración: Depuración integrada para la resolución de problemas

Historial de versiones

Versión 1.0.0 (2024)

• Versión inicial
• Integración completa con Telegram Bot API
• Soporte multicanal
• Sistema de colas
• Motor de plantillas
• Alertas de gestión de riesgos

Licencia

Esta biblioteca se proporciona tal cual para su uso en MetaTrader 5. Gratis para uso personal y comercial.

Autor

Financial Blueprint
Soluciones profesionales de trading

Descargo de responsabilidad

Este software se proporciona "tal cual" sin garantía de ningún tipo. El trading implica un riesgo sustancial de pérdida y no es adecuado para todos los inversores. El rendimiento pasado no es indicativo de resultados futuros.

---

¡Si encuentra útil esta librería, por favor valórela en MQL5 CodeBase!

Instrucciones detalladas de configuración

Crear un Bot de Telegram

1. Encontrar BotFather

   • Abre Telegram
   • Busca @BotFather
   • Pulsa START

2. Crear Nuevo Bot

   • Envía el comando /newbot
   • Introduce el nombre del bot (por ejemplo, "My Trading Bot")
   • Introduzca el nombre de usuario del bot (por ejemplo, my_trading_bot)
   • Guarde el token como 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

3. Configurar Bot

   • Envía /setprivacy y selecciona DISABLE (para la funcionalidad de grupos)
   • Envía /setjoingroups y selecciona ENABLE (para añadir a grupos)

Obtener Chat ID

Para Mensajes Privados:

1. Iniciar conversación con tu bot
2. Envía cualquier mensaje
3. Abrir en el navegador: https://api.telegram.org/bot<TOKEN>/getUpdates
4. Encuentra "chat":{"id":123456789} - este es tu ID de Chat

Para grupos:

1. Añadir bot al grupo
2. Enviar mensaje en grupo
3. Abrir en el navegador: https://api.telegram.org/bot<TOKEN>/getUpdates
4. Buscar "chat":{"id":-123456789} - número negativo para grupos

Para canales:

1. Añadir bot como administrador del canal
2. Enviar mensaje al canal
3. O utilice @nombredelcanal como ID de chat

Solución de problemas comunes

Error WebRequest:

Solución: 1. Herramientas → Opciones → Asesores Expertos 2. ✓ Permitir WebRequest para URL de la lista 3. Añadir: https://api.telegram.org 4. Reiniciar MT5

Bot no responde:

Compruebe: 1. Token correcto 2. Chat ID correctness 3. Conexión a Internet 4. Configuración de WebRequest

Mensajes no entregados:

Posibles causas: 1. 1. Límite de la API superado (30 mensajes/minuto) 2. Formato HTML no válido en el mensaje 3. Mensaje demasiado largo (>4096 caracteres) Mensaje demasiado largo (>4096 caracteres)

Ejemplos de uso

Enviar señal de compra

bot.SendTradeSignal(SIGNAL_BUY, "EURUSD", 1.1850, 1.1800, 1.1900);

Enviar captura de pantalla con anotación

string caption = "<b> Entry Point</b>\n";
caption += "Pair: EURUSD\n";
caption += "Type: BUY\n";
caption += "Price: 1.1850";
bot.SendChartScreenshot(caption);

Enviar estado de cuenta

bot.SendAccountStatus();
// Envía automáticamente saldo, capital, margen, etc.

Configurar informes diarios

// En OnTimer() de EA
if(TimeHour(TimeCurrent()) == 23 && TimeMinute(TimeCurrent()) == 0)
{
    bot.SendDailyReport();
}

Alerta de Reducción

double drawdown = CalculateDrawdown(); // Su función de cálculo
if(drawdown > 20.0) // Reducción superior al 20%
{
    bot.SendRiskAlert(drawdown);
}

Estructura del mensaje

[POSITION OPENED] ↑
================
Ticket: #12345678
Symbol: EURUSD
Type: BUY
Volume: 0.10
Price: 1.18500
Time: 2024.01.15 10:30

[POSITION CLOSED]
================
Ticket: #12345678
Symbol: EURUSD
Profit: +125.50 USD
Commission: -2.00
Swap: -0.50
Total: +123.00 USD
Time: 2024.01.15 14:45
================

[DAILY REPORT]
================
Date: 2024.01.15

ACCOUNT SUMMARY
----------------
Balance: 10,125.50 USD
Equity: 10,250.00 USD
Floating P/L: +124.50 USD

TRADING ACTIVITY
----------------
Trades Today: 5
Today's Result: +250.00 USD
Open Positions: 2

BOT STATISTICS
----------------
Messages Sent: 45
Signals Sent: 8
Success Rate: 98.5%
================