Facebook Page සඳහා Messenger webhook: පණිවිඩ සහ mention සිදුවීම්
Facebook Page හි messages field එක මගින්, පුද්ගලයෙකු Page එකට Messenger පණිවිඩයක් යවන විට සිදුවීමක් යවයි. එය sender ගේ Page-scoped ID, Page ID, timestamp සහ පණිවිඩයේ mid, එහි text හෝ attachments සමඟ messaging array එකක් ලබා දෙයි. mention field එක Page එක posts සහ comments වල සඳහන් වූ නව mentions වාර්තා කරයි. Meta දෙකම X-Hub-Signature-256 සමඟ අත්සන් කරයි.
easyCoexistence සෑම සම්බන්ධ Page එකකම Messenger පණිවිඩ සහ mentions ලැබෙන විටම ඔබේ HTTPS endpoint එකට forward කරයි, එම Page සඳහා secret එකකින් අත්සන් කර, කිසිදු copy එකක් තබා නොගෙන.
Messenger webhook endpoint එකක් සෑම දැනුම්දීමකටම 200 OK සමඟ පිළිතුරු දිය යුතු කාලය.
මෙම කාලය තුළ deliveries අසාර්ථක වූ පසු, Meta නැවත subscribe වන තෙක් app එක Page හි webhooks වලින් unsubscribe කරයි.
messages event එකක sender ගේ Page-scoped ID, එක් එක් පුද්ගලයා සහ Page යුගලය සඳහා අද්විතීය වේ.
Meta සඳහනේ යොමුව mention event එකේ sender field එක සලකුණු කරන ආකාරය.
අතීත webhook දැනුම්දීම් පසුව query කළ නොහැකි බැවින්, receiver එක අවශ්ය දත්ත ගබඩා කළ යුතුය.
messages field එක කුමක් යවයි?
පුද්ගලයෙකු Page එකට Messenger පණිවිඩයක් යවන විට දැනුම්දීමක් Meta යවයි. එය text පණිවිඩ හෝ attachments සහිත පණිවිඩ යවයි; attachments රූප, audio, video, ගොනු හෝ sticker ඇතුළු වර්ග විය හැක. බෙදාගත් link එකක් fallback attachment එකක් ලෙස ළඟා විය හැක. කලින් පණිවිඩයකට පිළිතුරක් reply_to එකේ එම පණිවිඩයේ mid රැගෙන යයි, quick reply එකක් එහි payload එක රැගෙන යයි.
messages event එකක් කෙසේ පෙනේද?
feed වෙනස්කම් මෙන් නොව, පණිවිඩය Page හි entry තුළ messaging array එකක් තුළ ළඟා වේ. සෑම event එකකම sender, එනම් පුද්ගලයාගේ Page-scoped ID; recipient, එනම් Page එක; timestamp; සහ message, එහි mid සහ text, හෝ type සහ payload URL සහිත attachments ඇත:
{
"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!"
}
}
]
}
]
}mention field එක කුමක් යවයි?
Page එක post එකක හෝ comment එකක mention කළ විට mention field සහිත change එකක් යවයි, එහි post_id හෝ comment_id, message, ඕනෑම link, photo හෝ video, සහ item සහ verb ඇත. සමහර post සහ comment IDs query කළ නොහැකි බව Meta අනතුරු ඇඟවීමක් කරයි, අවසරය නැති නිසා හෝ පෞද්ගලිකත්වය නිසා. එහි යොමුව sender field එක Workplace සඳහා පමණක් ලෙස සලකුණු කරන බැවින්, mention එක එහි කතුවරයා නොමැතිව ළඟා විය හැක.
Messenger fields මොනවා forward නොකරයිද?
easyCoexistence Pages subscribe කරන්නේ messages වලට පමණි, message_echoes, messaging_postbacks, message_reads හෝ message_deliveries වලට නොවේ. ඒ නිසා Page එක යවන පණිවිඩ, button ඔබීම් සහ read හෝ delivery receipts forward නොකෙරේ. send_social_dm සමඟ යවන පිළිතුරක් ඒ වෙනුවට තමන්ගේම message ID එක ලබා දෙයි.
events ඔබේ endpoint එකට ළඟා වන්නේ කෙසේද?
Meta Page webhooks, Page ස්ථාපනය කළ app එකට, app සඳහා එක් callback URL එකක් හරහා delivery කරයි. easyCoexistence සෑම delivery එකකම Meta හි X-Hub-Signature-256 පරීක්ෂා කරයි, Meta ට වහාම පිළිතුරු දෙයි, සහ සම්බන්ධ Page එකක සෑම entry එකක්ම ඔබ එම Page සඳහා සකසූ HTTPS endpoint එකට forward කරයි, එම Page ටම අයත් secret එකෙන් අත්සන් කර. set_social_webhook_destination මගින් Claude හෝ ChatGPT වලින්, හෝ Partner API හි PUT /channels/:id/webhook මගින් සකසන්න. secret එක එක් වරක් පමණක් පෙන්වයි, නැවත සැකසීමෙන් නව එකක් නිකුත් වේ, සහ null URL එකකින් forwarding නවතී.
forward කළ event එක කෙසේ පෙනේද?
platform, list_social_accounts ලබා දෙන Page හි connection එකේ account_id, Page ID එක external_id ලෙස, සහ entry: Page සඳහා Meta හි entry එක, වෙනස් නොකර ඇති POST එකකි. sender.id යනු 24-hour window තුළ පිළිතුරක් සඳහා send_social_dm ගන්නා recipient_id ය:
{
"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>" }
}
]
}
}forward කළ event එකක් කෙසේ verify කරන්නේද?
forward කළ සෑම POST එකකම X-EC-Signature header එකක් ඇත, t=<unix>,v1=<hex> ආකාරයෙන්. මෙහි v1 යනු timestamp, dot සහ raw body හි HMAC-SHA256 වන අතර, Page හි signing secret එකෙන් key කර ඇත. body එක ලැබුණු ආකාරයටම raw body මත compute කර, constant time තුළ compare කර, විනාඩි 5 කට වඩා පැරණි timestamp එකක් ප්රතික්ෂේප කරන්න.
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));
}delivery නැවත උත්සාහ කරනවාද?
easyCoexistence මගින් නැත. සෑම entry එකක්ම එක් වරක් memory තුළ forward කරයි, retry කිරීමට copy එකක් තබා නොගෙන. forward තත්පර 8ක් පිළිතුරක් බලා සිටී, redirects follow නොකරයි, සහ public IP එකට resolve වන HTTPS ලිපිනයට පමණක් යයි. අතීත දැනුම්දීම් පසුව query කළ නොහැකි බව Meta සටහන් කරයි, එබැවින් ලැබෙන විටම අවශ්ය දේ ගබඩා කරන්න. Meta අසාර්ථක delivery එකක් කිහිප වරක් එකවර retry කරයි, එබැවින් එකම පණිවිඩය සමහර විට දෙවරක් ළඟා විය හැක: එය mid මත deduplicate කරන්න.
සාමාන්ය වැරදි
- පිළිතුරු දීමට පෙර වැඩ කිරීම. forwarding retry නොකරයි, එබැවින් වහාම 2xx ලබා දී event එක පසුව සකසන්න.
- parsed JSON මත signature verify කිරීම. HMAC එක ලැබුණු ආකාරයටම raw body මත compute කරන්න.
- පණිවිඩයට සෑම විටම text ඇතැයි උපකල්පනය. sticker, රූපයක් හෝ බෙදාගත් link එකක් attachments ලෙස ළඟා වන අතර text field එකක් නැත.
- deduplication මඟ හැරීම. Meta අසාර්ථක වීමකින් පසු event එකක් නැවත ලබා දිය හැක, එබැවින් ක්රියා කිරීමට පෙර පණිවිඩයේ mid මත key කරන්න.
send_social_dm 24-hour window තුළ පිළිතුරු යවයි. set_social_webhook_destination හෝ Partner API මගින් forwarding ක්රියාත්මක කරන්න. මාසයකට connection එකකට US$ 9 සිට US$ 0.75 දක්වා, connection එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
easyCoexistence Page එකක් subscribe කරන webhook fields මොනවාද?
Messenger සඳහා messages සහ mentions සඳහා mention, Page හි posts සහ comments සඳහා feed සමඟ.
Messenger sticker හෝ රූපයක් text සමඟ ළඟා වේද?
නැත. sticker, රූපයක් හෝ බෙදාගත් link එකක් attachments තුළ ළඟා වන අතර, එක් එක් එහි type සහ payload URL එක සහිතව. පණිවිඩයේ text field එකක් නැත.
Messenger webhook endpoint එකක් කොපමණ වේගයෙන් පිළිතුරු දිය යුතුද?
තත්පර 5ක් ඇතුළත 200 OK ලබා දිය යුතුය. අසාර්ථක deliveries පැය 1ක් ගතවීමෙන් පසු, Meta app එක Page හි webhooks වලින් unsubscribe කරයි.
forward කළ පණිවිඩයකට පිළිතුරු දෙන්නේ කෙසේද?
පුද්ගලයාගේ පණිවිඩයෙන් පැය 24ක් ඇතුළත, event එකේ sender.id recipient_id ලෙස ගෙන send_social_dm කැඳවන්න.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ