Guida alla configurazione del broadcast di MagicTradeBot

Panoramica

La funzione Broadcast di MagicTradeBot ti permette di ricevere segnali di trading su più piattaforme di messaggistica. Puoi configurare una o tutte le piattaforme in base alle tue preferenze.

Struttura di Configurazione

BroadCast:
  # Notifiche WhatsApp
  whatsapp_token: null
  whatsapp_phone_id: null
 
  # Notifiche Discord
  discord_webhook_url: null
 
  # Notifiche Instagram
  instagram_token: null
 
  # Notifiche Telegram
  telegram_bot_token: null
  telegram_chat_id: null

1. Configurazione WhatsApp

Le notifiche WhatsApp utilizzano l'API WhatsApp Business di Meta.

Prerequisiti

  • Un account Meta (Facebook) Business
  • Un numero di telefono aziendale verificato
  • Accesso alla piattaforma Meta Developer

Configurazione Passo per Passo

Passo 1: Creare un'App Meta

  1. Vai su Meta for Developers
  2. Clicca su "My Apps" → "Create App"
  3. Seleziona "Business" come tipo di app
  4. Compila i dettagli dell'app e crea l'app

Passo 2: Aggiungere il Prodotto WhatsApp

  1. Nella dashboard dell'app, clicca su "Add Product"
  2. Trova "WhatsApp" e clicca su "Set Up"
  3. Seleziona o crea un Portfolio Business

Passo 3: Ottenere le Credenziali

  1. Naviga su WhatsApp → Configurazione API
  2. Vedrai due valori importanti:

Token di Accesso Temporaneo (whatsapp_token):

  • Copia il token di accesso temporaneo visualizzato
  • Nota: Per la produzione, genera un token permanente:
    • Vai su Utenti di Sistema nelle Impostazioni Business
    • Crea un utente di sistema
    • Genera un token con il permesso whatsapp_business_messaging

ID del Numero di Telefono (whatsapp_phone_id):

  • Elencato sotto "Phone Number ID"
  • Questo NON è il tuo numero di telefono, è un identificatore unico

Passo 4: Configurare in MagicTradeBot

BroadCast:
  whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
  whatsapp_phone_id: "123456789012345"

Passo 5: Verificare il Numero del Destinatario

  1. Nella pagina di configurazione dell'API WhatsApp, aggiungi il tuo numero WhatsApp personale come destinatario
  2. Verifica il numero tramite l'OTP inviato su WhatsApp

Note Importanti

  • Piano gratuito permette 1.000 conversazioni al mese
  • I numeri dei destinatari devono essere verificati in modalità test
  • Per la produzione, è necessario completare la Verifica Business

2. Configurazione Discord

Discord utilizza i webhook per le notifiche, il metodo più semplice.

Configurazione Passo per Passo

Passo 1: Accedere alle Impostazioni del Server

  1. Apri Discord e vai sul tuo server
  2. Fai clic destro sul canale dove vuoi le notifiche
  3. Seleziona "Modifica Canale"

Passo 2: Creare un Webhook

  1. Naviga nella scheda "Integrazioni"
  2. Clicca su "Webhook" → "Crea Webhook"
  3. Dai un nome al webhook (es. "MagicTradeBot Signals")
  4. (Opzionale) Carica un avatar personalizzato

Passo 3: Copiare l'URL del Webhook

  1. Clicca su "Copia URL Webhook"
  2. Formato URL: https://discord.com/api/webhooks/XXXXX/YYYYY

Passo 4: Configurare in MagicTradeBot

BroadCast:
  discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOpQrStUvWxYz"

Note Importanti

  • Chiunque abbia l'URL del webhook può pubblicare nel tuo canale
  • Tieni l'URL al sicuro
  • Puoi creare più webhook per diversi bot
  • Non è necessario un account sviluppatore Discord

3. Configurazione Instagram

Le notifiche Instagram utilizzano l'API Instagram Graph (Meta).

Prerequisiti

  • Account Instagram Business o Creator
  • Pagina Facebook collegata al tuo account Instagram
  • Account sviluppatore Meta

Configurazione Passo per Passo

Passo 1: Convertire in Account Business

  1. Nell'app Instagram: Impostazioni → Account
  2. Seleziona "Passa a Account Professionale"
  3. Scegli "Business" o "Creator"

Passo 2: Collegare a una Pagina Facebook

  1. Vai su Impostazioni → Account → Account Collegati
  2. Collega il tuo Instagram a una Pagina Facebook

Passo 3: Creare un'App Meta

  1. Vai su Meta for Developers
  2. Crea una nuova app (se non l'hai già fatto)
  3. Aggiungi il prodotto "Instagram"

Passo 4: Generare il Token di Accesso

  1. Vai su Instagram → Basic Display o Instagram Graph API
  2. Per Instagram Graph API:
    • Vai su Strumenti → Graph API Explorer
    • Seleziona la tua app
    • Seleziona il tuo account Instagram
    • Aggiungi i permessi: instagram_basic, instagram_manage_messages
    • Clicca su "Genera Token di Accesso"

Passo 5: Ottenere un Token a Lunga Durata

I token a breve durata scadono in 1 ora. Converti in token a lunga durata (60 giorni):

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"

Passo 6: Configurare in MagicTradeBot

BroadCast:
  instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"

Note Importanti

  • L'API Instagram è principalmente per funzionalità business
  • La messaggistica diretta tramite API ha limitazioni
  • Considera l'uso di Instagram Basic Display per casi d'uso più semplici
  • I token richiedono un rinnovo periodico

4. Configurazione Telegram

Telegram offre la configurazione del bot più semplice tra tutte le piattaforme.

Configurazione Passo per Passo

Passo 1: Creare un Bot

  1. Apri Telegram e cerca @BotFather
  2. Avvia una chat e invia /newbot
  3. Segui le istruzioni:
    • Scegli un nome per il tuo bot (es. "My Trading Signals")
    • Scegli un nome utente che termina con "bot" (es. "mytrading_signals_bot")

Passo 2: Ottenere il Token del Bot

  1. BotFather ti fornirà il token del bot
  2. Formato: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  3. Salva questo token in modo sicuro

Passo 3: Ottenere il Tuo ID Chat

Metodo 1: Usando IDBot

  1. Cerca @myidbot o @userinfobot su Telegram
  2. Avvia una chat e invia /start
  3. Il bot risponderà con il tuo ID chat

Metodo 2: Metodo Manuale

  1. Invia un messaggio al tuo bot (quello che hai creato)
  2. Visita: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
  3. Cerca "chat":{"id":123456789}
  4. Quel numero è il tuo chat_id

Metodo 3: Per Chat di Gruppo

  1. Aggiungi il tuo bot al gruppo
  2. Invia un messaggio nel gruppo
  3. Visita: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
  4. Cerca l'ID chat (sarà negativo per i gruppi: -123456789)

Passo 4: Avviare il Bot

  1. Cerca il tuo bot su Telegram
  2. Clicca su "Start" o invia /start

Passo 5: Configurare in MagicTradeBot

BroadCast:
  telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
  telegram_chat_id: "987654321"

Note Importanti

  • I bot non possono avviare conversazioni; devi avviarli tu per primo
  • Per i gruppi, il bot deve essere aggiunto e l'ID chat sarà negativo
  • Non è necessaria alcuna verifica o approvazione
  • Completamente gratuito senza limiti di messaggi
  • Opzione più affidabile per uso personale

Esempio di Configurazione Multi-Piattaforma

Puoi abilitare più piattaforme contemporaneamente:

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"

Oppure abilita solo ciò di cui hai bisogno:

BroadCast:
  # Solo Telegram abilitato
  whatsapp_token: null
  whatsapp_phone_id: null
  discord_webhook_url: null
  instagram_token: null
  telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
  telegram_chat_id: "987654321"

Confronto tra Piattaforme

Piattaforma Difficoltà di Configurazione Costo Affidabilità Ideale per
Telegram Facile Gratuito Eccellente Uso personale, gruppi
Discord Facile Gratuito Eccellente Comunità, team
WhatsApp ⭐⭐⭐ Complessa Piano gratuito limitato Buona Comunicazioni aziendali
Instagram ⭐⭐⭐⭐ Molto Complessa Gratuito Discreta Integrazione sociale

Risoluzione dei Problemi

Problemi WhatsApp

  • "Token non valido": Token scaduto; genera un token permanente
  • "Numero di telefono non verificato": Aggiungi e verifica il destinatario nella dashboard Meta
  • Messaggi non inviati: Controlla i limiti di velocità API e la fatturazione

Problemi Discord

  • "Webhook non valido": L'URL potrebbe essere stata rigenerata; ottienine una nuova
  • 403 Forbidden: Il webhook è stato eliminato; creane uno nuovo
  • Canale non trovato: Il canale del webhook potrebbe essere stato eliminato

Problemi Instagram

  • Token scaduto: I token Instagram scadono; genera un nuovo token a lunga durata
  • Permesso negato: Assicurati che tutti i permessi richiesti siano concessi
  • Account non idoneo: Deve essere un account Business o Creator

Problemi Telegram

  • "Chat non trovata": Non hai avviato il bot; invia prima /start al bot
  • "Non autorizzato": Controlla che il token del bot sia corretto
  • Non riceve messaggi: Assicurati che il bot non sia bloccato

Migliori Pratiche di Sicurezza

  1. Mai includere i token nel controllo di versione
    • Usa variabili d'ambiente
    • Aggiungi i file di configurazione a .gitignore
  2. Ruota regolarmente i token
    • Soprattutto per WhatsApp e Instagram
    • I token Telegram non scadono ma possono essere rigenerati
  3. Usa configurazioni specifiche per ambiente
    • Token diversi per test e produzione
  4. Restringi l'accesso ai webhook
    • Discord: Usa canali dedicati con accesso limitato
    • WhatsApp: Verifica i numeri dei destinatari
  5. Monitora l'uso
    • Controlla regolarmente le quote API
    • Imposta avvisi per consegne fallite

Consiglio per un Avvio Rapido

Per i principianti: Inizia con Telegram

  • Configurazione più semplice (5 minuti)
  • Nessuna verifica richiesta
  • Completamente gratuito
  • Il più affidabile

Per i team: Usa Discord

  • Configurazione webhook semplice
  • Ottimo per notifiche di gruppo
  • Gratuito e affidabile

Per le aziende: Considera WhatsApp

  • Aspetto professionale
  • Consegna diretta su mobile
  • Richiede più sforzo di configurazione

Supporto & Risorse

Note Finali

  • Testa la tua configurazione con un messaggio semplice prima di andare in produzione
  • Tieni copie di backup di tutti i token in un gestore di password sicuro
  • Considera l'uso di più piattaforme per ridondanza
  • Controlla i limiti di velocità per il volume di messaggi previsto
  • Inizia con una piattaforma e espandi secondo necessità

📎 Related Topics