लॉग इनमोफत ट्रायल सुरू करा
easyCoexistence अधिकृत एपीआय

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 एंडपॉइंटकडे फॉरवर्ड करते.

5 seconds

Meta एखाद्या Messenger वेबहुक एंडपॉइंटकडून प्रत्येक सूचनेला 200 OK ने किती लवकर उत्तर अपेक्षित करते.

1 hour

डिलिव्हरी इतका वेळ अयशस्वी राहिल्यास, Meta पुन्हा सबस्क्राइब होईपर्यंत ॲप Page च्या वेबहुक्समधून अनसबस्क्राइब करते.

PSID

messages इव्हेंटमधील पाठवणाऱ्याचा Page-scoped ID, जो प्रत्येक व्यक्ती आणि Page जोडीसाठी वेगळा असतो.

Workplace only

Meta च्या संदर्भात mention इव्हेंटचा sender फील्ड कसा चिन्हांकित आहे.

No history

भूतकाळातील वेबहुक सूचना नंतर क्वेरी करता येत नाहीत, म्हणून रिसीव्हरने आवश्यक ते साठवले पाहिजे.

messages फील्ड काय पाठवते?

जेव्हा एखादी व्यक्ती Page ला Messenger मेसेज पाठवते तेव्हा ही सूचना येते. Meta मजकूर मेसेज किंवा अटॅचमेंट्स असलेले मेसेज पाठवते, ज्यात इमेज, ऑडिओ, व्हिडिओ, फाइल्स किंवा स्टिकर्स इतर प्रकारांसह असू शकतात, आणि शेअर केलेली लिंक फॉलबॅक अटॅचमेंट म्हणून येऊ शकते. आधीच्या मेसेजला दिलेले उत्तर reply_to सोबत त्या मेसेजचा mid घेऊन येते, आणि क्विक रिप्लाय त्याचा पेलोड घेऊन येतो.

messages इव्हेंट कसा दिसतो?

फीड बदलांपेक्षा वेगळे, मेसेज Page च्या entry मधील messaging array मध्ये येतो. प्रत्येक इव्हेंटमध्ये sender, म्हणजे व्यक्तीचा Page-scoped ID; recipient, म्हणजे Page; एक timestamp; आणि message, ज्यात त्याचा mid आणि text, किंवा प्रकार आणि पेलोड यूआरएल असलेले attachments असतात:

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, 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 घेते:

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 मध्ये t=<unix>,v1=<hex> स्वरूपात X-EC-Signature हेडर असतो. येथे v1 हा timestamp, एक ठिपका आणि कच्च्या बॉडीचा HMAC-SHA256 आहे, जो Page च्या साइनिंग सीक्रेटने की केलेला असतो. बॉडी जशी मिळाली तशीच, अचूक, त्यावर गणना करा, स्थिर वेळेत तुलना करा, आणि 5 मिनिटांपेक्षा जुना timestamp नाकारा.

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 सेकंद वाट पाहतो, redirects चे पालन करत नाही आणि फक्त अशा HTTPS पत्त्यावर जातो जो सार्वजनिक IP कडे रिझॉल्व्ह होतो. Meta नोंदवते की भूतकाळातील सूचना नंतर क्वेरी करता येत नाहीत, म्हणून जे आवश्यक ते येताच साठवा. अपस्ट्रीमवर, Meta अयशस्वी डिलिव्हरी काही वेळा लगेच पुन्हा पाठवते, त्यामुळे तोच मेसेज क्वचित दोनदा येऊ शकतो. त्यामुळे त्याच्या mid वर डुप्लिकेट काढा.

सामान्य चुका

  • उत्तर देण्यापूर्वी काम करणे. फॉरवर्डिंग पुन्हा प्रयत्न करत नाही, म्हणून लगेच 2xx परत करा आणि इव्हेंट नंतर प्रक्रिया करा.
  • पार्स केलेल्या JSON वर सिग्नेचर पडताळणे. HMAC कच्च्या बॉडीवर, ती जशी आली तशीच, अचूक गणा.
  • मेसेजमध्ये नेहमी मजकूर असतो असे गृहीत धरणे. स्टिकर, इमेज किंवा शेअर केलेली लिंक attachments म्हणून येते, text फील्डशिवाय.
  • डुप्लिकेट काढणे वगळणे. अयशस्वी झाल्यानंतर Meta इव्हेंट पुन्हा पाठवू शकते, म्हणून कृती करण्यापूर्वी mid वर की ठेवा.
EasyCoexistence सोबत हे करताना

ते त्या 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 तासांच्या आत.

पुढे वाचा

Facebook Page फीड वेबहुक: कमेंट, पोस्ट आणि रिॲक्शन इव्हेंटFacebook Page फीड वेबहुक कमेंट, पोस्ट व रिॲक्शनसाठी काय पाठवतो, item व verb फील्ड, Meta चा पेलोड आणि पेज कसे सबस्क्राइब होते.Messenger 24-तासांचा कालावधी: Facebook Page कधी मेसेज पाठवू शकतेFacebook Page कधी Messenger मध्ये मेसेज पाठवू शकते: मानक 24-तासांचा कालावधी, तो उघडणाऱ्या कृती आणि जाहिरातीनंतर 7 दिवसांपर्यंत.Facebook खाजगी उत्तर एपीआय: Page वर कमेंट केलेल्या व्यक्तीला मेसेज पाठवाMeta च्या एपीआयद्वारे Facebook खाजगी उत्तर पाठवा: कमेंट आयडीसह POST /{page-id}/messages, 7 दिवसांत एक Messenger मेसेज आणि त्रुटी.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 देखरेख

पडताळले: