लग इननिःशुल्क ट्रायल सुरु गर्नुहोस्
easyCoexistence आधिकारिक एपीआई

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 घण्टाको विन्डोभित्र उत्तर दिन्छ।

5 seconds

Meta ले Messenger वेबहुक एन्डपोइन्टबाट प्रत्येक सूचनाको उत्तर 200 OK सहित कति छिटो दिनुपर्छ भनेर माग्छ।

1 hour

यति लामो समयसम्म डेलिभरी असफल भएपछि, Meta ले एपलाई Page का वेबहुकहरूबाट फेरि सदस्यता नलिउन्जेलसम्म सदस्यता रद्द गर्छ।

PSID

messages घटनामा प्रेषकको Page-scoped आईडी हुन्छ, जुन प्रत्येक व्यक्ति र Page जोडीका लागि अद्वितीय हुन्छ।

Workplace only

Meta को सन्दर्भ पुस्तकले mention घटनाको sender फिल्ड कसरी चिन्हित गर्छ।

No history

विगतका वेबहुक सूचनाहरू पछि खोज्न सकिँदैन, त्यसैले प्राप्तकर्ताले आवश्यक पर्ने कुरा भण्डारण गर्नुपर्छ।

messages फिल्डले के पठाउँछ?

जब कुनै व्यक्तिले Page लाई Messenger म्यासेज पठाउँछ, तब सूचना आउँछ। Meta ले टेक्स्ट म्यासेज वा संलग्नक भएका म्यासेज पठाउँछ, जुन तस्बिर, अडियो, भिडियो, फाइल वा स्टिकर जस्ता अन्य प्रकारका हुन सक्छन्, र साझा गरिएको लिंक फलब्याक संलग्नकको रूपमा आउन सक्छ। कुनै अघिल्लो म्यासेजको उत्तरमा reply_to सँग त्यस म्यासेजको mid हुन्छ, र द्रुत उत्तरमा यसको पेलोड हुन्छ।

messages घटना कस्तो देखिन्छ?

फिड परिवर्तनहरूको उल्टो, म्यासेज Page को entry भित्रको messaging एर्रेमा आउँछ। प्रत्येक घटनामा sender छ, जुन व्यक्तिको Page-scoped आईडी हो; recipient, जुन Page हो; एउटा समयछाप; र message, जसमा mid र टेक्स्ट वा प्रकार र पेलोड यूआरएल भएका संलग्नकहरू हुन्छन्:

A messages event, as Meta sends it
{
  "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 हो:

A forwarded messages event
{
  "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 मिनेटभन्दा पुरानो समयछाप अस्वीकार गर्नुहोस्।

Node.js: verifying X-EC-Signature
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 मा कुञ्जी राख्नुहोस्।
EasyCoexistence मार्फत यो काम

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 घण्टाभित्र।

पढ्दै जानुहोस्

Facebook Page feed वेबहुक: कमेन्ट, पोस्ट र रिएक्सन इभेन्टFacebook Page feed वेबहुकले कमेन्ट, पोस्ट र रिएक्सनको इभेन्ट कसरी पठाउँछ, item र verb फिल्ड, Meta को पेलोड र Page सब्सक्राइब।Messenger को 24 घण्टे अवधि: Facebook Page ले कहिले म्यासेज गर्न सक्छFacebook Page ले Messenger मा कसलाई कहिले म्यासेज पठाउन सक्छ: 24 घण्टेको मानक अवधि, खोल्ने कार्यहरू र विज्ञापनपछि 7 दिनसम्म।Facebook निजी रिप्लाई एपीआई: Page मा कमेन्ट गर्ने व्यक्तिलाई म्यासेज गर्नुहोस्Meta मार्फत Facebook निजी रिप्लाई पठाउनुहोस्: POST /{page-id}/messages, कमेन्ट ID सहित, 7 दिनभित्र एक म्यासेज, र त्रुटिहरू।Facebook Page API अनुमति र App Review आवश्यकताहरूFacebook Page का नौ अनुमति, प्रत्येकले खोल्ने काम, र Meta को App Review ले माग्ने कुरा: Advanced Access, Business Verification र स्क्रिन रेकर्डिङ।Facebook Page एक्सेस टोकन: कति समयसम्म चल्छ र कुन कुराले यो अमान्य हुन्छम्याद नभएको Facebook Page एक्सेस टोकन कसरी प्राप्त हुन्छ, कसले पाउन सक्छ र Meta ले कुन अवस्थामा यसलाई स्वीकार गर्न छाड्छ।Facebook त्रुटि 551: Messenger मा व्यक्ति उपलब्ध छैनFacebook त्रुटि 551, यो व्यक्ति अहिले उपलब्ध छैन: Messenger ले Page लाई ब्लक गरेको वा खाता निष्क्रिय पारेको व्यक्तिसँग सम्पर्क गर्न सकेन।

दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।

प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।

  • 3 दिन निःशुल्क
  • जुनसुकै बेला रद्द गर्नुहोस्
  • आधिकारिक एपीआई मात्र
  • 24/7 निगरानी

प्रमाणीकरण गरिएको