Telegram Portfolio and Connection Monitor

⭐ Telegram Portfolio and Connection Monitor
Tu servidor está en buenas manos: supervisa tus cuentas MT5 en cualquier momento y desde cualquier lugar.

🎯 Por qué hemos creado esto:

Como operadores reales y usuarios de VPS, entendemos que la mayor preocupación no son solo las estrategias de trading, sino el «riesgo técnico», como la desconexión de Internet, las caídas de conexión con el bróker, los tiempos de inactividad inesperados del VPS o dejar las cuentas de trading sin supervisión mientras no estás delante de la pantalla.

El Monitor de Cartera y Conexión de Telegram se ha desarrollado específicamente para resolver estos problemas. Convierte tu teléfono móvil en un centro de supervisión y control en tiempo real, eliminando la necesidad de utilizar constantemente el escritorio remoto (RDP) para comprobar tu ordenador las 24 horas del día, los 7 días de la semana. Combina el seguimiento instantáneo de la cartera con un sistema de diagnóstico automatizado en segundo plano para garantizar un control absoluto sobre tu entorno de trading.

💡 Ventajas principales:

• Tranquilidad (informes de estado automatizados): Los informes de estado automatizados, basados en horarios o intervalos de tiempo preestablecidos, te dan la tranquilidad de saber que tu servidor y tu cartera están seguros.
• Comprobación bajo demanda: ¿Quieres saber cuál es el estado de tu cartera ahora mismo? Solo tienes que escribir el comando /check en el chat de Telegram y el bot obtendrá datos en tiempo real y te los enviará al instante, en cuestión de segundos.
• Resumen integral de la cartera: Obtén un resumen completo del saldo, el capital y las pérdidas y ganancias totales de todas las órdenes, con un desglose claro de las posiciones abiertas individuales.
• Aviso proactivo de alta latencia: detecta ralentizaciones del servidor o retrasos en la red antes de que afecten a la ejecución, notificándote cuando la latencia supere el umbral que hayas predefinido.
• Protección ante fallos críticos de conexión: te avisa al instante cuando MetaTrader 5 pierde la conexión con el servidor del bróker, fallan las credenciales de la cuenta o se producen caídas de la red o del VPS, con recuperación automática y seguimiento del tiempo de inactividad.
• Ligero y de gran estabilidad: Diseñado específicamente como una utilidad en segundo plano, consume un mínimo de recursos del sistema, no ralentiza tu ordenador y no requiere una configuración compleja.

Esta guía explica todos los parámetros de entrada configurables disponibles en el panel de ajustes de Telegram Portfolio y Connection Monitor, ordenados según su orden de aparición.

1. ⚙️ Ajustes de Telegram

• Token del bot de Telegram: El token de la API de tu bot de Telegram obtenido de @BotFather. Es necesario para autenticar el envío de mensajes y recibir comandos.

• ID del chat de Telegram: el ID del chat de destino o el ID de usuario al que se enviarán los informes de supervisión. También actúa como filtro de seguridad para los comandos entrantes.

2. 📝 Configuración general

• Nota o comentario personalizado: Un identificador o nota personalizada que se añade al final de cada informe para ayudar a distinguir entre varias cuentas o terminales MT5.

3. ⚡ Ajustes en segundo plano de Telegram (hora del servidor)

• Habilitar monitorización en segundo plano (ping/desconexión): Opción desplegable para habilitar o deshabilitar el sistema automatizado de monitorización de la conexión y del ping en segundo plano. (Nota: Este servicio en segundo plano funciona estrictamente según la hora del servidor del bróker / UTC 0).

• Ping máximo aceptable (ms): el umbral máximo aceptable de latencia del bróker en milisegundos. Si el ping supera este valor (y es mayor que 0), el indicador de estado cambia a un icono de advertencia ⚠️.

• Tiempo de espera entre advertencias (minutos): controla el intervalo de tiempo (en minutos) entre mensajes de advertencia consecutivos si persiste un estado anómalo.

4. 📊 Ajustes de supervisión

• Mostrar posiciones en Telegram: activa o desactiva la lista detallada de las posiciones de trading actualmente abiertas dentro del informe de estado.

• Habilitar el comando /check desde Telegram: permite que el EA detecte y responda al comando /check enviado desde tu sala de chat autorizada de Telegram cuando lo solicites.

5. 📅 Filtro global de días de negociación

• De lunes a domingo: activa o desactiva días concretos de la semana (true / false). Nota: Estos filtros globales de días controlan tanto los envíos programados de informes como los días laborables activos para el monitor en segundo plano.

6. ⏱️ Modo de funcionamiento

• Seleccionar modo de funcionamiento: Elige cómo se activan los informes automatizados:

  • Modo de intervalo: envía informes periódicamente según un intervalo de horas establecido.

  • Modo de horario fijo: envía informes a horas específicas cada día.

7. ⏳ Ajustes del modo de intervalo

• Enviar informe cada X horas: el intervalo, expresado en horas, para el envío de informes automáticos (por ejemplo, cada 1 hora).

8. 📅 Ajustes del modo de horario fijo (hora local)

• Tu desfase local respectoal UTC (zona horaria): tu desfase horario local respecto al UTC (por ejemplo, ajústalo a 7 para Tailandia/ICT). Este desfase se aplica específicamente a las horas de los informes programados que se indican a continuación.
• Activar programación 1 / Hora local 1 (HH:MM): Activa y configura las horas de los informes diarios según tu zona horaria local.
• Activar programación 2 / Hora local 2 (HH:MM): activa y configura la segunda hora de informe diaria.
• Activar programación 3 / Hora local 3 (HH:MM): activa y configura la tercera hora de informe diario.

📖Guía de instalación y configuración del bot de Telegram
Esta guía describe paso a paso el proceso para crear un bot de Telegram, obtener tu ID de chat y configurar los ajustes de privacidad del bot a través de @BotFather para que funcione a la perfección con Telegram Portfolio y Connection Monitor.

Paso 1: Crear un bot de Telegram y obtener el token del bot

1. Abre la aplicación de Telegram y busca @BotFather (fíjate en la marca de verificación oficial).
2. Pulsa «Iniciar» para comenzar el chat.
3. Envía el comando /newbot a BotFather.
4. Introduce un nombre de usuario para tu bot (por ejemplo, Ratchata Portfolio Monitor).
5. Elige un nombre de usuario para tu bot, que debe terminar con la palabra «bot» (por ejemplo, ratchata _monitor_bot).
6. Si el nombre de usuario ya está en uso, BotFather te pedirá que elijas otro. Una vez completado con éxito, BotFather te responderá con un mensaje de bienvenida que contendrá tu API HTTP (token del bot) (formato: una combinación de números y letras, p. ej., 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).
7. Copia este token y pégalo en el campo «Token del bot de Telegram» en la configuración de tu EA.

Paso 2: Cómo encontrar tu ID de chat

1. Busca un bot de ayuda en Telegram para obtener tu ID, como @userinfobot o @getmyid_bot.
2. Pulsa «Iniciar» y el bot mostrará al instante la información de tu cuenta.
3. Busca la línea «Id» (solo números, p. ej., 987654321), que representa tu ID de chat personal.
4. Copia este ID de chat y pégalo en el campo «ID de chat de Telegram» en la configuración de tu EA. (Nota: si quieres que los informes se envíen a un grupo de Telegram, añade el bot a tu grupo y utiliza un bot de ayuda para el ID de grupo para obtener el ID de chat del grupo).

Paso 3: Configuración del modo de privacidad del bot a través de BotFather
Por defecto, los bots de Telegram tienen activado elmodo deprivacidad. Cuando se añade un bot a un chat de grupo, este ignorará los mensajes normales o los comandos como /check, a menos que menciones explícitamente el nombre de usuario del bot (por ejemplo, /check@tu_nombre_de_bot). En los chats directos privados, esta configuración no tiene ningún efecto.

Si quieres que tu bot lea los comandos libremente sin restricciones, sigue estos pasos:

1. Vuelve a la ventana de chat de @BotFather.
2. Envía el comando /setprivacy.
3. BotFather mostrará una lista de los bots que has creado; selecciona el nombre de usuario de tu bot.
4. Elige el estado deseado:
• Habilitar (predeterminado): mantiene activado el modo de privacidad. El bot solo lee los mensajes del grupo si se le menciona explícitamente o se le envía un comando con la barra.
• Desactivar: desactiva el modo de privacidad. El bot puede leer todos los mensajes de los chats de grupo de los que sea miembro (recomendado si deseas una ejecución fluida y directa del comando /check).
5. Selecciona «Desactivar» y BotFather responderá con «¡Éxito!». El nuevo estado es: DESACTIVADO.

El sistema automatizado de supervisión en segundo plano está diseñado para vigilar el estado de la red y la estabilidad del servidor del bróker las 24 horas del día, los 7 días de la semana. Las notificaciones de advertencia se clasifican en 4 casos principales:

• Caso 1: Aviso de alta latencia

  • Condición de activación: se produce cuando la conexión al servidor sigue activa, pero la latencia del ping se dispara y supera el umbral definido por el usuario (InpMaxPingMs).

  • Mensaje de notificación: envía una advertencia ⚠️ en la que se muestra el ping elevado actual y se sugiere que el servidor podría ser inestable o estar experimentando retrasos.

• Caso 2: Recuperación del sistema (latencia normal)

  • Condición de activación: Se produce después de que el sistema haya enviado previamente una advertencia de ping elevado (Caso 1) y, posteriormente, el ping vuelva a descender hasta los límites normales.

  • Mensaje de notificación: Envía un mensaje de éxito ✅ que confirma que el ping y la latencia han vuelto a los límites normales, junto con el último valor de ping.

• Caso 3: Advertencia crítica (pérdida de conexión)

• Condición de activación: Se produce de forma inmediata (en tiempo real) cuando MetaTrader 5 pierde por completo la conexión con el servidor del bróker.
• Posibles escenarios:

• Problemas relacionados con la cuenta, como credenciales de inicio de sesión incorrectas o una contraseña no válida, en los que el servidor rechaza la conexión (el sistema activa esta alerta de inmediato).
• Problemas relacionados con la red, como una desconexión de Internet o la pérdida de conexión del VPS (el sistema enviará esta notificación junto con un aviso de recuperación una vez que la conexión se haya restablecido correctamente).

• Caso 4: Recuperación del sistema (conexión restablecida)

• Condición de activación: Se produce específicamente cuando se ha resuelto un estado de desconexión crítico (como la pérdida de conexión a Internet o de red) y «la señal de conexión ha vuelto a la normalidad con éxito».
• Mensaje de notificación: Envía un mensaje de éxito ✅ que confirma que la conexión con el bróker se ha restablecido con éxito, acompañado de un informe resumido preciso del tiempo de inactividad (que registra desde el momento en que se perdió la conexión hasta que se restableció con éxito), para que los usuarios puedan consultar la duración exacta del periodo sin conexión. (El sistema enviará esta notificación una vez que la conexión se haya restablecido con éxito).

Si tiene alguna pregunta o necesita ayuda, no dude en ponerse en contacto con nosotros a través de un mensaje de MQL5 o por correo electrónico: ratchata.sys@gmail.com