Webhookovi društvenih mreža: komentari, pominjanja i poruke na jedan endpoint
easyCoexistence prosleđuje događaje društvenih mreža na vaš HTTPS endpoint čim se dogode: komentari, pominjanja i DM poruke sa Instagrama i Facebooka, i komentari sa TikToka. Svaki stiže u jednom omotaču, sa događajem mreže u nepromenjenom obliku, potpisanom po nalogu pomoću X-EC-Signature. Uključite ga za svaki nalog pomoću set_social_webhook_destination preko Claude ili ChatGPT, ili preko Partner API-ja. Poruke sa WhatsApp broja takođe stižu na vaš server.
- Komentari, pominjanja i DM poruke čim se dogode
- Jedan omotač, potpisan za svaki nalog
- Podešavanje preko Claude, ChatGPT ili Partner API-ja
3 dana bez naplate. Otkažite bilo kada.
Koliko puta easyCoexistence šalje svaki prosleđeni događaj društvene mreže; ne čuva kopiju, pa se ništa ne šalje ponovo kasnije.
Koliko brzo TikTokov webhook comment.update javlja da je komentar kreiran, obrisan ili promenio vidljivost na javnim videima naloga u vlasništvu.
Gde aplikacije sa Instagram Login-om primaju @pominjanja: unutar obaveštenja webhooka za komentare, a ne kao sopstveno polje.
Šta YouTube-ove push notifikacije javljaju za kanal: novi video, novi naslov ili novi opis.
Koliko dugo Meta ponavlja isporuku WhatsApp webhooka koji vaš server nije prihvatio, što može dovesti do duplih isporuka.
Koje događaje šalje svaka mreža?
Instagram, Facebook i TikTok šalju događaje easyCoexistence, koji svaki prosleđuje URL-u koji ste podesili za taj nalog. Instagram šalje nove komentare, pri čemu se @pominjanja pojavljuju unutar obaveštenja o komentarima, i DM poruke. Facebook stranica šalje aktivnost na objavama, što obuhvata nove komentare, kao i Messenger poruke i pominjanja stranice. TikTok šalje comment.update, koji se aktivira kada se komentar kreira, obriše ili promeni vidljivost.
YouTube i LinkedIn easyCoexistence ne šalju događaje o komentarima ili porukama, pa agent čita njihove komentare na zahtev. WhatsApp broj radi na sopstvenoj putanji: Meta svoje poruke isporučuje direktno vašem serveru, ili easyCoexistence prosleđuje poruke potpisane kada broj radi u upravljanom režimu.
| 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 |
Kako izgleda prosleđeni događaj?
Isti JSON omotač na svakoj mreži, poslat uz Content-Type application/json: platform, mreža; account_id, ID koji koriste MCP alati i Partner API; external_id, ID naloga na mreži; i entry, sam događaj mreže onako kako je stigao. Za Instagram i Facebook, entry je Metin webhook entry, sa changes za komentare i pominjanja i messaging za DM poruke. Za TikTok sadrži događaj comment.update, sa comment_id, video_id i parent_comment_id kao stringovima, pa se 64-bitni ID-jevi ne zaokružuju. Messenger poruka stiže ovako:
{
"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?" }
}
]
}
}Kako proveriti X-EC-Signature?
Pomoću tajnog ključa za potpisivanje koji se vraća kada podesite odredište, jedinstvenog za taj nalog i prikazanog samo jednom. Zaglavlje glasi t=<unix>,v1=<hex>, a v1 je HMAC-SHA256 vremenske oznake, tačke i sirovog tela zahteva, računat sa tim tajnim ključem. Telo pročitajte kao bajtove pre parsiranja, odbacite vremensku oznaku koja se razlikuje više od 5 minuta od vašeg sata, pronađite tajni ključ prema account_id događaja i uporedite dva digesta u konstantnom vremenu. Zatim odgovorite sa 2xx i stavite posao u red čekanja. U PHP-u to zahteva nekoliko redova:
<?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 resentKako uključiti prosleđivanje za nalog?
Iz asistenta ili iz vašeg backenda. Zamolite Claude ili ChatGPT da pokrene set_social_webhook_destination sa nalogom i vašim HTTPS URL-om, ili pozovite PUT /api/v1/channels/:id/webhook na Partner API-ju sa ključem ec_live_ i telom koje sadrži url. Oba vraćaju signing_secret naloga jednom, pa ga tada sačuvajte uz account_id. Ponovni poziv bilo kog od njih izdaje novi tajni ključ, a url sa vrednošću null isključuje prosleđivanje.
URL mora biti HTTPS na javnom hostu: privatna adresa se odbija kada je podešavate i ponovo pri isporuci. Jedan endpoint može da opslužuje više naloga, jer svaki događaj navodi svoj account_id. Za WhatsApp broj, set_webhook_destination usmerava Metine isporuke ka vama, a set_inbound_mode sa forward_url ih prosleđuje potpisane.
Šta se dešava kada je vaš endpoint spor ili nedostupan?
Događaj se ne šalje ponovo. easyCoexistence pravi jedan pokušaj, čeka do 8 sekundi na odgovor, ne prati preusmerenja i ne čuva kopiju, jer bi ponavljanje značilo čuvanje komentara i poruka vaših kupaca. Odgovorite sa 2xx čim se potpis proveri, sporiji posao radite iz reda čekanja i deduplicirajte po ID-jevima mreže, kao što su ID komentara ili message mid poruke, u slučaju da događaj stigne dvaput.
WhatsApp je drugačiji. U direktnom režimu, Meta ponavlja isporuku koju vaš server nije prihvatio do 7 dana. U upravljanom režimu, easyCoexistence stavlja poruke u red za vaš forward URL i ponavlja ih sa postepenim razmacima. Partnerski statusni događaji, kao što je prekid veze, ponavljaju se oko 33 sata.
Kako YouTube i LinkedIn komentari stižu do agenta?
Čitanjem po rasporedu. YouTube-ove push notifikacije javljaju novi video, novi naslov ili novi opis, a ne komentare, a easyCoexistence ne prima događaje o komentarima sa LinkedIn-a, pa ništa od toga ne prosleđuje. Agent umesto toga proverava: list_youtube_comments vraća niti komentara jednog videa ili celog kanala, uključujući one koji čekaju odobrenje, a list_linkedin_comments vraća komentare objave ili odgovore ispod jednog komentara. U n8n, Make ili Zapier, okidač po rasporedu pokreće proveru; u sopstvenom kodu, cron posao preuzima akreditive kanala i direktno poziva YouTube-ov commentThreads ili LinkedIn-ov comments endpoint.
Kako da podesite
- 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.
Česte greške
- Proveravanje HMAC-a nad parsiranim JSON-om. Potpis pokriva sirovo telo bajt po bajt, a ponovna serijalizacija parsiranog objekta menja te bajtove, pa proverite pre parsiranja.
- Korišćenje jednog ključa za sve naloge. Svaki nalog potpisuje sopstvenim tajnim ključem, pa ga pronađite prema account_id događaja pre poređenja v1.
- Ponovno podešavanje odredišta bez ažuriranja endpointa. Svaki poziv izdaje novi tajni ključ, a stari prestaje da potpisuje odmah, pa novi odmah sačuvajte.
- Davanje URL-a koji preusmerava. Prosleđivanja ne prate preusmerenja, pa premeštanje na novu putanju ili host gubi događaj; podesite konačnu adresu.
easyCoexistence šalje komentare, pominjanja i DM poruke sa Instagrama i Facebooka, i komentare sa TikToka, na vaš endpoint čim se dogode, potpisane po nalogu, i usmerava WhatsApp poruke na vaš server, tako da vaši AI agenti čuju od kupaca preko zvaničnog API-ja svake mreže, uz praćenje svake veze 24/7. US$ 9 do US$ 0.75 po vezi mesečno, sa smanjenjem kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Kako poruke sa WhatsApp broja stižu do mog endpointa?
Pomoću set_webhook_destination Meta isporučuje poruke direktno vašem serveru, a set_inbound_mode sa forward_url navodi easyCoexistence da ih prosledi potpisane sa X-EC-Signature, uz ponavljanje sa postepenim razmacima.
Može li isti događaj da stigne dvaput?
Može, pa deduplicirajte po ID-jevima mreže, kao što su ID komentara ili message mid poruke. Metina ponavljanja isporuke WhatsApp poruke koju vaš server nije prihvatio, do 7 dana, takođe mogu doneti duplikate.
Može li jedan endpoint da prima događaje od više naloga?
Može. Svaki događaj nosi platform i account_id, pa jedan URL može da opsluži više naloga, pod uslovom da proverava svaki potpis tajnim ključem tog naloga.
Koliko košta easyCoexistence za webhookove društvenih mreža?
US$ 9 do US$ 0.75 po vezi mesečno, sa smanjenjem kako dodajete veze i isto na svakoj mreži. Prosleđivanje, MCP server i Partner API su uključeni, uz prva 3 dana besplatno.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na