Webhook-uri pentru rețelele sociale: comentarii, mențiuni și mesaje către un singur endpoint
easyCoexistence trimite evenimentele din rețelele sociale către endpoint-ul dumneavoastră HTTPS, pe măsură ce au loc: comentarii, mențiuni și DM-uri de pe Instagram și Facebook, precum și comentarii de pe TikTok. Fiecare ajunge într-un singur plic, cu evenimentul rețelei inclus neschimbat, semnat pe cont cu X-EC-Signature. Activați-l pentru fiecare cont cu set_social_webhook_destination din Claude sau ChatGPT, ori prin Partner API. Mesajele unui număr WhatsApp ajung și ele la serverul dumneavoastră.
- Comentarii, mențiuni și DM-uri, pe măsură ce apar
- Un singur plic, semnat pentru fiecare cont
- Setare din Claude, ChatGPT sau Partner API
Nimic de plătit timp de 3 zile. Anulați oricând.
De câte ori trimite easyCoexistence fiecare eveniment social redirecționat; nu păstrează nicio copie, deci nimic nu mai este trimis ulterior.
Cât de repede raportează webhook-ul comment.update al TikTok un comentariu creat, șters sau a cărui vizibilitate se schimbă, pe videoclipurile publice ale unui cont deținut.
Unde primesc aplicațiile pe Instagram Login mențiunile @: în notificarea webhook pentru comentarii, nu ca un câmp propriu.
Ce raportează notificările push ale YouTube pentru un canal: o încărcare nouă, un titlu nou sau o descriere nouă.
Cât timp reîncearcă Meta un webhook WhatsApp pe care serverul dumneavoastră nu l-a acceptat, ceea ce poate livra duplicate.
Ce evenimente trimite fiecare rețea?
Instagram, Facebook și TikTok trimit evenimente către easyCoexistence, care le transmite fiecărui URL setat pentru contul respectiv. Instagram trimite comentarii noi, mențiunile @ sosind în notificarea pentru comentarii, și DM-uri. O pagină de Facebook trimite activitatea din feed, care include comentariile noi, plus mesajele Messenger și mențiunile paginii. TikTok trimite comment.update, declanșat când un comentariu este creat, șters sau își schimbă vizibilitatea.
YouTube și LinkedIn nu trimit către easyCoexistence evenimente de comentarii sau mesaje, așa că un agent își citește comentariile la cerere. Un număr WhatsApp funcționează pe o cale proprie: Meta livrează mesajele direct serverului dumneavoastră, sau easyCoexistence le redirecționează semnate, atunci când numărul rulează în mod gestionat.
| 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 |
Cum arată un eveniment redirecționat?
Același plic JSON pe fiecare rețea, trimis cu Content-Type application/json: platform, rețeaua; account_id, ID-ul folosit de instrumentele MCP și de Partner API; external_id, ID-ul contului pe rețea; și entry, evenimentul propriu al rețelei, așa cum a sosit. Pentru Instagram și Facebook, entry este intrarea webhook Meta, cu changes pentru comentarii și mențiuni și messaging pentru DM-uri. Pentru TikTok conține evenimentul comment.update, cu comment_id, video_id și parent_comment_id ca șiruri de caractere, astfel încât ID-urile pe 64 de biți nu sunt rotunjite. Un mesaj Messenger sosește astfel:
{
"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?" }
}
]
}
}Cum verificați X-EC-Signature?
Cu secretul de semnare primit când setați destinația, unic pentru acel cont și afișat o singură dată. Antetul arată t=<unix>,v1=<hex>, iar v1 este un HMAC-SHA256 al marcajului de timp, al unui punct și al corpului brut al cererii, cu acel secret drept cheie. Citiți corpul cererii ca octeți înainte de a-l parsa, refuzați un marcaj de timp cu mai mult de 5 minute diferență față de ceasul dumneavoastră, căutați secretul după account_id-ul evenimentului și comparați cele două digeste în timp constant. Apoi răspundeți cu 2xx și puneți munca în coadă. În PHP, asta necesită câteva rânduri:
<?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 resentCum activați redirecționarea pentru un cont?
Dintr-un asistent sau din backend. Cereți lui Claude sau ChatGPT să ruleze set_social_webhook_destination cu contul și URL-ul dumneavoastră HTTPS, sau apelați PUT /api/v1/channels/:id/webhook din Partner API cu cheia ec_live_ și un corp care conține url. Ambele returnează signing_secret al contului o singură dată, deci stocați-l pe loc, asociat cu account_id. Apelarea din nou emite un secret nou, iar o valoare null pentru url oprește redirecționarea.
URL-ul trebuie să fie HTTPS pe un host public: o adresă privată este refuzată la setare și din nou la livrare. Un singur endpoint poate servi mai multe conturi, deoarece fiecare eveniment indică account_id. Pentru un număr WhatsApp, set_webhook_destination direcționează livrările Meta către dumneavoastră, iar set_inbound_mode cu un forward_url le redirecționează semnate.
Ce se întâmplă când endpoint-ul dumneavoastră este lent sau indisponibil?
Evenimentul nu este trimis din nou. easyCoexistence face o singură încercare, așteaptă până la 8 secunde un răspuns, nu urmează redirecționări și nu păstrează nicio copie, pentru că reîncercarea ar presupune stocarea comentariilor și mesajelor clienților dumneavoastră. Răspundeți cu 2xx imediat ce semnătura este verificată, faceți munca lentă dintr-o coadă și deduplicați pe ID-urile rețelei, cum ar fi un ID de comentariu sau un mid de mesaj, în cazul în care un eveniment sosește de două ori.
WhatsApp diferă. În modul direct, Meta reîncearcă livrarea pe care serverul dumneavoastră nu a acceptat-o timp de până la 7 zile. În modul gestionat, easyCoexistence pune mesajele în coadă pentru URL-ul de redirecționare și reîncearcă cu întârziere crescătoare. Evenimentele de stare ale partenerilor, precum o conexiune căzută, sunt reîncercate timp de aproximativ 33 de ore.
Cum ajung comentariile YouTube și LinkedIn la un agent?
Prin citirea lor după un program. Notificările push ale YouTube raportează o încărcare nouă, un titlu nou sau o descriere nouă, nu comentarii, iar easyCoexistence nu primește evenimente de comentarii de la LinkedIn, deci niciuna dintre ele nu redirecționează nimic. Agentul verifică în schimb: list_youtube_comments returnează firele de comentarii ale unui videoclip sau ale întregului canal, inclusiv cele reținute pentru revizuire, iar list_linkedin_comments returnează comentariile unei postări sau răspunsurile de sub unul dintre ele. În n8n, Make sau Zapier, un declanșator programat pornește verificarea; în propriul cod, un job cron preia credențialele canalului și apelează direct commentThreads de la YouTube sau endpoint-ul de comentarii de la LinkedIn.
Cum să îl configurați
- 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.
Greșeli frecvente
- Verificarea HMAC peste JSON parsat. Semnătura acoperă corpul brut octet cu octet, iar serializarea din nou a obiectului parsat schimbă acei octeți, deci verificați înainte de parsare.
- Folosirea unui singur secret pentru fiecare cont. Fiecare cont semnează cu propriul secret, deci căutați-l după account_id-ul evenimentului înainte de a compara v1.
- Setarea destinației din nou fără actualizarea endpoint-ului. Fiecare apel emite un secret nou, iar cel vechi nu mai semnează imediat, deci stocați noul secret pe loc.
- Indicarea unui URL care redirecționează. Transmiterile nu urmează nicio redirecționare HTTP, deci o mutare pe altă cale sau alt host pierde evenimentul; setați adresa finală.
easyCoexistence trimite comentariile, mențiunile și DM-urile de pe Instagram și Facebook, precum și comentariile TikTok, către endpoint-ul dumneavoastră în timp real, semnate pe cont, și direcționează mesajele WhatsApp către serverul dumneavoastră. Astfel, agenții AI aud direct de la clienți prin API-urile oficiale ale fiecărei rețele, iar fiecare conexiune este monitorizată 24/7. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Cum ajung mesajele unui număr WhatsApp la endpoint-ul meu?
În două moduri. set_webhook_destination face ca Meta să le livreze direct serverului dumneavoastră, în timp ce set_inbound_mode cu un forward_url face ca easyCoexistence să le redirecționeze semnate cu X-EC-Signature, reîncercând cu întârziere crescătoare.
Același eveniment poate sosi de două ori?
Poate, de aceea deduplicați pe ID-urile rețelei, cum ar fi un ID de comentariu sau un mid de mesaj. Reîncercările Meta ale unei livrări WhatsApp pe care serverul dumneavoastră nu a acceptat-o, timp de până la 7 zile, pot aduce și ele duplicate.
Poate un singur endpoint primi evenimente de la mai multe conturi?
Da. Fiecare eveniment are platform și account_id, deci un singur URL poate servi mai multe conturi, cu condiția să verifice fiecare semnătură cu propriul secret al contului.
Cât costă easyCoexistence pentru webhook-urile rețelelor sociale?
De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu același preț pe fiecare rețea. Redirecționarea, serverul MCP și Partner API sunt incluse, cu primele 3 zile gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la