Facebook Pages के लिए Messenger वेबहुक: मैसेज और मेंशन इवेंट
Facebook के Page वेबहुक का messages फ़ील्ड तब सक्रिय होता है जब कोई व्यक्ति Page को Messenger मैसेज भेजता है। यह एक messaging ऐरे भेजता है, जिसमें भेजने वाले का Page-scoped ID, Page का ID, टाइमस्टैम्प और मैसेज का mid होता है, साथ में उसका टेक्स्ट या अटैचमेंट। mention फ़ील्ड Page के पोस्ट और कमेंट में नए मेंशन की सूचना देता है, और Meta दोनों पर X-Hub-Signature-256 से हस्ताक्षर करता है।
easyCoexistence हर जुड़े Page के Messenger मैसेज और मेंशन को आते ही आपके HTTPS एंडपॉइंट पर आगे भेजता है, उस Page के लिए सीक्रेट से हस्ताक्षरित और बिना किसी कॉपी के, और send_social_dm 24 घंटे की विंडो के भीतर जवाब भेजता है।
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 ऐरे में आता है। हर इवेंट में 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 का ज़िक्र करता है, तब 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 हर डिलीवरी पर Meta का X-Hub-Signature-256 जांचता है, Meta को तुरंत जवाब देता है, और जुड़े हुए Page की हर entry को उस HTTPS एंडपॉइंट पर आगे भेजता है जो आपने उसके लिए सेट किया है, उस Page के अपने सीक्रेट से हस्ताक्षरित। इसे Claude या ChatGPT से set_social_webhook_destination के जरिए सेट करें, या Partner API पर PUT /channels/:id/webhook से। सीक्रेट एक बार दिखाया जाता है, दोबारा सेट करने पर नया जारी होता है, और null यूआरएल फ़ॉरवर्डिंग बंद कर देता है।
आगे भेजा गया इवेंट कैसा दिखता है?
एक POST जिसमें platform होता है, account_id जो list_social_accounts Page के कनेक्शन के लिए देता है, Page का ID external_id के रूप में, और 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 में X-EC-Signature हेडर होता है, t=<unix>,v1=<hex> के रूप में, जहां v1 timestamp, एक डॉट और raw body का HMAC-SHA256 है, जो Page के हस्ताक्षर सीक्रेट से बनता है। body को ठीक वैसे ही गणना करें जैसा वह मिला, constant time में तुलना करें, और 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 सेकंड तक जवाब का इंतज़ार करता है, रीडायरेक्ट का पालन नहीं करता, और केवल ऐसे HTTPS पते पर जाता है जो सार्वजनिक IP पर हल होता हो। Meta नोट करता है कि पिछली सूचनाएं बाद में क्वेरी नहीं की जा सकतीं, इसलिए जो चाहिए उसे आते ही स्टोर करें। ऊपर की ओर Meta विफल डिलीवरी को कुछ बार तुरंत फिर भेजता है, इसलिए वही मैसेज कभी-कभी दो बार पहुंच सकता है: उसके mid पर डुप्लिकेट हटाएं।
आम गड़बड़ियाँ
- जवाब देने से पहले ही काम शुरू कर देना। फ़ॉरवर्डिंग दोबारा कोशिश नहीं करती, इसलिए तुरंत 2xx लौटाएं और इवेंट को बाद में प्रोसेस करें।
- पार्स किए गए JSON पर सिग्नेचर सत्यापित करना। HMAC को raw body पर ठीक वैसे ही गणना करें जैसा वह आया था।
- मान लेना कि मैसेज में हमेशा टेक्स्ट होता है। स्टिकर, इमेज या साझा किया गया लिंक attachments के रूप में आता है, उसमें text फ़ील्ड नहीं होता।
- डुप्लिकेट हटाने को छोड़ना। विफलता के बाद Meta कोई इवेंट फिर से भेज सकता है, इसलिए कार्रवाई से पहले message mid से कुंजी बनाएं।
फ़ॉरवर्डिंग 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 निगरानी
इस तारीख को सत्यापित