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
- Vai su Meta for Developers
- Clicca su "My Apps" → "Create App"
- Seleziona "Business" come tipo di app
- Compila i dettagli dell'app e crea l'app
Passo 2: Aggiungere il Prodotto WhatsApp
- Nella dashboard dell'app, clicca su "Add Product"
- Trova "WhatsApp" e clicca su "Set Up"
- Seleziona o crea un Portfolio Business
Passo 3: Ottenere le Credenziali
- Naviga su WhatsApp → Configurazione API
- 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
- Nella pagina di configurazione dell'API WhatsApp, aggiungi il tuo numero WhatsApp personale come destinatario
- 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
- Apri Discord e vai sul tuo server
- Fai clic destro sul canale dove vuoi le notifiche
- Seleziona "Modifica Canale"
Passo 2: Creare un Webhook
- Naviga nella scheda "Integrazioni"
- Clicca su "Webhook" → "Crea Webhook"
- Dai un nome al webhook (es. "MagicTradeBot Signals")
- (Opzionale) Carica un avatar personalizzato
Passo 3: Copiare l'URL del Webhook
- Clicca su "Copia URL Webhook"
- 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
- Nell'app Instagram: Impostazioni → Account
- Seleziona "Passa a Account Professionale"
- Scegli "Business" o "Creator"
Passo 2: Collegare a una Pagina Facebook
- Vai su Impostazioni → Account → Account Collegati
- Collega il tuo Instagram a una Pagina Facebook
Passo 3: Creare un'App Meta
- Vai su Meta for Developers
- Crea una nuova app (se non l'hai già fatto)
- Aggiungi il prodotto "Instagram"
Passo 4: Generare il Token di Accesso
- Vai su Instagram → Basic Display o Instagram Graph API
- 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
- Apri Telegram e cerca @BotFather
- Avvia una chat e invia /newbot
- 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
- BotFather ti fornirà il token del bot
- Formato:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz - Salva questo token in modo sicuro
Passo 3: Ottenere il Tuo ID Chat
Metodo 1: Usando IDBot
- Cerca @myidbot o @userinfobot su Telegram
- Avvia una chat e invia /start
- Il bot risponderà con il tuo ID chat
Metodo 2: Metodo Manuale
- Invia un messaggio al tuo bot (quello che hai creato)
- Visita:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - Cerca "chat":{"id":123456789}
- Quel numero è il tuo chat_id
Metodo 3: Per Chat di Gruppo
- Aggiungi il tuo bot al gruppo
- Invia un messaggio nel gruppo
- Visita:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - Cerca l'ID chat (sarà negativo per i gruppi: -123456789)
Passo 4: Avviare il Bot
- Cerca il tuo bot su Telegram
- 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 |
| ⭐⭐⭐ Complessa | Piano gratuito limitato | Buona | Comunicazioni aziendali | |
| ⭐⭐⭐⭐ 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
- Mai includere i token nel controllo di versione
- Usa variabili d'ambiente
- Aggiungi i file di configurazione a .gitignore
- Ruota regolarmente i token
- Soprattutto per WhatsApp e Instagram
- I token Telegram non scadono ma possono essere rigenerati
- Usa configurazioni specifiche per ambiente
- Token diversi per test e produzione
- Restringi l'accesso ai webhook
- Discord: Usa canali dedicati con accesso limitato
- WhatsApp: Verifica i numeri dei destinatari
- 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à