Webhook ya Facebook: ujumbe wa Messenger na matukio ya kutajwa
Sehemu ya messages katika webhook za Kurasa za Facebook hutoa arifa mtu anapotuma Ukurasa ujumbe wa Messenger, ikileta safu ya messaging yenye kitambulisho cha mtumaji kilicho mahususi kwa Ukurasa, kitambulisho cha Ukurasa, muda, na mid ya ujumbe pamoja na maandishi au viambatisho vyake. Sehemu ya mention huripoti kutajwa vipya kwa Ukurasa katika machapisho na maoni, na Meta husaini zote mbili kwa X-Hub-Signature-256.
easyCoexistence husambaza ujumbe na kutajwa vya Messenger vya kila Ukurasa uliounganishwa kwenye endpoint yako ya HTTPS kadri vinavyofika, vikiwa vimesainiwa kwa siri ya Ukurasa huo bila nakala inayohifadhiwa, na send_social_dm hujibu ndani ya dirisha la saa 24.
Muda ambao Meta inataka endpoint ya webhook ya Messenger ijibu kila arifa kwa 200 OK.
Baada ya uwasilishaji kushindwa kwa muda huu, Meta huiondoa programu kwenye webhook za Ukurasa hadi ijiandikishe tena.
Kitambulisho cha mtumaji kilicho mahususi kwa Ukurasa katika tukio la messages, cha kipekee kwa kila jozi ya mtu na Ukurasa.
Jinsi rejeleo la Meta linavyoweka alama kwenye sehemu ya sender ya tukio la mention.
Arifa za webhook zilizopita haziwezi kuulizwa baadaye, kwa hiyo mpokeaji lazima ahifadhi anachohitaji.
Sehemu ya messages inatuma nini?
Arifa mtu anapotuma Ukurasa ujumbe wa Messenger. Meta hutuma ujumbe wa maandishi au ujumbe wenye viambatisho, ambavyo vinaweza kuwa picha, sauti, video, faili au stika miongoni mwa aina nyingine, na kiungo kilichoshirikiwa kinaweza kufika kama kiambatisho mbadala. Jibu kwa ujumbe wa awali hubeba reply_to yenye mid ya ujumbe huo, na jibu la haraka hubeba payload yake.
Tukio la messages linaonekanaje?
Tofauti na mabadiliko ya feed, ujumbe unafika ndani ya safu ya messaging iliyo ndani ya entry ya Ukurasa. Kila tukio lina sender, yaani kitambulisho cha mtu kilicho mahususi kwa Ukurasa; recipient, yaani Ukurasa; timestamp; na message, pamoja na mid yake na maandishi, au attachments zenye type na 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!"
}
}
]
}
]
}Sehemu ya mention inatuma nini?
Mabadiliko yenye field mention Ukurasa unapotajwa kwenye chapisho au maoni, yakibeba post_id au comment_id, ujumbe, kiungo chochote, picha au video, pamoja na item na verb. Meta inaonya kuwa baadhi ya vitambulisho hivyo vya chapisho na maoni haviwezi kuulizwa, kwa sababu ya ukosefu wa ruhusa au faragha, na rejeleo lake linaweka sehemu ya sender kwa Workplace pekee, kwa hiyo kutajwa kunaweza kufika bila mwandishi wake.
Ni sehemu gani za Messenger hazisambazwi?
easyCoexistence huandikisha Kurasa kwa messages pekee, si kwa message_echoes, messaging_postbacks, message_reads wala message_deliveries, kwa hiyo ujumbe ambao Ukurasa unautuma, mibofyo ya vitufe, na risiti za kusomwa au kufikishwa hazisambazwi. Jibu linalotumwa kwa send_social_dm hurudisha kitambulisho chake cha ujumbe badala yake.
Matukio yanafikaje kwenye endpoint yako?
Meta huwasilisha webhook za Ukurasa kwenye programu ambayo Ukurasa uliisakinisha, kupitia URL moja ya callback kwa programu nzima. easyCoexistence hukagua X-Hub-Signature-256 ya Meta kwenye kila uwasilishaji, hujibu Meta mara moja, na husambaza kila entry ya Ukurasa uliounganishwa kwenye endpoint ya HTTPS uliyoweka kwa ajili yake, iliyosainiwa kwa siri ya Ukurasa huo. Iweke kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa PUT /channels/:id/webhook kwenye Partner API; siri huonyeshwa mara moja, kuiweka tena hutoa siri mpya, na URL ya null huzima usambazaji.
Tukio lililosambazwa linaonekanaje?
POST inayobeba platform, account_id ambayo list_social_accounts hutoa kwa muunganisho wa Ukurasa, kitambulisho cha Ukurasa kama external_id, na entry: entry ya Meta ya Ukurasa, bila mabadiliko. sender.id ndiyo recipient_id ambayo send_social_dm inachukua kwa jibu ndani ya dirisha la saa 24:
{
"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>" }
}
]
}
}Unahakikishaje tukio lililosambazwa?
Kila POST iliyosambazwa hubeba kichwa X-EC-Signature chenye umbo t=<unix>,v1=<hex>, ambapo v1 ni HMAC-SHA256 ya timestamp, nukta, na mwili ghafi, ukitumia siri ya kusaini ya Ukurasa. Hesabu juu ya mwili kama ulivyopokelewa kabisa, linganisha kwa njia ya muda usiobadilika, na ukatae timestamp ya zaidi ya dakika 5.
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));
}Je, uwasilishaji unajaribiwa tena?
Si na easyCoexistence. Kila entry inasambazwa mara moja, kwenye kumbukumbu, bila nakala ya kujaribu tena; usambazaji unasubiri jibu kwa sekunde 8, haufuati uelekezaji upya, na huenda tu kwenye anwani ya HTTPS inayoelekea IP ya umma. Meta inabainisha kuwa arifa zilizopita haziwezi kuulizwa baadaye, kwa hiyo hifadhi unachohitaji unapofika. Kwa upande wa Meta, uwasilishaji ulioshindwa hujaribiwa tena mara kadhaa kwa mkupuo, kwa hiyo ujumbe uleule unaweza mara chache kukufikia mara mbili: ondoa marudio kwa kutumia mid yake.
Makosa ya kawaida
- Kufanya kazi kabla ya kujibu. Usambazaji hauwezi kujaribiwa tena, kwa hiyo rudisha 2xx mara moja na uchakate tukio baadaye.
- Kuthibitisha saini kwenye JSON iliyochanganuliwa. Hesabu HMAC juu ya mwili ghafi kama ulivyofika.
- Kudhani kuwa ujumbe daima una maandishi. Stika, picha au kiungo kilichoshirikiwa hufika kama attachments, bila sehemu ya text.
- Kuruka kuondoa marudio. Meta inaweza kuwasilisha tukio tena baada ya kushindwa, kwa hiyo tumia mid ya ujumbe kama ufunguo kabla ya kuchukua hatua.
Washa usambazaji kwa set_social_webhook_destination au Partner API. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kinapungua unapoongeza muunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Ni sehemu gani za webhook easyCoexistence huandikisha Ukurasa?
messages kwa Messenger na mention kwa kutajwa, pamoja na feed kwa machapisho na maoni ya Ukurasa.
Je, stika au picha ya Messenger huja na maandishi?
Hapana. Stika, picha au kiungo kilichoshirikiwa hufika kwenye attachments, kila moja ikiwa na type na payload URL, na ujumbe hauna sehemu ya text.
Endpoint ya webhook ya Messenger inapaswa kujibu kwa haraka kiasi gani?
Kwa 200 OK ndani ya sekunde 5. Baada ya saa 1 ya uwasilishaji ulioshindwa, Meta huiondoa programu kwenye webhook za Ukurasa.
Ninajibuje ujumbe uliosambazwa?
Piga send_social_dm na sender.id kutoka kwenye tukio kama recipient_id, ndani ya saa 24 tangu mtu alipotuma ujumbe wake.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye