Aperçu
La fonctionnalité Broadcast de MagicTradeBot vous permet de recevoir des signaux de trading sur plusieurs plateformes de messagerie. Vous pouvez configurer une ou toutes les plateformes selon vos préférences.
Structure de Configuration
BroadCast:
# Notifications WhatsApp
whatsapp_token: null
whatsapp_phone_id: null
# Notifications Discord
discord_webhook_url: null
# Notifications Instagram
instagram_token: null
# Notifications Telegram
telegram_bot_token: null
telegram_chat_id: null
1. Configuration WhatsApp
Les notifications WhatsApp utilisent l’API WhatsApp Business de Meta.
Prérequis
- Un compte Meta (Facebook) Business
- Un numéro de téléphone professionnel vérifié
- Accès à la plateforme Meta Developer
Configuration Étape par Étape
Étape 1 : Créer une Application Meta
- Aller sur Meta for Developers
- Cliquer sur « My Apps » → « Create App »
- Sélectionner « Business » comme type d’application
- Remplir les détails de l’application et créer l’application
Étape 2 : Ajouter le Produit WhatsApp
- Dans le tableau de bord de l’application, cliquer sur « Add Product »
- Trouver « WhatsApp » et cliquer sur « Set Up »
- Sélectionner ou créer un Portfolio Business
Étape 3 : Obtenir Vos Identifiants
- Naviguer vers WhatsApp → Configuration API
- Vous verrez deux valeurs importantes :
Token d’Accès Temporaire (whatsapp_token) :
- Copier le token d’accès temporaire affiché
- Note : Pour la production, générer un token permanent :
- Aller dans Utilisateurs Système dans les Paramètres Business
- Créer un utilisateur système
- Générer un token avec la permission whatsapp_business_messaging
ID du Numéro de Téléphone (whatsapp_phone_id) :
- Indiqué sous « Phone Number ID »
- Ce n’est PAS votre numéro de téléphone, c’est un identifiant unique
Étape 4 : Configurer dans MagicTradeBot
BroadCast:
whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
whatsapp_phone_id: "123456789012345"
Étape 5 : Vérifier le Numéro du Destinataire
- Sur la page de configuration de l’API WhatsApp, ajouter votre numéro WhatsApp personnel comme destinataire
- Vérifier le numéro via l’OTP envoyé sur votre WhatsApp
Notes Importantes
- Niveau gratuit : 1 000 conversations par mois
- Les numéros destinataires doivent être vérifiés en mode test
- Pour la production, vous devez compléter la Vérification Business
2. Configuration Discord
Discord utilise des webhooks pour les notifications, la méthode la plus simple.
Configuration Étape par Étape
Étape 1 : Accéder aux Paramètres du Serveur
- Ouvrir Discord et aller sur votre serveur
- Cliquer droit sur le canal où vous voulez les notifications
- Sélectionner « Edit Channel »
Étape 2 : Créer un Webhook
- Aller dans l’onglet « Integrations »
- Cliquer sur « Webhooks » → « Create Webhook »
- Donner un nom au webhook (ex. : « MagicTradeBot Signals »)
- (Optionnel) Télécharger un avatar personnalisé
Étape 3 : Copier l’URL du Webhook
- Cliquer sur « Copy Webhook URL »
- Format de l’URL :
https://discord.com/api/webhooks/XXXXX/YYYYY
Étape 4 : Configurer dans MagicTradeBot
BroadCast:
discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOpQrStUvWxYz"
Notes Importantes
- Toute personne disposant de l’URL du webhook peut poster dans votre canal
- Garder l’URL sécurisée
- Vous pouvez créer plusieurs webhooks pour différents bots
- Aucun compte développeur Discord requis
3. Configuration Instagram
Les notifications Instagram utilisent l’API Instagram Graph (Meta).
Prérequis
- Compte Instagram Business ou Creator
- Page Facebook connectée à votre compte Instagram
- Compte développeur Meta
Configuration Étape par Étape
Étape 1 : Convertir en Compte Business
- Dans l’application Instagram : Paramètres → Compte
- Sélectionner « Switch to Professional Account »
- Choisir « Business » ou « Creator »
Étape 2 : Connecter à une Page Facebook
- Aller dans Paramètres → Compte → Comptes Liés
- Lier votre Instagram à une Page Facebook
Étape 3 : Créer une Application Meta
- Aller sur Meta for Developers
- Créer une nouvelle application (si ce n’est pas déjà fait)
- Ajouter le produit « Instagram »
Étape 4 : Générer un Token d’Accès
- Aller dans Instagram → Basic Display ou Instagram Graph API
- Pour Instagram Graph API :
- Aller dans Outils → Graph API Explorer
- Sélectionner votre application
- Sélectionner votre compte Instagram
- Ajouter les permissions : instagram_basic, instagram_manage_messages
- Cliquer sur « Generate Access Token »
Étape 5 : Obtenir un Token Longue Durée
Les tokens courts expirent en 1 heure. Convertir en token longue durée (60 jours) :
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"
Étape 6 : Configurer dans MagicTradeBot
BroadCast:
instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"
Notes Importantes
- L’API Instagram est principalement pour les fonctionnalités business
- La messagerie directe via API a des limitations
- Envisager d’utiliser Instagram Basic Display pour des cas plus simples
- Les tokens nécessitent un renouvellement périodique
4. Configuration Telegram
Telegram offre la configuration de bot la plus simple de toutes les plateformes.
Configuration Étape par Étape
Étape 1 : Créer un Bot
- Ouvrir Telegram et chercher @BotFather
- Démarrer une discussion et envoyer /newbot
- Suivre les instructions :
- Choisir un nom pour votre bot (ex. : « My Trading Signals »)
- Choisir un nom d’utilisateur se terminant par « bot » (ex. : « mytrading_signals_bot »)
Étape 2 : Obtenir le Token du Bot
- BotFather vous fournira le token du bot
- Format :
123456789:ABCdefGHIjklMNOpqrsTUVwxyz - Conserver ce token en sécurité
Étape 3 : Obtenir Votre ID de Chat
Méthode 1 : Utiliser IDBot
- Chercher @myidbot ou @userinfobot sur Telegram
- Démarrer une discussion et envoyer /start
- Le bot répondra avec votre ID de chat
Méthode 2 : Méthode Manuelle
- Envoyer un message à votre bot (celui que vous avez créé)
- Visiter :
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - Chercher "chat":{"id":123456789}
- Ce nombre est votre chat_id
Méthode 3 : Pour les Discussions de Groupe
- Ajouter votre bot au groupe
- Envoyer un message dans le groupe
- Visiter :
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - Chercher l’ID de chat (sera négatif pour les groupes : -123456789)
Étape 4 : Démarrer Votre Bot
- Chercher votre bot dans Telegram
- Cliquer sur « Start » ou envoyer /start
Étape 5 : Configurer dans MagicTradeBot
BroadCast:
telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
telegram_chat_id: "987654321"
Notes Importantes
- Les bots ne peuvent pas initier de conversations ; vous devez les démarrer d’abord
- Pour les groupes, le bot doit être ajouté et le chat_id sera négatif
- Aucune vérification ou approbation requise
- Complètement gratuit sans limite de messages
- Option la plus fiable pour un usage personnel
Exemple de Configuration Multi-Plateformes
Vous pouvez activer plusieurs plateformes simultanément :
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"
Ou activer uniquement ce dont vous avez besoin :
BroadCast:
# Seulement Telegram activé
whatsapp_token: null
whatsapp_phone_id: null
discord_webhook_url: null
instagram_token: null
telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
telegram_chat_id: "987654321"
Comparaison des Plateformes
| Plateforme | Difficulté de Configuration | Coût | Fiabilité | Idéal Pour |
|---|---|---|---|---|
| Telegram | ⭐ Facile | Gratuit | Excellente | Usage personnel, groupes |
| Discord | ⭐ Facile | Gratuit | Excellente | Communautés, équipes |
| ⭐⭐⭐ Complexe | Niveau gratuit limité | Bonne | Communications business | |
| ⭐⭐⭐⭐ Très Complexe | Gratuit | Moyenne | Intégration sociale |
Dépannage
Problèmes WhatsApp
- « Token invalide » : Token expiré ; générer un token permanent
- « Numéro de téléphone non vérifié » : Ajouter et vérifier le destinataire dans le tableau de bord Meta
- Messages non envoyés : Vérifier les limites de taux d’API et la facturation
Problèmes Discord
- « Webhook invalide » : L’URL a peut-être été régénérée ; en obtenir une nouvelle
- 403 Forbidden : Le webhook a été supprimé ; en créer un nouveau
- Canal non trouvé : Le canal du webhook a peut-être été supprimé
Problèmes Instagram
- Token expiré : Les tokens Instagram expirent ; générer un nouveau token longue durée
- Permission refusée : S’assurer que toutes les permissions requises sont accordées
- Compte non éligible : Doit être un compte Business ou Creator
Problèmes Telegram
- « Chat non trouvé » : Vous n’avez pas démarré le bot ; envoyer /start au bot d’abord
- « Non autorisé » : Vérifier que le token du bot est correct
- Ne reçoit pas de messages : S’assurer que le bot n’est pas bloqué
Meilleures Pratiques de Sécurité
- Ne jamais committer les tokens dans le contrôle de version
- Utiliser des variables d’environnement
- Ajouter les fichiers de configuration à .gitignore
- Faire tourner les tokens régulièrement
- Surtout pour WhatsApp et Instagram
- Les tokens Telegram n’expirent pas mais peuvent être régénérés
- Utiliser des configurations spécifiques à l’environnement
- Tokens différents pour les tests et la production
- Restreindre l’accès aux webhooks
- Discord : Utiliser des canaux dédiés avec accès limité
- WhatsApp : Vérifier les numéros destinataires
- Surveiller l’utilisation
- Vérifier régulièrement les quotas d’API
- Mettre en place des alertes pour les livraisons échouées
Recommandation de Démarrage Rapide
Pour les débutants : Commencer avec Telegram
- Le plus facile à configurer (5 minutes)
- Aucune vérification requise
- Complètement gratuit
- Le plus fiable
Pour les équipes : Utiliser Discord
- Configuration webhook simple
- Idéal pour les notifications de groupe
- Gratuit et fiable
Pour les entreprises : Envisager WhatsApp
- Apparence professionnelle
- Livraison directe sur mobile
- Nécessite plus d’efforts de configuration
Support & Ressources
Notes Finales
- Tester votre configuration avec un message simple avant la mise en production
- Conserver des copies de sauvegarde de tous les tokens dans un gestionnaire de mots de passe sécurisé
- Envisager d’utiliser plusieurs plateformes pour la redondance
- Vérifier les limites de taux pour votre volume de messages prévu
- Commencer avec une seule plateforme et étendre au besoin