Facebook Page साठी Messenger वेबहुक: मेसेज आणि मेन्शन इव्हेंट
Facebook च्या Page वेबहुक्समधील messages फील्ड तेव्हा सक्रिय होते जेव्हा एखादी व्यक्ती Page ला Messenger मेसेज पाठवते. त्यात messaging array येतो, ज्यात पाठवणाऱ्याचा Page-scoped ID, Page चा ID, timestamp आणि मेसेजचा mid असतो, तसेच मजकूर किंवा अटॅचमेंट्स. mention फील्ड Page चे पोस्ट आणि कमेंट्समधील नवे मेन्शन्स कळवते. Meta दोन्ही X-Hub-Signature-256 ने साइन करते.
easyCoexistence प्रत्येक कनेक्ट केलेल्या Page चे Messenger मेसेज आणि मेन्शन्स, येताच, तुमच्या HTTPS एंडपॉइंटकडे फॉरवर्ड करते.
Meta एखाद्या Messenger वेबहुक एंडपॉइंटकडून प्रत्येक सूचनेला 200 OK ने किती लवकर उत्तर अपेक्षित करते.
डिलिव्हरी इतका वेळ अयशस्वी राहिल्यास, Meta पुन्हा सबस्क्राइब होईपर्यंत ॲप Page च्या वेबहुक्समधून अनसबस्क्राइब करते.
messages इव्हेंटमधील पाठवणाऱ्याचा Page-scoped ID, जो प्रत्येक व्यक्ती आणि Page जोडीसाठी वेगळा असतो.
Meta च्या संदर्भात mention इव्हेंटचा sender फील्ड कसा चिन्हांकित आहे.
भूतकाळातील वेबहुक सूचना नंतर क्वेरी करता येत नाहीत, म्हणून रिसीव्हरने आवश्यक ते साठवले पाहिजे.
messages फील्ड काय पाठवते?
जेव्हा एखादी व्यक्ती Page ला Messenger मेसेज पाठवते तेव्हा ही सूचना येते. Meta मजकूर मेसेज किंवा अटॅचमेंट्स असलेले मेसेज पाठवते, ज्यात इमेज, ऑडिओ, व्हिडिओ, फाइल्स किंवा स्टिकर्स इतर प्रकारांसह असू शकतात, आणि शेअर केलेली लिंक फॉलबॅक अटॅचमेंट म्हणून येऊ शकते. आधीच्या मेसेजला दिलेले उत्तर reply_to सोबत त्या मेसेजचा mid घेऊन येते, आणि क्विक रिप्लाय त्याचा पेलोड घेऊन येतो.
messages इव्हेंट कसा दिसतो?
फीड बदलांपेक्षा वेगळे, मेसेज Page च्या entry मधील messaging array मध्ये येतो. प्रत्येक इव्हेंटमध्ये sender, म्हणजे व्यक्तीचा Page-scoped ID; recipient, म्हणजे Page; एक timestamp; आणि message, ज्यात त्याचा mid आणि text, किंवा प्रकार आणि पेलोड यूआरएल असलेले 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, message, कोणतीही लिंक, फोटो किंवा व्हिडिओ, आणि item व verb असतात. Meta इशारा देते की काही पोस्ट व कमेंट IDs परवानगीच्या अभावी किंवा गोपनीयतेमुळे क्वेरी करता येत नाहीत. त्यांच्या संदर्भात sender फील्ड फक्त Workplace साठी असल्याचे चिन्हांकित केले आहे, त्यामुळे मेन्शन त्याच्या लेखकाशिवाय येऊ शकते.
कोणते Messenger फील्ड फॉरवर्ड होत नाहीत?
easyCoexistence Pages ना messages वर सबस्क्राइब करते, message_echoes, messaging_postbacks, message_reads किंवा message_deliveries वर नाही. त्यामुळे Page ने पाठवलेले मेसेज, बटण टॅप्स आणि वाचल्याच्या किंवा डिलिव्हरीच्या पावत्या फॉरवर्ड होत नाहीत. send_social_dm ने पाठवलेले उत्तर त्याऐवजी स्वतःचा मेसेज ID परत देते.
इव्हेंट तुमच्या एंडपॉइंट पर्यंत कसे पोहोचतात?
Meta Page वेबहुक्स संपूर्ण ॲपसाठी एकाच कॉलबॅक यूआरएलद्वारे, Page ने इन्स्टॉल केलेल्या ॲपला पाठवते. easyCoexistence प्रत्येक डिलिव्हरीवरील X-Hub-Signature-256 तपासते, लगेच Meta ला उत्तर देते, आणि कनेक्ट केलेल्या Page च्या प्रत्येक entry ला तुम्ही त्या Page साठी सेट केलेल्या HTTPS एंडपॉइंटकडे फॉरवर्ड करते. ती त्या Page च्या स्वतःच्या सीक्रेटने साइन केलेली असते. ती set_social_webhook_destination ने Claude किंवा ChatGPT वरून, किंवा Partner API वरील PUT /channels/:id/webhook ने सेट करा. सीक्रेट एकदाच दाखवला जातो, पुन्हा सेट केल्यास नवा जारी होतो, आणि null URL फॉरवर्डिंग बंद करते.
फॉरवर्ड झालेला इव्हेंट कसा दिसतो?
एक POST ज्यात platform, list_social_accounts ने Page च्या कनेक्शनसाठी दिलेला account_id, Page चा ID external_id म्हणून, आणि entry असतो. entry हा Page साठी Meta चा entry आहे, बदल न करता. sender.id हा recipient_id आहे, जो 24 तासांच्या खिडकीतील उत्तरासाठी send_social_dm घेते:
{
"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 मध्ये t=<unix>,v1=<hex> स्वरूपात X-EC-Signature हेडर असतो. येथे v1 हा timestamp, एक ठिपका आणि कच्च्या बॉडीचा HMAC-SHA256 आहे, जो Page च्या साइनिंग सीक्रेटने की केलेला असतो. बॉडी जशी मिळाली तशीच, अचूक, त्यावर गणना करा, स्थिर वेळेत तुलना करा, आणि 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));
}डिलिव्हरी पुन्हा प्रयत्न केली जाते का?
easyCoexistence कडून नाही. प्रत्येक entry एकदाच, मेमरीमध्ये फॉरवर्ड होते, पुन्हा प्रयत्नासाठी कोणतीही प्रत न ठेवता. फॉरवर्ड उत्तराची 8 सेकंद वाट पाहतो, redirects चे पालन करत नाही आणि फक्त अशा HTTPS पत्त्यावर जातो जो सार्वजनिक IP कडे रिझॉल्व्ह होतो. Meta नोंदवते की भूतकाळातील सूचना नंतर क्वेरी करता येत नाहीत, म्हणून जे आवश्यक ते येताच साठवा. अपस्ट्रीमवर, Meta अयशस्वी डिलिव्हरी काही वेळा लगेच पुन्हा पाठवते, त्यामुळे तोच मेसेज क्वचित दोनदा येऊ शकतो. त्यामुळे त्याच्या mid वर डुप्लिकेट काढा.
सामान्य चुका
- उत्तर देण्यापूर्वी काम करणे. फॉरवर्डिंग पुन्हा प्रयत्न करत नाही, म्हणून लगेच 2xx परत करा आणि इव्हेंट नंतर प्रक्रिया करा.
- पार्स केलेल्या JSON वर सिग्नेचर पडताळणे. HMAC कच्च्या बॉडीवर, ती जशी आली तशीच, अचूक गणा.
- मेसेजमध्ये नेहमी मजकूर असतो असे गृहीत धरणे. स्टिकर, इमेज किंवा शेअर केलेली लिंक attachments म्हणून येते, text फील्डशिवाय.
- डुप्लिकेट काढणे वगळणे. अयशस्वी झाल्यानंतर Meta इव्हेंट पुन्हा पाठवू शकते, म्हणून कृती करण्यापूर्वी mid वर की ठेवा.
ते त्या Page च्या सीक्रेटने साइन केलेले असतात आणि कोणतीही प्रत ठेवली जात नाही. send_social_dm 24 तासांच्या खिडकीत उत्तर पाठवते. set_social_webhook_destination किंवा Partner API ने फॉरवर्डिंग सुरू करा. प्रति कनेक्शन, दरमहा US$ 9 ते US$ 0.75, कनेक्शन वाढवाल तसे कमी होत जाते, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
easyCoexistence Page ला कोणते वेबहुक फील्ड सबस्क्राइब करते?
Messenger साठी messages आणि मेन्शन्ससाठी mention, Page च्या पोस्ट व कमेंट्ससाठी feed सोबत.
Messenger स्टिकर किंवा इमेजसोबत मजकूर येतो का?
नाही. स्टिकर, इमेज किंवा शेअर केलेली लिंक attachments मध्ये येते. प्रत्येकासोबत प्रकार आणि पेलोड यूआरएल असतो, आणि मेसेजमध्ये text फील्ड नसते.
Messenger वेबहुक एंडपॉइंटने किती लवकर उत्तर द्यायला हवे?
5 सेकंदांच्या आत 200 OK ने. अयशस्वी डिलिव्हरीचा 1 तास झाल्यावर Meta ॲप Page च्या वेबहुक्समधून अनसबस्क्राइब करते.
फॉरवर्ड झालेल्या मेसेजला उत्तर कसे द्यायचे?
इव्हेंटमधील sender.id recipient_id म्हणून देऊन send_social_dm वापरा, व्यक्तीच्या मेसेजच्या 24 तासांच्या आत.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: