Connectez tous les canaux
dans une seule boîte de réception.

§ 00Ce dont vous avez besoin

Chaque canal prend 5 à 20 minutes. Vous travaillerez à deux endroits : la console développeur du canal (BotFather de Telegram, Meta Developer Dashboard) et l'écran Canaux de votre workspace EasyLiveChat à app.livechattools.com/channels.

Les quatre canaux partagent la même architecture dans EasyLiveChat — une Conversation normalisée par contact, une boîte de réception, une zone de réponse. Les différences sont dans les identifiants requis par chaque fournisseur et dans leur schéma de signature de webhook.

§ 01Telegram

Le canal le plus simple à configurer. Telegram n'a pas besoin d'app développeur ni de compte business — juste un bot. Les tokens de bot durent indéfiniment et l'intégration entière prend environ cinq minutes.

1. Créer un bot avec BotFather

Ouvrez Telegram et démarrez une discussion avec @BotFather. Envoyez /newbot, choisissez un nom d'affichage et un nom d'utilisateur se terminant par bot. . BotFather répond avec un token de la forme 1234567890:ABCdefGHI…. Copiez-le.

2. Connectez-le dans EasyLiveChat

Dans votre workspace, allez à Canaux → Bot Telegram → Connecter. Collez le token du bot. Choisissez un nom d'affichage — il n'apparaît que dans la boîte de réception. Soumettez.

Ouvrez Paramètres de l'intégration sur la nouvelle ligne pour révéler le Secret de webhook et l'URL de callback de l'intégration.

3. Pointer Telegram vers notre webhook

L'API Bot de Telegram n'a pas d'interface pour les webhooks ; vous les définissez via setWebhook. Remplacez les placeholders ci-dessous par votre token de bot, l'ID d'intégration et le secret de webhook, puis exécutez-le une fois :

curl -X POST "https://api.telegram.org/bot${BOT_TOKEN}/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.livechattools.com/api/channels/webhook/telegram/${INTEGRATION_ID}",
    "secret_token": "${WEBHOOK_SECRET}",
    "allowed_updates": ["message", "edited_message"]
  }'

Telegram répond {"ok":true,"description":"Webhook was set"}. . Vérifiez avec getWebhookInfo — — le pending_update_count devrait tomber à 0.

4. Tester

Ouvrez t.me/yourbot_username dans Telegram, touchez Démarrer, envoyez un message quelconque. Il devrait apparaître dans votre boîte EasyLiveChat en moins d'une seconde avec le nom de l'expéditeur et le code de langue. Répondez depuis le tableau de bord — il arrivera sur le Telegram du visiteur un instant plus tard.

§ 02WhatsApp Cloud

Meta Cloud API est le bon choix pour presque tout le monde — entièrement hébergé, gratuit jusqu'à 1 000 conversations de service par mois, et le seul transport WhatsApp ne nécessitant aucune infrastructure de votre côté. La configuration est plus lourde que Telegram car Meta exige une app développeur et un business portfolio vérifié pour le trafic de production.

1. Créer une app développeur Meta

Allez à developers.facebook.com/apps → Create App. Choisissez un nom, un email, puis sur l'écran suivant sélectionnez le cas d'usage « Connect with customers through WhatsApp ». Attachez un Business Portfolio — existant ou le Test Business intégré de Meta pour évaluation.

Une fois l'app créée, ouvrez Use Cases → Connect on WhatsApp → API Setup. Vous verrez un Phone Number ID (le numéro de test gratuit fourni par Meta, ou le vôtre une fois ajouté) et un bouton Generate access token. Cliquez, approuvez, copiez le token résultant. Copiez aussi le Phone Number ID.

2. Récupérer l'App Secret

Dans le même tableau de bord Meta, ouvrez App settings → Basic. L'App Secret est caché derrière un bouton Show — révélez et copiez. C'est la clé HMAC avec laquelle Meta signe chaque POST de webhook. Sans elle, vos messages entrants seront rejetés en tant que BAD_SIGNATURE.

3. Connecter WhatsApp dans EasyLiveChat

Canaux → WhatsApp Cloud → Connecter. Remplissez le nom d'affichage (libre), le Phone Number ID, l'Access Token et l'App Secret. Soumettez. Ouvrez les paramètres de l'intégration pour copier le secret de webhook auto-généré et l'ID d'intégration.

4. Configurer le webhook Meta

De retour dans le tableau de bord Meta, allez à Use Cases → Connect on WhatsApp → Configuration. Collez :

Callback URL : https://api.livechattools.com/api/channels/webhook/whatsapp/${INTEGRATION_ID}
Verify token : ${WEBHOOK_SECRET}

Cliquez Verify and save. Meta envoie un handshake GET — nous renvoyons son challenge si le verify token correspond. Sur la même page, trouvez la liste Webhook fields et activez messages sur Subscribed. Sans ce toggle, Meta accepte l'URL du webhook mais ne livre jamais rien.

5. Ajouter un destinataire de test (sandbox uniquement)

Si vous utilisez le numéro de test gratuit de Meta, vous devez inclure chaque destinataire dans une liste d'autorisation avant de pouvoir lui envoyer. Dans API Setup → To, ajoutez le numéro depuis lequel vous enverrez les messages — Meta envoie un OTP à 6 chiffres par SMS pour vérification. Jusqu'à cinq destinataires de test possibles. Les vrais numéros business n'ont pas cette restriction.

§ 03Facebook Messenger

Messenger utilise la même Meta App, le même App Secret et la même tuyauterie de webhook que WhatsApp — mais parle à une Page Facebook au lieu d'un numéro de téléphone, et les access tokens sont des Page Access Tokens, pas des tokens WhatsApp Business.

1. Ajouter Messenger à votre app Meta

Dans la même app que vous avez utilisée pour WhatsApp (ou une nouvelle), ouvrez Use cases → Add use cases → filtrez Business messaging → Engage with customers on Messenger from Meta. Enregistrez. L'app a maintenant deux produits côte à côte.

2. Connecter une Page Facebook

Ouvrez Messenger from Meta → Messenger API Settings. Sous Generate access tokens, cliquez Connect à côté de No FB pages yet. Meta demande à quelles Pages donner accès — choisissez celle qui recevra les messages, acceptez les permissions, enregistrez.

La Page apparaît maintenant avec un Page Access Token en un clic et un Page ID. Copiez les deux. Le Page ID est aussi la valeur que vous collerez comme pageId dans EasyLiveChat.

3. Connecter Messenger dans EasyLiveChat

Canaux → Messenger → Connecter. Remplissez Page ID, Page Access Token et le même App Secret que pour WhatsApp. Soumettez et copiez le secret de webhook + ID de la nouvelle intégration.

4. Abonnement webhook à deux couches

Messenger a une particularité que WhatsApp n'a pas : il nécessite deux abonnements pour livrer quoi que ce soit. D'abord l'abonnement au niveau de l'app — dans Messenger API Settings → Configure webhooks, collez :

Callback URL : https://api.livechattools.com/api/channels/webhook/messenger/${INTEGRATION_ID}
Verify token : ${WEBHOOK_SECRET}

Cliquez Verify and save, puis déployez Webhook fields et activez messages. Ensuite l'abonnement au niveau de la Page, que vous ne pouvez pas faire depuis l'UI — exécutez ce curl :

curl -X POST "https://graph.facebook.com/v20.0/${PAGE_ID}/subscribed_apps" \
  -d "subscribed_fields=messages,messaging_postbacks,message_deliveries,message_reads" \
  -d "access_token=${PAGE_ACCESS_TOKEN}"

Sans l'abonnement au niveau de la Page, Meta retourne {"success":true} sur l'abonnement de l'app mais ne déclenche jamais le webhook. Vous pouvez confirmer que tout est câblé en interrogeant :

curl "https://graph.facebook.com/v20.0/${APP_ID}/subscriptions?access_token=${APP_ID}|${APP_SECRET}"

La réponse doit lister un objet de type page avec un tableau fields non vide incluant messages.

§ 04Instagram DM

La messagerie Instagram passe par les mêmes tuyaux Messenger Platform mais ajoute deux exigences : le compte Instagram doit être un compte Business (pas personnel ni Créateur), et doit être connecté à une Page Facebook dans le même Business Portfolio. Une fois les deux remplies, votre Page Access Token est aussi votre access token Instagram.

1. Convertir le compte IG en Business

Sur l'app mobile Instagram : Paramètres → Compte → Passer à un compte professionnel → Entreprise. N'importe quelle catégorie. La conversion est réversible.

2. Ajouter le compte IG à votre Business Portfolio

Dans Meta Business Suite Settings → Accounts → Instagram accounts → Add → connectez-vous avec les identifiants IG. Meta confirme et affiche l'Instagram Business Account ID du compte IG — un nombre de 17 chiffres commençant par 1784…. Copiez-le ; c'est votre pageId pour l'intégration EasyLiveChat.

3. Lier IG à la Page Facebook

C'est l'étape la plus oubliée. Ouvrez la boîte de réception de la Page Facebook dans Meta Business Suite — business.facebook.com/latest/inbox?asset_id={page_id}. Une bannière indique « Connect to Instagram » avec un bouton Connect. Cliquez, connectez-vous à Instagram, accordez les permissions demandées, confirmez. Après cela, la Graph API de Meta commencera à répondre aux questions sur le compte IG avec un scope au token d'accès de la Page.

4. Connecter Instagram dans EasyLiveChat

Canaux → Instagram DM → Connecter. Utilisez l'Instagram Business Account ID de l'étape 2 comme pageId, le même Page Access Token utilisé pour Messenger comme pageAccessToken, et le même App Secret qu'avant.

5. S'abonner aux deux couches

Instagram utilise object=instagram pour les webhooks au niveau de l'app (Messenger utilisait object=page. ). Ajoutez ce curl en plus de l'abonnement Messenger existant :

curl -X POST "https://graph.facebook.com/v20.0/${APP_ID}/subscriptions" \
  -d "object=instagram" \
  -d "callback_url=https://api.livechattools.com/api/channels/webhook/instagram/${INTEGRATION_ID}" \
  -d "verify_token=${WEBHOOK_SECRET}" \
  -d "fields=messages,messaging_postbacks,message_reactions" \
  -d "access_token=${APP_ID}|${APP_SECRET}"

§ 05Dépannage