Guide de configuration de diffusion MagicTradeBot

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

  1. Aller sur Meta for Developers
  2. Cliquer sur « My Apps » → « Create App »
  3. Sélectionner « Business » comme type d’application
  4. Remplir les détails de l’application et créer l’application

Étape 2 : Ajouter le Produit WhatsApp

  1. Dans le tableau de bord de l’application, cliquer sur « Add Product »
  2. Trouver « WhatsApp » et cliquer sur « Set Up »
  3. Sélectionner ou créer un Portfolio Business

Étape 3 : Obtenir Vos Identifiants

  1. Naviguer vers WhatsApp → Configuration API
  2. 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

  1. Sur la page de configuration de l’API WhatsApp, ajouter votre numéro WhatsApp personnel comme destinataire
  2. 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

  1. Ouvrir Discord et aller sur votre serveur
  2. Cliquer droit sur le canal où vous voulez les notifications
  3. Sélectionner « Edit Channel »

Étape 2 : Créer un Webhook

  1. Aller dans l’onglet « Integrations »
  2. Cliquer sur « Webhooks » → « Create Webhook »
  3. Donner un nom au webhook (ex. : « MagicTradeBot Signals »)
  4. (Optionnel) Télécharger un avatar personnalisé

Étape 3 : Copier l’URL du Webhook

  1. Cliquer sur « Copy Webhook URL »
  2. 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

  1. Dans l’application Instagram : Paramètres → Compte
  2. Sélectionner « Switch to Professional Account »
  3. Choisir « Business » ou « Creator »

Étape 2 : Connecter à une Page Facebook

  1. Aller dans Paramètres → Compte → Comptes Liés
  2. Lier votre Instagram à une Page Facebook

Étape 3 : Créer une Application Meta

  1. Aller sur Meta for Developers
  2. Créer une nouvelle application (si ce n’est pas déjà fait)
  3. Ajouter le produit « Instagram »

Étape 4 : Générer un Token d’Accès

  1. Aller dans Instagram → Basic Display ou Instagram Graph API
  2. 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

  1. Ouvrir Telegram et chercher @BotFather
  2. Démarrer une discussion et envoyer /newbot
  3. 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

  1. BotFather vous fournira le token du bot
  2. Format : 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  3. Conserver ce token en sécurité

Étape 3 : Obtenir Votre ID de Chat

Méthode 1 : Utiliser IDBot

  1. Chercher @myidbot ou @userinfobot sur Telegram
  2. Démarrer une discussion et envoyer /start
  3. Le bot répondra avec votre ID de chat

Méthode 2 : Méthode Manuelle

  1. Envoyer un message à votre bot (celui que vous avez créé)
  2. Visiter : https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
  3. Chercher "chat":{"id":123456789}
  4. Ce nombre est votre chat_id

Méthode 3 : Pour les Discussions de Groupe

  1. Ajouter votre bot au groupe
  2. Envoyer un message dans le groupe
  3. Visiter : https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
  4. Chercher l’ID de chat (sera négatif pour les groupes : -123456789)

Étape 4 : Démarrer Votre Bot

  1. Chercher votre bot dans Telegram
  2. 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
WhatsApp ⭐⭐⭐ Complexe Niveau gratuit limité Bonne Communications business
Instagram ⭐⭐⭐⭐ 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é

  1. Ne jamais committer les tokens dans le contrôle de version
    • Utiliser des variables d’environnement
    • Ajouter les fichiers de configuration à .gitignore
  2. 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
  3. Utiliser des configurations spécifiques à l’environnement
    • Tokens différents pour les tests et la production
  4. Restreindre l’accès aux webhooks
    • Discord : Utiliser des canaux dédiés avec accès limité
    • WhatsApp : Vérifier les numéros destinataires
  5. 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

📎 Related Topics