Messenger webhook para sa Facebook Pages: mga mensahe at mention events
Ipinapadala ng messages field ng webhook ng Facebook Page ang notification kapag may taong nagpadala ng Messenger na mensahe sa Page, na may messaging array na naglalaman ng Page-scoped ID ng sender, ID ng Page, timestamp, at mid ng mensahe kasama ang text o attachments nito. Iniuulat ng mention field ang mga bagong mention ng Page sa mga post at comment, at pinipirmahan ng Meta ang dalawa gamit ang X-Hub-Signature-256.
Ipinapasa ng easyCoexistence ang mga mensahe at mention sa Messenger ng bawat konektadong Page sa inyong HTTPS endpoint habang dumarating, pinipirmahan gamit ang secret para sa Page na iyon at walang kopyang itinatago, at ang send_social_dm ay sumasagot sa loob ng 24-oras na window.
Gaano kabilis hinihingi ng Meta na sumagot ang Messenger webhook endpoint ng 200 OK sa bawat notification.
Matapos mabigo ang mga delivery nang ganito katagal, ina-unsubscribe ng Meta ang app sa webhook ng Page hanggang muli itong mag-subscribe.
Ang Page-scoped ID ng sender sa messages event ay natatangi para sa bawat pares ng tao at Page.
Paano minamarkahan ng reference ng Meta ang sender field ng mention event.
Hindi na maaaring i-query ang mga lumang webhook notification, kaya kailangang i-store ng receiver ang kailangan nito.
Ano ang ipinapadala ng messages field?
Isang notification kapag may taong nagpadala ng Messenger na mensahe sa Page. Nagpapadala ang Meta ng text na mensahe o mensaheng may attachment, na maaaring larawan, audio, video, file o sticker, at iba pang uri, at maaaring dumating ang shared link bilang fallback na attachment. Ang reply sa naunang mensahe ay may reply_to na may mid ng mensaheng iyon, at ang quick reply naman ay may payload nito.
Ano ang itsura ng messages event?
Hindi tulad ng feed changes, dumarating ang mensahe sa messaging array sa loob ng entry ng Page. Bawat event ay may sender, ang Page-scoped ID ng tao; recipient, ang Page; timestamp; at message, na may mid at text, o attachments na may type at payload URL:
{
"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!"
}
}
]
}
]
}Ano ang ipinapadala ng mention field?
Isang change na may field mention kapag na-mention ang Page sa post o comment, na may dalang post_id o comment_id, ang mensahe, anumang link, larawan o video, at item at verb. Binabalaan ng Meta na may ilang post at comment ID na hindi maaaring i-query, dahil sa kakulangan ng permission o dahil sa privacy, at minamarkahan ng reference nito ang sender field bilang Workplace lang, kaya maaaring dumating ang mention nang walang author nito.
Aling mga Messenger field ang hindi ipinapasa?
Naka-subscribe ang mga Page ng easyCoexistence sa messages, hindi sa message_echoes, messaging_postbacks, message_reads o message_deliveries, kaya hindi ipinapasa ang mga mensaheng ipinapadala ng Page, mga pindot sa button, at mga resibo ng pagbasa o delivery. Ang reply na ipinadala gamit ang send_social_dm ay nagbabalik ng sarili nitong ID ng mensahe sa halip.
Paano nakakarating ang events sa endpoint ninyo?
Ibinibigay ng Meta ang mga Page webhook sa app na in-install ng Page, sa pamamagitan ng iisang callback URL para sa buong app. Tinitingnan ng easyCoexistence ang X-Hub-Signature-256 ng Meta sa bawat delivery, agad na sumasagot sa Meta, at ipinapasa ang bawat entry ng konektadong Page sa HTTPS endpoint na itinakda ninyo para dito, na pinirmahan gamit ang sarili nitong secret ng Page. Itakda ito gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang PUT /channels/:id/webhook sa Partner API. Ipinapakita ang secret nang isang beses, ang muling pagtatakda nito ay naglalabas ng bago, at ang null na URL ay nagpapatay ng pagpapasa.
Ano ang itsura ng ipinasang event?
Isang POST na may platform, ang account_id na ibinibigay ng list_social_accounts para sa koneksyon ng Page, ang ID ng Page bilang external_id, at entry: ang entry ng Meta para sa Page, hindi binago. Ang sender.id ay ang recipient_id na kinukuha ng send_social_dm para sa reply sa loob ng 24-oras na window:
{
"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>" }
}
]
}
}Paano i-verify ang ipinasang event?
Bawat ipinasang POST ay may X-EC-Signature header sa anyong t=<unix>,v1=<hex>, kung saan ang v1 ay HMAC-SHA256 ng timestamp, tuldok, at raw body, na naka-key sa signing secret ng Page. I-compute ito sa body nang eksakto kung paano ito natanggap, ihambing sa constant time, at tanggihan ang timestamp na mahigit 5 minuto ang edad.
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));
}Inuulit ba ang delivery?
Hindi. Bawat entry ay ipinapasa nang isang beses, nasa memory lang, nang walang kopyang maaaring ulitin. Naghihintay ang forward ng 8 segundo para sa sagot, hindi sumusunod sa redirect, at sa HTTPS address lamang na nagre-resolve sa public IP ang napupunta. Sinasabi ng Meta na hindi na maaaring i-query ang mga lumang notification, kaya i-store ang kailangan ninyo habang dumarating. Sa panig ng Meta, inuulit ang nabigong delivery nang ilang beses agad, kaya maaaring dalawang beses kayong makatanggap ng iisang mensahe: i-deduplicate ito gamit ang mid nito.
Mga karaniwang pagkakamali
- Paggawa muna bago sumagot. Walang retry ang forwarding, kaya agad magbalik ng 2xx at iproseso ang event pagkatapos.
- Pag-verify ng signature sa parsed JSON. I-compute ang HMAC sa raw body nang eksakto kung paano ito dumating.
- Pag-aakalang laging may text ang mensahe. Ang sticker, larawan o shared link ay dumarating bilang attachments, nang walang text field.
- Paglaktaw sa deduplication. Maaaring ipadala ulit ng Meta ang event pagkatapos ng failure, kaya i-key sa mid ng mensahe bago kumilos.
I-on ang pagpapasa gamit ang set_social_webhook_destination o ang Partner API. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.
Mga madalas itanong
Aling webhook field ang ina-subscribe ng easyCoexistence sa isang Page?
messages para sa Messenger at mention para sa mga mention, kasama ng feed para sa mga post at comment ng Page.
May text ba ang sticker o larawan sa Messenger?
Wala. Ang sticker, larawan o shared link ay dumarating sa attachments, bawat isa ay may type at payload URL, at walang text field ang mensahe.
Gaano kabilis dapat sumagot ang Messenger webhook endpoint?
Dapat sumagot ng 200 OK sa loob ng 5 segundo. Matapos ang 1 oras ng nabigong delivery, ina-unsubscribe ng Meta ang app sa webhook ng Page.
Paano ako sasagot sa ipinasang mensahe?
Tawagin ang send_social_dm gamit ang sender.id mula sa event bilang recipient_id, sa loob ng 24 na oras mula nang magpadala ang tao ng mensahe.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong