Facebook Page-களுக்கான Messenger வெப்ஹூக்: செய்திகளும் மென்ஷன் நிகழ்வுகளும்
Facebook Page வெப்ஹூக்கின் messages புலம், ஒருவர் Page-க்கு Messenger செய்தி அனுப்பும்போது இயங்குகிறது; அது அனுப்புநரின் Page-சார்ந்த ID, Page-இன் ID, நேர முத்திரை, செய்தியின் mid, உரை அல்லது இணைப்புகளுடன் ஒரு messaging வரிசையை அனுப்புகிறது. mention புலம் பதிவுகளிலும் கருத்துகளிலும் Page-ஐ குறிப்பிடும் புதிய மென்ஷன்களைத் தெரிவிக்கிறது. Meta இவை இரண்டையும் X-Hub-Signature-256 மூலம் கையொப்பமிடுகிறது.
easyCoexistence ஒவ்வொரு இணைக்கப்பட்ட Page-இன் Messenger செய்திகளையும் மென்ஷன்களையும் வரும்போதே உங்கள் HTTPS எண்ட்பாயிண்டுக்கு அனுப்புகிறது; அவை அந்த Page-க்கான secret-உடன் கையொப்பமிடப்பட்டவை, எந்த நகலும் வைக்கப்படுவதில்லை.
Messenger வெப்ஹூக் எண்ட்பாயிண்ட் ஒவ்வொரு அறிவிப்புக்கும் 200 OK-உடன் எவ்வளவு விரைவில் பதில் அளிக்க வேண்டும் என்று Meta கேட்கிறது.
இவ்வளவு நேரம் டெலிவரிகள் தோல்வியடைந்த பிறகு, மீண்டும் பதிவு செய்யும் வரை Meta செயலியை Page-இன் வெப்ஹூக்குகளிலிருந்து நீக்குகிறது.
messages நிகழ்வில் அனுப்புநரின் Page-சார்ந்த ID, ஒவ்வொரு நபர் மற்றும் Page இணைக்கும் ஜோடிக்கும் தனித்துவமானது.
Meta-வின் குறிப்பு மென்ஷன் நிகழ்வின் sender புலத்தை எவ்வாறு குறிக்கிறது.
கடந்த வெப்ஹூக் அறிவிப்புகளை பின்னர் வினவ முடியாது; எனவே பெறுநர் தனக்குத் தேவையானதைச் சேமிக்க வேண்டும்.
messages புலம் எதை அனுப்புகிறது?
ஒருவர் Page-க்கு Messenger செய்தி அனுப்பும்போது ஒரு அறிவிப்பு. Meta உரைச் செய்திகளையோ இணைப்புகளுடன் கூடிய செய்திகளையோ அனுப்புகிறது; இணைப்புகள் படங்கள், ஆடியோ, வீடியோ, கோப்புகள் அல்லது ஸ்டிக்கர்கள் போன்ற பிற வகைகளாக இருக்கலாம். பகிரப்பட்ட இணைப்பு ஃபால்பேக் இணைப்பாக வரலாம். முந்தைய செய்திக்கான பதில், அந்தச் செய்தியின் mid-உடன் reply_to-ஐக் கொண்டிருக்கும்; விரைவு பதில் அதன் பேலோட்டைக் கொண்டிருக்கும்.
messages நிகழ்வு எப்படித் தெரிகிறது?
feed மாற்றங்களைப் போலன்றி, செய்தி Page-இன் entry-க்குள் உள்ள messaging வரிசையில் வருகிறது. ஒவ்வொரு நிகழ்விலும் sender உள்ளது, அது நபரின் Page-சார்ந்த ID; recipient, அது Page; ஒரு timestamp; மற்றும் message, அதன் mid மற்றும் text உடன், அல்லது type மற்றும் பேலோட் 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 புலம் எதை அனுப்புகிறது?
Page ஒரு பதிவிலோ கருத்திலோ மென்ஷன் செய்யப்படும்போது, field mention கொண்ட ஒரு மாற்றம் வருகிறது; அதில் post_id அல்லது comment_id, செய்தி, ஏதேனும் இணைப்பு, புகைப்படம் அல்லது வீடியோ, மேலும் item மற்றும் verb இருக்கும். சில பதிவு மற்றும் கருத்து ID-களை, அனுமதி இல்லாமை அல்லது தனியுரிமைக் காரணங்களால் வினவ முடியாது என Meta எச்சரிக்கிறது. அதன் குறிப்பு sender புலத்தை Workplace-க்கு மட்டுமே எனக் குறிக்கிறது; எனவே மென்ஷன் அதன் ஆசிரியர் இல்லாமல் வரலாம்.
எந்த Messenger புலங்கள் அனுப்பப்படுவதில்லை?
easyCoexistence Page-களை messages-க்கு மட்டுமே சந்தா செய்கிறது; message_echoes, messaging_postbacks, message_reads அல்லது message_deliveries-க்கு அல்ல. எனவே Page அனுப்பும் செய்திகள், பொத்தான் தட்டல்கள், படிக்கப்பட்ட அல்லது டெலிவரி ரசீதுகள் அனுப்பப்படுவதில்லை. send_social_dm மூலம் அனுப்பப்படும் பதில் அதற்குப் பதிலாக அதன் சொந்த message ID-ஐத் திருப்பித் தரும்.
நிகழ்வுகள் உங்கள் எண்ட்பாயிண்டை எப்படி அடைகின்றன?
Meta Page வெப்ஹூக்குகளை, Page நிறுவிய செயலிக்கு அனுப்புகிறது; முழு செயலிக்கும் ஒரே callback URL வழியாக. easyCoexistence ஒவ்வொரு டெலிவரியிலும் Meta-வின் X-Hub-Signature-256-ஐச் சரிபார்க்கிறது, உடனடியாக Meta-வுக்குப் பதில் அளிக்கிறது, இணைக்கப்பட்ட Page-இன் ஒவ்வொரு entry-யையும் நீங்கள் அதற்கென அமைத்த HTTPS எண்ட்பாயிண்டுக்கு அனுப்புகிறது; அது அந்தப் Page-இன் சொந்த secret-உடன் கையொப்பமிடப்படுகிறது. இதை Claude அல்லது ChatGPT-இலிருந்து set_social_webhook_destination மூலமாகவோ, அல்லது Partner API-இல் PUT /channels/:id/webhook மூலமாகவோ அமைக்கலாம். secret ஒரு முறை மட்டுமே காட்டப்படும்; மீண்டும் அமைத்தால் புதியது வழங்கப்படும்; URL null எனில் அனுப்புதல் நிறுத்தப்படும்.
அனுப்பப்பட்ட நிகழ்வு எப்படித் தெரிகிறது?
பெறப்படும் POST-இல் platform, list_social_accounts Page-இன் இணைப்புக்குத் தரும் account_id, Page-இன் ID external_id ஆக, மற்றும் entry (Page-க்கான Meta-வின் entry, மாறாமல்) இருக்கும். sender.id என்பது 24 மணி நேர சாளரத்திற்குள் பதில் அளிக்க 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>" }
}
]
}
}அனுப்பப்பட்ட நிகழ்வை எப்படிச் சரிபார்ப்பது?
அனுப்பப்பட்ட ஒவ்வொரு POST-உம் X-EC-Signature தலைப்பைக் கொண்டிருக்கும்; வடிவம் t=<unix>,v1=<hex>. இங்கு v1 என்பது நேர முத்திரை, ஒரு புள்ளி, மூல body ஆகியவற்றின் HMAC-SHA256; இது Page-இன் signing secret-ஐ விசையாகக் கொண்டு கணக்கிடப்படுகிறது. body-ஐ பெற்றபடியே மூல வடிவில் கணக்கிட்டு, நிலையான நேரத்தில் ஒப்பிட்டு, 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));
}டெலிவரி மீண்டும் முயற்சிக்கப்படுமா?
easyCoexistence மீண்டும் முயற்சிப்பதில்லை. ஒவ்வொரு entry-யும் ஒரு முறை நினைவகத்தில் அனுப்பப்படுகிறது; மீண்டும் முயற்சிக்க எந்த நகலும் வைக்கப்படுவதில்லை. அனுப்புதல் பதிலுக்காக 8 வினாடிகள் காத்திருக்கும், redirect-களைப் பின்பற்றாது, பொது IP-க்கு தீர்க்கப்படும் HTTPS முகவரிக்கு மட்டுமே செல்லும். கடந்த அறிவிப்புகளை பின்னர் வினவ முடியாது என Meta குறிப்பிடுகிறது; எனவே வரும்போதே தேவையானவற்றைச் சேமிக்கவும். மேல்நிலையில், தோல்வியுற்ற டெலிவரியை Meta சில முறை உடனடியாக மீண்டும் முயற்சிக்கிறது; எனவே அதே செய்தி அரிதாக இரண்டு முறை வரலாம்: அதன் mid-ஐ வைத்து நகல்களை நீக்கவும்.
பொதுவான தவறுகள்
- பதில் அளிப்பதற்கு முன் வேலை செய்வது. அனுப்புதல் மீண்டும் முயற்சிக்காது; எனவே உடனே 2xx திருப்பி அனுப்பி, நிகழ்வை பின்னர் செயலாக்கவும்.
- பகுக்கப்பட்ட JSON-இல் கையொப்பத்தைச் சரிபார்ப்பது. HMAC-ஐ வந்தபடியே மூல body மீது கணக்கிடவும்.
- செய்திக்கு எப்போதும் உரை இருக்கும் என்று கருதுவது. ஸ்டிக்கர், படம் அல்லது பகிரப்பட்ட இணைப்பு attachments-ஆக வரும், text புலம் இல்லாமல்.
- நகல் நீக்கலைத் தவிர்ப்பது. தோல்விக்குப் பிறகு Meta ஒரு நிகழ்வை மீண்டும் அனுப்பலாம்; எனவே செயல்படுவதற்கு முன் message mid-ஐ வைத்து சரிபார்க்கவும்.
send_social_dm 24 மணி நேர சாளரத்திற்குள் பதில் அனுப்புகிறது. set_social_webhook_destination அல்லது Partner API மூலம் அனுப்புதலை இயக்கவும். ஒரு இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகள் கூடும்போது குறைகிறது; முதல் 7 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
easyCoexistence Page-ஐ எந்த வெப்ஹூக் புலங்களுக்குச் சந்தா செய்கிறது?
Messenger-க்கு messages, மென்ஷன்களுக்கு mention; Page-இன் பதிவுகளுக்கும் கருத்துகளுக்கும் feed-உடன் சேர்த்து.
Messenger ஸ்டிக்கர் அல்லது படம் உரையுடன் வருமா?
இல்லை. ஸ்டிக்கர், படம் அல்லது பகிரப்பட்ட இணைப்பு attachments-இல் வரும்; ஒவ்வொன்றுக்கும் type மற்றும் பேலோட் URL இருக்கும், செய்தியில் text புலம் இருக்காது.
Messenger வெப்ஹூக் எண்ட்பாயிண்ட் எவ்வளவு விரைவாகப் பதில் அளிக்க வேண்டும்?
5 வினாடிகளுக்குள் 200 OK. ஒரு மணி நேரம் டெலிவரிகள் தோல்வியடைந்தால், Meta செயலியை Page-இன் வெப்ஹூக்குகளிலிருந்து சந்தா நீக்குகிறது.
அனுப்பப்பட்ட செய்திக்கு எப்படிப் பதில் அளிப்பது?
நிகழ்விலுள்ள sender.id-ஐ recipient_id-ஆக வைத்து send_social_dm அழைக்கவும்; நபரின் செய்திக்கு 24 மணி நேரத்திற்குள்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: