Messenger webhook za Facebook stranice: poruke i događaji spominjanja
Polje messages u Facebook webhookovima stranica okida se kada osoba pošalje stranici poruku na Messengeru i isporučuje niz messaging sa ID-jem pošiljaoca ograničenim na stranicu, ID-jem stranice, vremenskom oznakom i mid-om poruke sa tekstom ili prilozima. Polje mention prijavljuje nova spominjanja stranice u objavama i komentarima, a Meta oba potpisuje zaglavljem X-Hub-Signature-256.
easyCoexistence prosleđuje poruke i spominjanja Messengera svake povezane stranice na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem za tu stranicu i bez čuvanja kopije, a send_social_dm odgovara unutar 24-časovnog prozora.
Koliko brzo Meta traži od Messenger webhook endpointa da odgovori na svaku notifikaciju sa 200 OK.
Ako isporuke ne uspeju ovoliko dugo, Meta otkazuje pretplatu aplikacije na webhookove stranice dok se ponovo ne pretplati.
ID pošiljaoca ograničen na stranicu u događaju messages, jedinstven za svaki par osobe i stranice.
Kako Metina referenca označava polje sender kod događaja spominjanja.
Prošle webhook notifikacije se kasnije ne mogu upitati, pa primalac mora da sačuva ono što mu treba.
Šta šalje polje messages?
Notifikaciju kada osoba pošalje stranici Messenger poruku. Meta šalje tekstualne poruke ili poruke sa prilozima, koji mogu biti slike, audio, video, fajlovi ili nalepnice, između ostalih tipova, a podeljeni link može stići kao rezervni prilog. Odgovor na raniju poruku nosi reply_to sa mid-om te poruke, a brzi odgovor nosi svoj payload.
Kako izgleda događaj messages?
Za razliku od izmena u feedu, poruka stiže u nizu messaging unutar entry-ja stranice. Svaki događaj ima sender, ID pošiljaoca ograničen na stranicu; recipient, stranicu; timestamp; i message sa mid-om i text-om ili attachments sa type-om i payload URL-om:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1458692752478,
"messaging": [
{
"sender": { "id": "<PSID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1458692752478,
"message": {
"mid": "<MESSAGE_ID>",
"text": "hello, world!"
}
}
]
}
]
}Šta šalje polje mention?
Izmenu sa poljem mention kada se stranica spomene u objavi ili komentaru, sa post_id ili comment_id, porukom, eventualnim linkom, fotografijom ili videom, kao i item i verb. Meta upozorava da neke od tih ID-jeva objava i komentara ne mogu da se upitaju, zbog nedostatka dozvole ili privatnosti, a njena referenca označava polje sender samo za Workplace, pa spominjanje može stići bez autora.
Koja polja Messengera se ne prosleđuju?
easyCoexistence pretplaćuje stranice na messages, a ne na message_echoes, messaging_postbacks, message_reads ili message_deliveries, pa se poruke koje stranica šalje, klikovi na dugmad i potvrde čitanja ili isporuke ne prosleđuju. Odgovor poslat preko send_social_dm vraća sopstveni ID poruke.
Kako događaji stižu do vašeg endpointa?
Meta isporučuje webhookove stranica aplikaciji koju je stranica instalirala, preko jedne callback URL adrese za celu aplikaciju. easyCoexistence proverava Metin X-Hub-Signature-256 na svakoj isporuci, odmah odgovara Meti i prosleđuje svaki entry za povezanu stranicu na HTTPS endpoint koji ste za nju postavili, potpisan sopstvenim tajnim ključem te stranice. Postavite ga pomoću set_social_webhook_destination iz Claude-a ili ChatGPT-ja, ili pomoću PUT /channels/:id/webhook na Partner API-ju; tajni ključ se prikazuje jednom, ponovno postavljanje izdaje novi, a URL null isključuje prosleđivanje.
Kako izgleda prosleđeni događaj?
POST koji sadrži platform, account_id koji list_social_accounts daje vezi stranice, ID stranice kao external_id i entry: Metin entry za stranicu, nepromenjen. sender.id je recipient_id koji send_social_dm uzima za odgovor unutar 24-časovnog prozora:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400000,
"messaging": [
{
"sender": { "id": "<PSID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399000,
"message": { "mid": "<MESSAGE_ID>", "text": "<MESSAGE_TEXT>" }
}
]
}
}Kako proveriti prosleđeni događaj?
Svaki prosleđeni POST nosi zaglavlje X-EC-Signature u obliku t=<unix>,v1=<hex>, gde je v1 HMAC-SHA256 vremenske oznake, tačke i sirovog tela, ključem tajnog potpisa stranice. Izračunajte ga nad telom tačno onako kako je primljeno, uporedite u konstantnom vremenu i odbacite vremensku oznaku stariju od 5 minuta.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}Da li se isporuka ponavlja?
Ne, easyCoexistence ne ponavlja. Svaki entry se prosleđuje jednom, u memoriji, bez kopije iz koje bi se ponovo pokušalo; prosleđivanje čeka odgovor 8 sekundi, ne prati preusmeravanja i ide samo na HTTPS adresu koja se razrešava u javnu IP adresu. Meta napominje da prošle notifikacije ne mogu da se upituju kasnije, pa sačuvajte ono što vam treba čim stigne. Uzvodno, Meta u nekoliko navrata odmah ponavlja neuspelu isporuku, pa ista poruka ponekad može da vam stigne dvaput: deduplikujte je po njenom mid-u.
Česte greške
- Posao pre odgovora. Prosleđivanje se ne ponavlja, zato odmah vratite 2xx, a događaj obradite kasnije.
- Provera potpisa na parsiranom JSON-u. HMAC izračunajte nad sirovim telom tačno onako kako je stiglo.
- Pretpostavka da poruka uvek ima tekst. Nalepnica, slika ili podeljeni link stižu kao attachments, bez polja text.
- Preskakanje deduplikacije. Meta može da isporuči događaj ponovo posle neuspeha, pa ključ postavite na mid poruke pre nego što nešto preduzmete.
Uključite prosleđivanje pomoću set_social_webhook_destination ili Partner API-ja. US$ 9 do US$ 0,75 po vezi mesečno, sa smanjenjem kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Na koja webhook polja easyCoexistence pretplaćuje stranicu?
messages za Messenger i mention za spominjanja, uz feed za objave i komentare stranice.
Da li Messenger nalepnica ili slika dolazi sa tekstom?
Ne. Nalepnica, slika ili podeljeni link stiže u attachments, svaki sa type-om i payload URL-om, a poruka ne sadrži polje text.
Koliko brzo Messenger webhook endpoint mora da odgovori?
Sa 200 OK u roku od 5 sekundi. Posle 1 sata neuspešnih isporuka, Meta otkazuje pretplatu aplikacije na webhookove stranice.
Kako da odgovorim na prosleđenu poruku?
Pozovite send_social_dm sa sender.id iz događaja kao recipient_id, u roku od 24 sata od poruke te osobe.
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