Resumen
La función Broadcast de MagicTradeBot te permite recibir señales de trading en varias plataformas de mensajería. Puedes configurar una o todas las plataformas según tus preferencias.
Estructura de Configuración
BroadCast:
# Notificaciones WhatsApp
whatsapp_token: null
whatsapp_phone_id: null
# Notificaciones Discord
discord_webhook_url: null
# Notificaciones Instagram
instagram_token: null
# Notificaciones Telegram
telegram_bot_token: null
telegram_chat_id: null
1. Configuración de WhatsApp
Las notificaciones de WhatsApp utilizan la API WhatsApp Business de Meta.
Requisitos previos
- Una cuenta de negocio Meta (Facebook)
- Un número de teléfono comercial verificado
- Acceso a la plataforma Meta Developer
Configuración paso a paso
Paso 1: Crear una app Meta
- Accede a Meta for Developers
- Haz clic en "My Apps" → "Create App"
- Selecciona "Business" como tipo de app
- Rellena los detalles de la app y créala
Paso 2: Añadir el producto WhatsApp
- En el panel de la app, haz clic en "Add Product"
- Busca "WhatsApp" y haz clic en "Set Up"
- Selecciona o crea un Portfolio Business
Paso 3: Obtener tus credenciales
- Navega a WhatsApp → Configuración de API
- Verás dos valores importantes:
Token de acceso temporal (whatsapp_token):
- Copia el token de acceso temporal mostrado
- Nota: Para producción, genera un token permanente:
- Ve a Usuarios del sistema en Configuraciones de negocio
- Crea un usuario del sistema
- Genera un token con el permiso whatsapp_business_messaging
ID del número de teléfono (whatsapp_phone_id):
- Listado bajo "Phone Number ID"
- Este NO es tu número de teléfono, es un identificador único
Paso 4: Configurar en MagicTradeBot
BroadCast:
whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
whatsapp_phone_id: "123456789012345"
Paso 5: Verificar el número del destinatario
- En la página de configuración de la API de WhatsApp, añade tu número personal de WhatsApp como destinatario
- Verifica el número mediante el OTP enviado a tu WhatsApp
Notas importantes
- El plan gratuito permite 1.000 conversaciones al mes
- Los números de destinatarios deben verificarse en modo prueba
- Para producción, es necesario completar la Verificación de Negocio
2. Configuración de Discord
Discord usa webhooks para notificaciones — el método más simple.
Configuración paso a paso
Paso 1: Acceder a la configuración del servidor
- Abre Discord y ve a tu servidor
- Haz clic derecho en el canal donde deseas las notificaciones
- Selecciona "Editar canal"
Paso 2: Crear un webhook
- Navega a la pestaña "Integraciones"
- Haz clic en "Webhooks" → "Crear Webhook"
- Asigna un nombre al webhook (ej.: "MagicTradeBot Signals")
- (Opcional) Sube un avatar personalizado
Paso 3: Copiar la URL del webhook
- Haz clic en "Copiar URL del Webhook"
- Formato de URL:
https://discord.com/api/webhooks/XXXXX/YYYYY
Paso 4: Configurar en MagicTradeBot
BroadCast:
discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOpQrStUvWxYz"
Notas importantes
- Cualquier persona con la URL del webhook puede publicar en tu canal
- Mantén la URL segura
- Puedes crear múltiples webhooks para diferentes bots
- No se necesita cuenta de desarrollador de Discord
3. Configuración de Instagram
Las notificaciones de Instagram utilizan la API Instagram Graph (Meta).
Requisitos previos
- Cuenta Instagram Business o Creator
- Página de Facebook conectada a tu cuenta de Instagram
- Cuenta de desarrollador Meta
Configuración paso a paso
Paso 1: Convertir a cuenta Business
- En la app de Instagram: Configuración → Cuenta
- Selecciona "Cambiar a cuenta profesional"
- Elige "Business" o "Creator"
Paso 2: Conectar a una página de Facebook
- Ve a Configuración → Cuenta → Cuentas vinculadas
- Vincula tu Instagram a una página de Facebook
Paso 3: Crear una app Meta
- Accede a Meta for Developers
- Crea una nueva app (si no la tienes)
- Añade el producto "Instagram"
Paso 4: Generar token de acceso
- Ve a Instagram → Basic Display o Instagram Graph API
- Para Instagram Graph API:
- Ve a Herramientas → Graph API Explorer
- Selecciona tu app
- Selecciona tu cuenta de Instagram
- Añade permisos: instagram_basic, instagram_manage_messages
- Haz clic en "Generar token de acceso"
Paso 5: Obtener token de larga duración
Los tokens de corta duración expiran en 1 hora. Conviértelo en uno de larga duración (60 días):
curl -i -X GET "https://graph.facebook.com/v18.0/oauth/access_token?grant_type=fb_exchange_token&client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&fb_exchange_token=SHORT_LIVED_TOKEN"
Paso 6: Configurar en MagicTradeBot
BroadCast:
instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"
Notas importantes
- La API de Instagram está orientada principalmente a funcionalidades de negocio
- Los mensajes directos vía API tienen limitaciones
- Considera usar Instagram Basic Display para casos más simples
- Los tokens necesitan renovación periódica
4. Configuración de Telegram
Telegram ofrece la configuración de bot más fácil entre todas las plataformas.
Configuración paso a paso
Paso 1: Crear un bot
- Abre Telegram y busca @BotFather
- Inicia una conversación y envía /newbot
- Sigue las instrucciones:
- Elige un nombre para tu bot (ej.: "My Trading Signals")
- Elige un nombre de usuario que termine en "bot" (ej.: "mytrading_signals_bot")
Paso 2: Obtener el token del bot
- BotFather te proporcionará el token del bot
- Formato:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz - Guarda este token de forma segura
Paso 3: Obtener tu ID de chat
Método 1: Usando IDBot
- Busca @myidbot o @userinfobot en Telegram
- Inicia una conversación y envía /start
- El bot responderá con tu ID de chat
Método 2: Método manual
- Envía un mensaje a tu bot (el que creaste)
- Accede a:
https://api.telegram.org/bot<TU_TOKEN_DE_BOT>/getUpdates - Busca "chat":{"id":123456789}
- Ese número es tu chat_id
Método 3: Para grupos
- Añade tu bot al grupo
- Envía un mensaje en el grupo
- Accede a:
https://api.telegram.org/bot<TU_TOKEN_DE_BOT>/getUpdates - Busca el ID del chat (será negativo para grupos: -123456789)
Paso 4: Iniciar el bot
- Busca tu bot en Telegram
- Haz clic en "Start" o envía /start
Paso 5: Configurar en MagicTradeBot
BroadCast:
telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
telegram_chat_id: "987654321"
Notas importantes
- Los bots no pueden iniciar conversaciones; debes iniciarlo tú primero
- Para grupos, el bot debe añadirse y el chat_id será negativo
- No requiere verificación ni aprobación
- Completamente gratuito y sin límite de mensajes
- La opción más confiable para uso personal
Ejemplo de configuración multiplataforma
Puedes habilitar varias plataformas simultáneamente:
BroadCast:
# WhatsApp
whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
whatsapp_phone_id: "123456789012345"
# Discord
discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOp"
# Instagram
instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Telegram
telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
telegram_chat_id: "987654321"
O habilita solo lo que necesites:
BroadCast:
# Solo Telegram habilitado
whatsapp_token: null
whatsapp_phone_id: null
discord_webhook_url: null
instagram_token: null
telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
telegram_chat_id: "987654321"
Comparación de plataformas
| Plataforma | Dificultad de configuración | Costo | Confiabilidad | Ideal para |
|---|---|---|---|---|
| Telegram | ⭐ Fácil | Gratuito | Excelente | Uso personal, grupos |
| Discord | ⭐ Fácil | Gratuito | Excelente | Comunidades, equipos |
| ⭐⭐⭐ Compleja | Plan gratuito limitado | Buena | Comunicación empresarial | |
| ⭐⭐⭐⭐ Muy compleja | Gratuito | Razonable | Integración social |
Solución de problemas
Problemas con WhatsApp
- "Token inválido": Token expirado; genera un token permanente
- "Número de teléfono no verificado": Añade y verifica al destinatario en el panel de Meta
- Mensajes no enviados: Verifica los límites de tasa de la API y facturación
Problemas con Discord
- "Webhook inválido": La URL pudo haber sido regenerada; obtén una nueva
- 403 Forbidden: Webhook eliminado; crea uno nuevo
- Canal no encontrado: El canal del webhook pudo haber sido eliminado
Problemas con Instagram
- Token expirado: Los tokens de Instagram expiran; genera un nuevo token de larga duración
- Permiso denegado: Asegúrate de que todos los permisos necesarios estén concedidos
- Cuenta no elegible: Debe ser una cuenta Business o Creator
Problemas con Telegram
- "Chat no encontrado": No has iniciado el bot; envía /start primero
- "No autorizado": Verifica que el token del bot sea correcto
- No recibe mensajes: Asegúrate de que el bot no esté bloqueado
Mejores prácticas de seguridad
- Nunca hagas commit de tokens en control de versiones
- Usa variables de entorno
- Añade archivos de configuración a .gitignore
- Rota los tokens regularmente
- Especialmente para WhatsApp e Instagram
- Los tokens de Telegram no expiran, pero pueden regenerarse
- Usa configuraciones específicas por entorno
- Tokens diferentes para prueba y producción
- Restringe el acceso a los webhooks
- Discord: Usa canales dedicados con acceso limitado
- WhatsApp: Verifica los números de los destinatarios
- Monitorea el uso
- Verifica regularmente las cuotas de API
- Configura alertas para entregas fallidas
Recomendación de inicio rápido
Para principiantes: Comienza con Telegram
- Configuración más fácil (5 minutos)
- Sin verificación necesaria
- Completamente gratuito
- Más confiable
Para equipos: Usa Discord
- Configuración simple de webhook
- Óptimo para notificaciones en grupo
- Gratuito y confiable
Para empresas: Considera WhatsApp
- Apariencia profesional
- Entrega directa en el móvil
- Requiere más esfuerzo de configuración
Soporte y recursos
Notas finales
- Prueba tu configuración con un mensaje simple antes de pasar a producción
- Mantén copias de seguridad de todos los tokens en un gestor de contraseñas seguro
- Considera usar múltiples plataformas para redundancia
- Revisa los límites de tasa para el volumen de mensajes esperado
- Comienza con una plataforma y expande según sea necesario