Guía de configuración de transmisión de MagicTradeBot

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

  1. Accede a Meta for Developers
  2. Haz clic en "My Apps" → "Create App"
  3. Selecciona "Business" como tipo de app
  4. Rellena los detalles de la app y créala

Paso 2: Añadir el producto WhatsApp

  1. En el panel de la app, haz clic en "Add Product"
  2. Busca "WhatsApp" y haz clic en "Set Up"
  3. Selecciona o crea un Portfolio Business

Paso 3: Obtener tus credenciales

  1. Navega a WhatsApp → Configuración de API
  2. 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

  1. En la página de configuración de la API de WhatsApp, añade tu número personal de WhatsApp como destinatario
  2. 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

  1. Abre Discord y ve a tu servidor
  2. Haz clic derecho en el canal donde deseas las notificaciones
  3. Selecciona "Editar canal"

Paso 2: Crear un webhook

  1. Navega a la pestaña "Integraciones"
  2. Haz clic en "Webhooks" → "Crear Webhook"
  3. Asigna un nombre al webhook (ej.: "MagicTradeBot Signals")
  4. (Opcional) Sube un avatar personalizado

Paso 3: Copiar la URL del webhook

  1. Haz clic en "Copiar URL del Webhook"
  2. 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

  1. En la app de Instagram: Configuración → Cuenta
  2. Selecciona "Cambiar a cuenta profesional"
  3. Elige "Business" o "Creator"

Paso 2: Conectar a una página de Facebook

  1. Ve a Configuración → Cuenta → Cuentas vinculadas
  2. Vincula tu Instagram a una página de Facebook

Paso 3: Crear una app Meta

  1. Accede a Meta for Developers
  2. Crea una nueva app (si no la tienes)
  3. Añade el producto "Instagram"

Paso 4: Generar token de acceso

  1. Ve a Instagram → Basic Display o Instagram Graph API
  2. 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

  1. Abre Telegram y busca @BotFather
  2. Inicia una conversación y envía /newbot
  3. 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

  1. BotFather te proporcionará el token del bot
  2. Formato: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  3. Guarda este token de forma segura

Paso 3: Obtener tu ID de chat

Método 1: Usando IDBot

  1. Busca @myidbot o @userinfobot en Telegram
  2. Inicia una conversación y envía /start
  3. El bot responderá con tu ID de chat

Método 2: Método manual

  1. Envía un mensaje a tu bot (el que creaste)
  2. Accede a: https://api.telegram.org/bot<TU_TOKEN_DE_BOT>/getUpdates
  3. Busca "chat":{"id":123456789}
  4. Ese número es tu chat_id

Método 3: Para grupos

  1. Añade tu bot al grupo
  2. Envía un mensaje en el grupo
  3. Accede a: https://api.telegram.org/bot<TU_TOKEN_DE_BOT>/getUpdates
  4. Busca el ID del chat (será negativo para grupos: -123456789)

Paso 4: Iniciar el bot

  1. Busca tu bot en Telegram
  2. 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
WhatsApp ⭐⭐⭐ Compleja Plan gratuito limitado Buena Comunicación empresarial
Instagram ⭐⭐⭐⭐ 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

  1. Nunca hagas commit de tokens en control de versiones
    • Usa variables de entorno
    • Añade archivos de configuración a .gitignore
  2. Rota los tokens regularmente
    • Especialmente para WhatsApp e Instagram
    • Los tokens de Telegram no expiran, pero pueden regenerarse
  3. Usa configuraciones específicas por entorno
    • Tokens diferentes para prueba y producción
  4. Restringe el acceso a los webhooks
    • Discord: Usa canales dedicados con acceso limitado
    • WhatsApp: Verifica los números de los destinatarios
  5. 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

📎 Related Topics