Webhookovi društvenih mreža: komentari, spominjanja i poruke na jedan endpoint
easyCoexistence prosljeđuje događaje s društvenih mreža na vaš vlastiti HTTPS endpoint čim se dogode: komentari, spominjanja i DM-ovi s Instagrama i Facebooka te komentari s TikToka. Svaki stiže u jednoj omotnici, a događaj mreže unutra ostaje nepromijenjen i potpisan po računu zaglavljem X-EC-Signature. Uključite ga za svaki račun pomoću set_social_webhook_destination iz Claudea ili ChatGPT-ja ili putem Partner API-ja. Poruke s WhatsApp broja također stižu na vaš poslužitelj.
- Komentari, spominjanja i DM-ovi čim se dogode
- Jedna omotnica, potpisana za svaki račun
- Postavljanje iz Claudea, ChatGPT-ja ili Partner API-ja
3 dana bez naplate. Otkažite bilo kada.
Koliko puta easyCoexistence šalje svaki proslijeđeni društveni događaj; ne čuva kopiju, pa se ništa ne šalje ponovno naknadno.
Koliko brzo TikTokov comment.update webhook javlja da je komentar stvoren, obrisan ili promijenio vidljivost na javnim videozapisima vlasničkog računa.
Gdje aplikacije na Instagram Loginu primaju @spominjanja: unutar obavijesti webhooka za komentare, a ne kao vlastito polje.
Što YouTubeove push obavijesti javljaju za kanal: novi videozapis, novi naslov ili novi opis.
Koliko dugo Meta ponavlja pokušaje isporuke WhatsApp webhooka koji vaš poslužitelj nije prihvatio, što može donijeti duplikate.
Koje događaje šalje svaka mreža?
Instagram, Facebook i TikTok šalju događaje na easyCoexistence, koji svaki prosljeđuje na URL koji postavite za taj račun. Instagram šalje nove komentare, pri čemu se @spominjanja pojavljuju unutar obavijesti o komentarima, te DM-ove. Facebook stranica šalje aktivnost na feedu, koja obuhvaća nove komentare, plus poruke na Messengeru i spominjanja stranice. TikTok šalje comment.update, koji se aktivira kada je komentar stvoren, obrisan ili promijeni vidljivost.
YouTube i LinkedIn ne šalju easyCoexistenceu događaje o komentarima ni porukama, pa agent čita njihove komentare na zahtjev. WhatsApp broj radi na vlastitom putu: Meta svoje poruke isporučuje izravno na vaš poslužitelj, ili ih easyCoexistence prosljeđuje potpisane kada broj radi u upravljanom načinu rada.
| 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 proslijeđeni događaj?
Isti JSON omotač na svakoj mreži, poslan s Content-Type application/json: platform, mreža; account_id, ID koji koriste MCP alati i Partner API; external_id, ID računa na mreži; i entry, vlastiti događaj mreže onakav kakav je stigao. Za Instagram i Facebook, entry je Metin webhook entry, s changes za komentare i spominjanja te messaging za DM-ove. Za TikTok sadrži događaj comment.update, s comment_id, video_id i parent_comment_id kao stringovima, pa se 64-bitni ID-jevi ne zaokružuju. Poruka na Messengeru 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 provjeriti X-EC-Signature?
Pomoću tajnog ključa za potpisivanje koji se vraća kada postavite odredište, jedinstvenog za taj račun i prikazanog jednom. Zaglavlje glasi t=<unix>,v1=<hex>, a v1 je HMAC-SHA256 vremenske oznake, točke i sirovog tijela zahtjeva, potpisan tim tajnim ključem. Tijelo pročitajte kao bajtove prije parsiranja, odbijte vremensku oznaku koja se razlikuje više od 5 minuta od vašeg sata, potražite tajni ključ prema account_id događaja i usporedite dva sažetka u konstantnom vremenu. Zatim odgovorite 2xx i stavite posao u red čekanja. U PHP-u to zauzima nekoliko redaka:
<?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 proslijeđivanje za račun?
Iz asistenta ili iz vašeg backenda. Zamolite Claude ili ChatGPT da pokrenu set_social_webhook_destination s računom i vašim HTTPS URL-om, ili pozovite PUT /api/v1/channels/:id/webhook na Partner API-ju s vašim ključem ec_live_ i tijelom koje sadrži url. Oba vraćaju signing_secret računa jednom, pa ga tada pohranite uz account_id. Ponovni poziv bilo kojeg od njih izdaje novi tajni ključ, a url s vrijednošću null isključuje proslijeđivanje.
URL mora biti HTTPS na javnom hostu: privatna adresa odbija se pri postavljanju i opet pri isporuci. Jedan endpoint može služiti mnogim računima, jer svaki događaj navodi svoj account_id. Za WhatsApp broj, set_webhook_destination usmjerava Metine isporuke prema vama, a set_inbound_mode s forward_url ih umjesto toga prosljeđuje potpisane.
Što se dogodi kada je vaš endpoint spor ili nedostupan?
Događaj se ne šalje ponovno. easyCoexistence čini jedan pokušaj, čeka do 8 sekundi na odgovor, ne slijedi preusmjeravanja i ne čuva kopiju, jer bi ponavljanje značilo pohranjivanje komentara i poruka vaših kupaca. Odgovorite 2xx čim se potpis provjeri, sporiji posao obavljajte iz reda čekanja i deduplicirajte prema ID-jevima mreže, poput ID-ja komentara ili message mid, u slučaju da događaj stigne dvaput.
WhatsApp se razlikuje. U izravnom načinu rada Meta ponavlja isporuku koju vaš poslužitelj nije prihvatio do 7 dana. U upravljanom načinu rada easyCoexistence stavlja poruke u red čekanja za vaš forward URL i ponavlja pokušaje s postupnim produljivanjem razmaka. Statusni događaji partnera, poput prekida veze, ponavljaju se oko 33 sata.
Kako komentari s YouTubea i LinkedIna stižu do agenta?
Čitanjem prema rasporedu. YouTubeove push obavijesti javljaju novi videozapis, novi naslov ili novi opis, a ne komentare, a easyCoexistence ne prima događaje o komentarima s LinkedIna, pa ništa od toga ne proslijeđuje. Agent umjesto toga provjerava: list_youtube_comments vraća niti videozapisa ili cijelog kanala, uključujući one koji čekaju pregled, a list_linkedin_comments vraća komentare objave ili odgovore ispod jednog komentara. U n8n, Make ili Zapier okidač po rasporedu pokreće provjeru; u vlastitom kodu cron posao dohvaća vjerodajnice kanala i izravno poziva YouTubeov commentThreads ili LinkedInov comments endpoint.
Kako ga postaviti
- 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.
Uobičajene pogreške
- Provjera HMAC-a nad raščlanjenim JSON-om. Potpis pokriva sirovo tijelo bajt po bajt, a ponovno serijaliziranje raščlanjenog objekta mijenja te bajtove, pa provjerite prije parsiranja.
- Jedan tajni ključ za sve račune. Svaki račun potpisuje vlastitim tajnim ključem, pa ga potražite prema account_id događaja prije usporedbe v1.
- Ponovno postavljanje odredišta bez ažuriranja endpointa. Svaki poziv izdaje novi tajni ključ, a stari odmah prestaje potpisivati, pa novi odmah pohranite.
- Zadavanje URL-a koji preusmjerava. Proslijeđivanja ne slijede preusmjeravanja, pa premještanje na novu putanju ili host gubi događaj; postavite konačnu adresu.
easyCoexistence šalje komentare, spominjanja i DM-ove s Instagrama i Facebooka te komentare s TikToka na vaš endpoint čim se dogode, potpisane po računu, i usmjerava WhatsApp poruke na vaš poslužitelj, tako da vaši AI agenti čuju od kupaca putem službenog API-ja svake mreže, a svaka veza se prati 24/7. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, uz prvih 3 dana besplatnog probnog razdoblja.
Često postavljana pitanja
Kako poruke WhatsApp broja stižu do mog endpointa?
Na jedan od dva načina. Uz set_webhook_destination Meta isporučuje poruke izravno na vaš poslužitelj, a uz set_inbound_mode s forward_url easyCoexistence ih prosljeđuje potpisane s X-EC-Signature, uz ponavljanje pokušaja s postupnim produljivanjem razmaka.
Može li isti događaj stići dvaput?
Može, pa deduplicirajte prema ID-jevima mreže, poput ID-ja komentara ili message mid. Metina ponavljanja isporuke WhatsApp poruke koju vaš poslužitelj nije prihvatio, do 7 dana, također mogu donijeti duplikate.
Može li jedan endpoint primati događaje iz više računa?
Može. Svaki događaj nosi platform i account_id, pa jedan URL može služiti mnogim računima, pod uvjetom da provjerava svaki potpis tajnim ključem tog računa.
Koliko košta easyCoexistence za webhookove društvenih mreža?
Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, i jednaka je na svakoj mreži. Proslijeđivanje, MCP poslužitelj i Partner API uključeni su, uz prvih 3 dana besplatnog probnog razdoblja.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na