Facebook Page को लागि Messenger वेबहुक: म्यासेज र उल्लेख घटनाहरू
Facebook को Page वेबहुकको messages फिल्ड सक्रिय हुन्छ जब कुनै व्यक्तिले Page लाई Messenger म्यासेज पठाउँछ। यसले messaging एर्रे पठाउँछ, जसमा प्रेषकको Page-scoped आईडी, Page को आईडी, समयछाप र म्यासेजको 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 आईडी हुन्छ, जुन प्रत्येक व्यक्ति र Page जोडीका लागि अद्वितीय हुन्छ।
Meta को सन्दर्भ पुस्तकले mention घटनाको sender फिल्ड कसरी चिन्हित गर्छ।
विगतका वेबहुक सूचनाहरू पछि खोज्न सकिँदैन, त्यसैले प्राप्तकर्ताले आवश्यक पर्ने कुरा भण्डारण गर्नुपर्छ।
messages फिल्डले के पठाउँछ?
जब कुनै व्यक्तिले Page लाई Messenger म्यासेज पठाउँछ, तब सूचना आउँछ। Meta ले टेक्स्ट म्यासेज वा संलग्नक भएका म्यासेज पठाउँछ, जुन तस्बिर, अडियो, भिडियो, फाइल वा स्टिकर जस्ता अन्य प्रकारका हुन सक्छन्, र साझा गरिएको लिंक फलब्याक संलग्नकको रूपमा आउन सक्छ। कुनै अघिल्लो म्यासेजको उत्तरमा reply_to सँग त्यस म्यासेजको mid हुन्छ, र द्रुत उत्तरमा यसको पेलोड हुन्छ।
messages घटना कस्तो देखिन्छ?
फिड परिवर्तनहरूको उल्टो, म्यासेज Page को entry भित्रको messaging एर्रेमा आउँछ। प्रत्येक घटनामा sender छ, जुन व्यक्तिको Page-scoped आईडी हो; recipient, जुन Page हो; एउटा समयछाप; र message, जसमा mid र टेक्स्ट वा प्रकार र पेलोड यूआरएल भएका संलग्नकहरू हुन्छन्:
{
"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 हुन्छन्। Meta ले चेतावनी दिन्छ कि ती पोस्ट र टिप्पणी ID मध्ये केही खोज्न सकिँदैनन्, अनुमति नभएका वा गोपनीयताका कारण, र यसको सन्दर्भले sender फिल्ड केवल Workplace का लागि मात्र भनी चिन्ह लगाउँछ, त्यसैले उल्लेख लेखकविना आउन सक्छ।
कुन Messenger फिल्डहरू फर्वार्ड गरिँदैनन्?
easyCoexistence ले Page लाई 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 एपीआई मा PUT /channels/:id/webhook ले सेट गर्नुहोस्; गोप्य कुञ्जी एक पटक मात्र देखाइन्छ, फेरि सेट गर्दा नयाँ जारी हुन्छ, र null यूआरएलले फर्वार्डिङ बन्द गर्छ।
फर्वार्ड गरिएको घटना कस्तो देखिन्छ?
एउटा POST जसमा प्लेटफर्म, list_social_accounts ले Page को जडानलाई दिने account_id, Page को ID external_id का रूपमा, र entry: Page का लागि Meta को entry, जस्ताको तस्तै, हुन्छ। sender.id नै send_social_dm ले 24 घण्टाको विन्डोभित्र उत्तरका लागि लिने 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 समयछाप, एउटा डट र कच्चा बडीको HMAC-SHA256 हो, Page को हस्ताक्षर गर्ने गोप्य कुञ्जीसँग। बडीलाई जस्तो प्राप्त भयो त्यस्तै ठ्याक्कै गणना गर्नुहोस्, स्थिर समयमा तुलना गर्नुहोस्, र 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 सेकेन्ड पर्खन्छ, रिडाइरेक्ट पछ्याउँदैन, र सार्वजनिक IP मा समाधान हुने HTTPS ठेगानामा मात्र जान्छ। Meta ले भन्छ कि विगतका सूचनाहरू पछि खोज्न सकिँदैन, त्यसैले आउँदा नै आवश्यक पर्ने कुरा भण्डारण गर्नुहोस्। माथिल्लो तहमा, Meta ले असफल डेलिभरी एकै पटक केही पटक पुनः प्रयास गर्छ, त्यसैले उही म्यासेज कहिलेकाहीँ दुईपटक आउन सक्छ: यसको mid मा दोहोरिएका हटाउनुहोस्।
सामान्य गल्तीहरू
- उत्तर दिनुअघि नै काम गर्नु। फर्वार्डिङले पुनः प्रयास गर्दैन, त्यसैले तुरुन्तै 2xx फर्काउनुहोस् र घटना पछि प्रशोधन गर्नुहोस्।
- पार्स गरिएको JSON मा हस्ताक्षर जाँच्नु। HMAC लाई कच्चा बडीमा जस्तो आएको थियो त्यस्तै ठ्याक्कै गणना गर्नुहोस्।
- म्यासेजमा सधैँ टेक्स्ट हुन्छ भनी मान्नु। स्टिकर, तस्बिर वा साझा लिंक संलग्नकको रूपमा आउँछ, कुनै टेक्स्ट फिल्ड बिना।
- दोहोरिएका हटाउने चरण छोड्नु। असफलता पछि Meta ले घटना फेरि पठाउन सक्छ, त्यसैले कार्य गर्नुअघि म्यासेजको mid मा कुञ्जी राख्नुहोस्।
set_social_webhook_destination वा Partner एपीआई बाट फर्वार्डिङ सक्रिय गर्नुहोस्। प्रति जडान प्रति महिना US$ 9 देखि US$ 0.75 सम्म, जडान थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
कुन वेबहुक फिल्डहरूमा easyCoexistence ले Page लाई सदस्यता दिन्छ?
Messenger का लागि messages, उल्लेखका लागि mention, र Page का पोस्ट र टिप्पणीका लागि feed।
के Messenger स्टिकर वा तस्बिरसँग टेक्स्ट आउँछ?
छैन। स्टिकर, तस्बिर वा साझा लिंक संलग्नकहरूमा आउँछ, प्रत्येकमा प्रकार र पेलोड यूआरएल सहित, र म्यासेजमा टेक्स्ट फिल्ड हुँदैन।
Messenger वेबहुक एन्डपोइन्टले कति छिटो उत्तर दिनुपर्छ?
5 सेकेन्डभित्र 200 OK सहित। 1 घण्टासम्म असफल डेलिभरी भएपछि, Meta ले एपलाई Page का वेबहुकहरूबाट सदस्यता रद्द गर्छ।
फर्वार्ड गरिएको म्यासेजको उत्तर कसरी दिने?
प्राप्तकर्ता recipient_id को रूपमा घटनाबाट sender.id सहित send_social_dm लाई बोलाउनुहोस्, व्यक्तिको म्यासेजको 24 घण्टाभित्र।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको