Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Webhooks réseaux sociaux : commentaires, mentions et messages vers un seul endpoint

easyCoexistence transmet les événements des réseaux sociaux à votre propre endpoint HTTPS dès qu'ils surviennent : commentaires, mentions et DM d'Instagram et de Facebook, et commentaires de TikTok. Chacun arrive dans une enveloppe, avec l'événement du réseau inchangé à l'intérieur, signée par compte avec X-EC-Signature. Activez-le pour chaque compte avec set_social_webhook_destination depuis Claude ou ChatGPT, ou avec la Partner API. Les messages d'un numéro WhatsApp arrivent aussi sur votre serveur.

  • Commentaires, mentions et DM dès leur arrivée
  • Une enveloppe, signée pour chaque compte
  • Configuré depuis Claude, ChatGPT ou la Partner API
Commencer l'essai gratuit

Aucun frais pendant 3 jours. Annulez à tout moment.

API officielles uniquementMCP pour Claude et ChatGPTChaque connexion surveillée 24h/24, 7j/73 jours gratuits
1 attempt

Le nombre de fois où easyCoexistence envoie chaque événement social transmis ; il ne conserve aucune copie, donc rien n'est renvoyé plus tard.

Within 5 minutes

Le délai dans lequel le webhook comment.update de TikTok signale un commentaire créé, supprimé ou dont la visibilité change sur les vidéos publiques d'un compte détenu.

In comments

Où les applications sur Instagram Login reçoivent les @mentions : dans la notification de webhook des commentaires, et non dans un champ qui leur est propre.

3 events

Ce que signalent les notifications push de YouTube pour une chaîne : une nouvelle vidéo, un nouveau titre ou une nouvelle description.

7 days

Combien de temps Meta continue de réessayer un webhook WhatsApp que votre serveur n'a pas accepté, ce qui peut produire des doublons.

Quels événements chaque réseau envoie-t-il ?

Instagram, Facebook et TikTok transmettent leurs événements à easyCoexistence, qui les fait suivre à l'URL que vous avez définie pour ce compte. Instagram envoie les nouveaux commentaires, les @mentions arrivant dans la notification des commentaires, ainsi que les DM. Une Page Facebook envoie l'activité du fil, qui couvre les nouveaux commentaires, ainsi que les messages Messenger et les mentions de la Page. TikTok envoie comment.update, déclenché lorsqu'un commentaire est créé, supprimé ou change de visibilité.

YouTube et LinkedIn n'envoient à easyCoexistence aucun événement de commentaire ni de message : un agent lit donc leurs commentaires à la demande. Un numéro WhatsApp fonctionne sur son propre chemin : Meta livre ses messages directement à votre serveur, ou easyCoexistence les transmet signés lorsque le numéro fonctionne en mode géré.

What arrivesSent by
InstagramComments, mentions and DMseasyCoexistence, signed per account
FacebookFeed activity, Messenger and mentionseasyCoexistence, signed per account
TikTokcomment.update eventseasyCoexistence, signed per account
WhatsAppMessages and echoes from the appMeta directly, or easyCoexistence in managed mode
YouTubeNo comment eventsRead with list_youtube_comments
LinkedInNo comment eventsRead with list_linkedin_comments

À quoi ressemble un événement transmis ?

La même enveloppe JSON pour chaque réseau, envoyée avec Content-Type application/json : platform, le réseau ; account_id, l'identifiant utilisé par les outils MCP et la Partner API ; external_id, l'identifiant du compte sur le réseau ; et entry, l'événement du réseau tel qu'il est arrivé. Pour Instagram et Facebook, entry est l'entrée de webhook de Meta, avec changes pour les commentaires et les mentions, et messaging pour les DM. Pour TikTok, elle contient l'événement comment.update, avec comment_id, video_id et parent_comment_id sous forme de chaînes, de sorte que les identifiants 64 bits ne sont pas arrondis. Un message Messenger arrive ainsi :

A forwarded Messenger message, trimmed
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400512,
    "messaging": [
      {
        "sender": { "id": "<PAGE_SCOPED_ID>" },
        "recipient": { "id": "<PAGE_ID>" },
        "timestamp": 1793318399870,
        "message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
      }
    ]
  }
}

Comment vérifier X-EC-Signature ?

Avec le secret de signature renvoyé lors de la configuration de la destination, propre à ce compte et affiché une seule fois. L'en-tête se lit t=<unix>,v1=<hex>, et v1 est un HMAC-SHA256 de l'horodatage, d'un point et du corps brut de la requête, calculé avec ce secret. Lisez le corps en octets avant de l'analyser, refusez un horodatage qui s'écarte de plus de 5 minutes de votre horloge, recherchez le secret à partir du account_id de l'événement et comparez les deux empreintes en temps constant. Répondez ensuite 2xx et mettez le travail en file d'attente. En PHP, cela tient en quelques lignes :

PHP: verifying a forwarded event
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input');          // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true);                  // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? '');  // the signing_secret stored for that account

$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(401);
    exit;
}

http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resent

Comment activer le transfert pour un compte ?

Depuis un assistant ou depuis votre backend. Demandez à Claude ou ChatGPT d'exécuter set_social_webhook_destination avec le compte et votre URL HTTPS, ou appelez PUT /api/v1/channels/:id/webhook sur la Partner API avec votre clé ec_live_ et un corps contenant l'url. Les deux renvoient le signing_secret du compte une seule fois : conservez-le alors avec le account_id. Chaque nouvel appel émet un nouveau secret, et une url à null désactive le transfert.

L'URL doit être en HTTPS sur un hôte public : une adresse privée est refusée à la configuration, puis à chaque livraison. Un seul endpoint peut servir plusieurs comptes, puisque chaque événement nomme son account_id. Pour un numéro WhatsApp, set_webhook_destination achemine les livraisons de Meta vers vous, et set_inbound_mode avec un forward_url les transmet signées à la place.

Que se passe-t-il si votre endpoint est lent ou en panne ?

L'événement n'est pas renvoyé. easyCoexistence fait une seule tentative, attend jusqu'à 8 secondes une réponse, ne suit aucune redirection et ne conserve aucune copie, car réessayer reviendrait à stocker les commentaires et messages de vos clients. Répondez 2xx dès que la signature est vérifiée, traitez les tâches lentes depuis une file d'attente, et dédupliquez sur les identifiants propres au réseau, comme un identifiant de commentaire ou un mid de message, au cas où un événement arriverait deux fois.

WhatsApp fonctionne autrement. En mode direct, Meta réessaie pendant jusqu'à 7 jours une livraison que votre serveur n'a pas acceptée. En mode géré, easyCoexistence met les messages en file d'attente pour votre URL de transfert et réessaie avec un délai croissant. Les événements de statut Partner, comme une connexion qui tombe, sont réessayés pendant environ 33 heures.

Comment les commentaires YouTube et LinkedIn parviennent-ils à un agent ?

En les lisant selon un calendrier. Les notifications push de YouTube signalent une nouvelle vidéo, un nouveau titre ou une nouvelle description, et non des commentaires ; easyCoexistence ne reçoit aucun événement de commentaire de LinkedIn, donc aucun des deux ne transmet quoi que ce soit. L'agent interroge à la place : list_youtube_comments renvoie les fils d'une vidéo ou ceux de toute la chaîne, y compris ceux retenus pour modération, et list_linkedin_comments renvoie les commentaires d'une publication ou les réponses sous l'un d'eux. Dans n8n, Make ou Zapier, un déclencheur planifié lance la vérification ; dans votre propre code, une tâche cron récupère les identifiants de la chaîne et appelle directement commentThreads de YouTube ou l'endpoint comments de LinkedIn.

Comment le configurer

  1. Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
  2. Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
  3. Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
  4. Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.

Erreurs courantes

  • Vérifier le HMAC sur du JSON déjà analysé. La signature porte sur le corps brut, octet par octet ; resérialiser l'objet analysé modifie ces octets. Vérifiez donc avant d'analyser.
  • Utiliser un seul secret pour tous les comptes. Chaque compte signe avec son propre secret : recherchez-le à partir du account_id de l'événement avant de comparer v1.
  • Reconfigurer la destination sans mettre à jour votre endpoint. Chaque appel émet un nouveau secret et l'ancien cesse de signer immédiatement : enregistrez le nouveau aussitôt.
  • Indiquer une URL qui redirige. Les transferts ne suivent aucune redirection : un déplacement vers un nouveau chemin ou hôte fait perdre l'événement ; indiquez l'adresse finale.
Faire cela avec EasyCoexistence

easyCoexistence envoie les commentaires, mentions et DM d'Instagram et de Facebook, ainsi que les commentaires TikTok, à votre endpoint dès leur arrivée, signés par compte, et achemine les messages WhatsApp vers votre serveur, afin que vos agents IA entendent vos clients via l'API officielle de chaque réseau, avec chaque connexion surveillée 24 h/24 et 7 j/7. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Comment les messages d'un numéro WhatsApp parviennent-ils à mon endpoint ?

De deux façons. set_webhook_destination fait livrer les messages par Meta directement à votre serveur, tandis que set_inbound_mode avec un forward_url fait transmettre par easyCoexistence des messages signés avec X-EC-Signature, réessayés avec un délai croissant.

Un même événement peut-il arriver deux fois ?

Oui, c'est possible, donc dédupliquez sur les identifiants propres au réseau, comme un identifiant de commentaire ou un mid de message. Les nouvelles tentatives de Meta pour une livraison WhatsApp que votre serveur n'a pas acceptée, pendant jusqu'à 7 jours, peuvent aussi produire des doublons.

Un seul endpoint peut-il recevoir les événements de plusieurs comptes ?

Oui. Chaque événement porte platform et account_id, si bien qu'une seule URL peut servir plusieurs comptes, à condition de vérifier chaque signature avec le secret propre à ce compte.

Combien coûte easyCoexistence pour les webhooks réseaux sociaux ?

De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, au même tarif sur chaque réseau. Le transfert, le serveur MCP et la Partner API sont inclus, avec un essai gratuit de 3 jours.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le