Webhooks voor social media: reacties, vermeldingen en berichten naar één endpoint
easyCoexistence stuurt social media-gebeurtenissen direct door naar je eigen HTTPS-endpoint: reacties, vermeldingen en DM's van Instagram en Facebook, en reacties van TikTok. Elke gebeurtenis komt aan in één envelop, met de gebeurtenis van het netwerk er onveranderd in, ondertekend per account met X-EC-Signature. Schakel het per account in met set_social_webhook_destination vanuit Claude of ChatGPT, of met de Partner API. Ook de berichten van een WhatsApp-nummer bereiken je server.
- Reacties, vermeldingen en DM's zodra ze binnenkomen
- Eén envelop, ondertekend per account
- Instellen vanuit Claude, ChatGPT of de Partner API
3 dagen lang niets betalen. Annuleer op elk moment.
Hoe vaak easyCoexistence elke doorgestuurde social-gebeurtenis verstuurt; het bewaart geen kopie, dus er wordt later niets opnieuw verstuurd.
Hoe snel de comment.update-webhook van TikTok meldt dat een reactie is aangemaakt, verwijderd of van zichtbaarheid is veranderd op de openbare video's van een eigen account.
Waar apps op Instagram Login @-vermeldingen ontvangen: binnen de melding van de reacties-webhook, niet als eigen veld.
Wat de pushmeldingen van YouTube voor een kanaal melden: een nieuwe upload, een nieuwe titel of een nieuwe beschrijving.
Hoe lang Meta blijft proberen een WhatsApp-webhook opnieuw te leveren die je server niet heeft geaccepteerd, wat tot dubbele berichten kan leiden.
Welke gebeurtenissen stuurt elk netwerk?
Instagram, Facebook en TikTok sturen gebeurtenissen naar easyCoexistence, dat elke gebeurtenis doorgeeft aan de URL die je voor dat account hebt ingesteld. Instagram stuurt nieuwe reacties, waarbij @-vermeldingen binnen de meldingen over reacties aankomen, en DM's. Een Facebook-pagina stuurt feed-activiteit, dat nieuwe reacties omvat, plus Messenger-berichten en vermeldingen van de pagina. TikTok stuurt comment.update, die wordt geactiveerd wanneer een reactie wordt aangemaakt, verwijderd of van zichtbaarheid verandert.
YouTube en LinkedIn sturen easyCoexistence geen gebeurtenissen over reacties of berichten, dus een agent leest hun reacties op verzoek. Een WhatsApp-nummer werkt via een eigen route: Meta levert de berichten rechtstreeks aan je server, of easyCoexistence stuurt ze ondertekend door wanneer het nummer in beheerde modus draait.
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read with list_linkedin_comments |
Hoe ziet een doorgestuurde gebeurtenis eruit?
Dezelfde JSON-envelop op elk netwerk, verstuurd met Content-Type application/json: platform, het netwerk; account_id, het ID dat de MCP-tools en de Partner API gebruiken; external_id, het ID van het account op het netwerk; en entry, de eigen gebeurtenis van het netwerk zoals die binnenkwam. Bij Instagram en Facebook is entry de webhook-entry van Meta, met changes voor reacties en vermeldingen en messaging voor DM's. Bij TikTok bevat het de comment.update-gebeurtenis, met comment_id, video_id en parent_comment_id als strings, zodat 64-bit-ID's niet worden afgerond. Een Messenger-bericht komt zo binnen:
{
"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?" }
}
]
}
}Hoe verifieer je X-EC-Signature?
Met het ondertekeningsgeheim dat je terugkrijgt wanneer je de bestemming instelt; dit is uniek voor dat account en wordt maar één keer getoond. De header luidt t=<unix>,v1=<hex>, en v1 is een HMAC-SHA256 van de timestamp, een punt en de ruwe body van het verzoek, gesleuteld met dat geheim. Lees de body als bytes voordat je hem parseert, weiger een timestamp die meer dan 5 minuten van je klok afwijkt, zoek het geheim op via de account_id van de gebeurtenis en vergelijk de twee hashes in constante tijd. Antwoord daarna met 2xx en zet het werk in een wachtrij. In PHP zijn daar een paar regels voor nodig:
<?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 resentHoe zet je doorsturen aan voor een account?
Vanuit een assistent of vanuit je backend. Vraag Claude of ChatGPT om set_social_webhook_destination uit te voeren met het account en je HTTPS-URL, of roep PUT /api/v1/channels/:id/webhook aan op de Partner API met je ec_live_-sleutel en een body met de url. Beide geven het signing_secret van het account één keer terug, dus bewaar het dan meteen bij de account_id. Opnieuw aanroepen geeft een nieuw geheim, en een url van null schakelt het doorsturen uit.
De URL moet HTTPS zijn op een openbare host: een privéadres wordt geweigerd bij het instellen en opnieuw bij de levering. Eén endpoint kan veel accounts bedienen, want elke gebeurtenis noemt zijn account_id. Voor een WhatsApp-nummer stuurt set_webhook_destination de leveringen van Meta naar jou, en set_inbound_mode met een forward_url stuurt ze ondertekend door.
Wat gebeurt er als je endpoint traag is of niet bereikbaar is?
De gebeurtenis wordt niet opnieuw verstuurd. easyCoexistence doet één poging, wacht maximaal 8 seconden op een antwoord, volgt geen doorverwijzingen en bewaart geen kopie, want opnieuw proberen zou betekenen dat de reacties en berichten van je klanten worden opgeslagen. Antwoord met 2xx zodra de handtekening klopt, verwerk trage taken via een wachtrij en ontdubbel op de eigen ID's van het netwerk, zoals een reactie-ID of een bericht-mid, voor het geval een gebeurtenis twee keer binnenkomt.
WhatsApp verschilt. In de directe modus probeert Meta een levering die je server niet heeft geaccepteerd tot 7 dagen lang opnieuw. In de beheerde modus zet easyCoexistence berichten in de wachtrij voor je forward_url en probeert het opnieuw met oplopende wachttijd. Partner-statusgebeurtenissen, zoals een verbinding die wegvalt, worden ongeveer 33 uur lang opnieuw geprobeerd.
Hoe komen YouTube- en LinkedIn-reacties bij een agent terecht?
Door ze volgens een schema te lezen. De pushmeldingen van YouTube melden een nieuwe upload, een nieuwe titel of een nieuwe beschrijving, geen reacties, en easyCoexistence ontvangt geen reactiegebeurtenissen van LinkedIn, dus geen van beide stuurt iets door. Een agent controleert daarom zelf: list_youtube_comments geeft de threads van een video of van het hele kanaal terug, inclusief de threads die ter beoordeling staan, en list_linkedin_comments geeft de reacties op een bericht of de antwoorden onder één reactie. In n8n, Make of Zapier start een schematrigger de controle; in je eigen code haalt een cronjob de inloggegevens van het kanaal op en roept rechtstreeks het commentThreads-endpoint van YouTube of het comments-endpoint van LinkedIn aan.
Zo stel je het in
- 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.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.
Veelgemaakte fouten
- De HMAC controleren over geparsede JSON. De handtekening dekt de ruwe body byte voor byte, en als je het geparste object opnieuw serialiseert, veranderen die bytes; verifieer dus voordat je parseert.
- Eén geheim gebruiken voor elk account. Elk account ondertekent met zijn eigen geheim, dus zoek het op via de account_id van de gebeurtenis voordat je v1 vergelijkt.
- De bestemming opnieuw instellen zonder je endpoint bij te werken. Elke aanroep geeft een nieuw geheim en het oude ondertekent meteen niet meer, dus bewaar het nieuwe direct.
- Een URL geven die doorverwijst. Doorstuurverzoeken volgen geen doorverwijzingen, dus een verhuizing naar een ander pad of host laat de gebeurtenis verloren gaan; stel het definitieve adres in.
easyCoexistence stuurt reacties, vermeldingen en DM's van Instagram en Facebook, en TikTok-reacties, direct naar je endpoint, ondertekend per account, en stuurt WhatsApp-berichten naar je server, zodat je AI-agents klanten horen via de officiële API van elk netwerk, met elke verbinding 24/7 bewaakt. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Hoe bereiken berichten van een WhatsApp-nummer mijn endpoint?
Op een van twee manieren. set_webhook_destination laat Meta ze rechtstreeks naar je server leveren, terwijl set_inbound_mode met een forward_url easyCoexistence ze ondertekend met X-EC-Signature laat doorsturen, met oplopende wachttijd bij opnieuw proberen.
Kan dezelfde gebeurtenis twee keer binnenkomen?
Dat kan, dus ontdubbel op de eigen ID's van het netwerk, zoals een reactie-ID of een bericht-mid. Meta's pogingen om een WhatsApp-levering opnieuw te versturen die je server niet heeft geaccepteerd, tot 7 dagen lang, kunnen ook dubbele berichten opleveren.
Kan één endpoint gebeurtenissen van meerdere accounts ontvangen?
Ja. Elke gebeurtenis bevat platform en account_id, dus één URL kan veel accounts bedienen, zolang hij elke handtekening controleert met het eigen geheim van dat account.
Hoeveel kost easyCoexistence voor social media-webhooks?
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, en op elk netwerk hetzelfde. Doorsturen, de MCP-server en de Partner API zijn inbegrepen, met de eerste 3 dagen gratis.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op