Messenger Send एपीआई: Facebook Page से मैसेज भेजना
Facebook Page एक Page एक्सेस टोकन के साथ POST /{page-id}/messages से Messenger मैसेज भेजता है: प्राप्तकर्ता में व्यक्ति का Page-scoped ID (PSID) होता है, messaging_type मैसेजिंग विंडो के भीतर RESPONSE या UPDATE होता है, और उसके बाद MESSAGE_TAG होता है, और message में टेक्स्ट होता है या कोई अटैचमेंट, जैसे इमेज, ऑडियो, वीडियो या फ़ाइल। Meta recipient_id और message_id के साथ जवाब देता है।
easyCoexistence Claude, ChatGPT या आपके अपने कोड से send_social_dm के ज़रिए 24 घंटे की विंडो के भीतर Messenger पर DM का जवाब देता है, टेक्स्ट के रूप में; मीडिया, quick replies और टेम्पलेट शामिल नहीं हैं।
ऐप हर Page के लिए टेक्स्ट, लिंक, रिएक्शन और स्टिकर वाले मैसेज हेतु जितनी Send एपीआई कॉल कर सकता है।
ऐप हर Page के लिए ऑडियो या वीडियो वाले मैसेज हेतु जितनी Send एपीआई कॉल कर सकता है।
Messenger Platform द्वारा दोबारा इस्तेमाल के लिए सहेजी जाने वाली सबसे बड़ी एसेट; URL से अपलोड की गई इमेज 8 MB तक सीमित होती है।
एक मैसेज अपने attachments ऐरे में जितनी अधिकतम इमेज रख सकता है, यही एकमात्र मीडिया प्रकार है जिसकी वहां अनुमति है।
सहेजे गए attachment_id की अवधि, जिसके बाद मीडिया को फिर से अपलोड करना होगा।
Send एपीआई अनुरोध में क्या होता है?
Meta छह घटक सूचीबद्ध करता है जो हर भेजने में होने चाहिए: भेजने वाले Page का ID, पाने वाले व्यक्ति का ID, उस Page का Page एक्सेस टोकन, व्यक्ति की अनुमति, मैसेज का प्रकार और सामग्री। अनुरोध /{page-id}/messages पर JSON का POST होता है, और जिसने अभी-अभी लिखा है उसे दिया गया जवाब ऐसा दिखता है:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }recipient में कौन-सा ID जाता है?
आम तौर पर Page-scoped ID, यानी PSID, जो Meta किसी व्यक्ति को पहली बार Page को मैसेज करने पर देता है; यह messages वेबहुक में sender.id के रूप में आता है। recipient ऑब्जेक्ट कुछ खास मामलों के लिए अन्य प्रकार के ID भी स्वीकार करता है:
- id: PSID, जो उस व्यक्ति और उस Page के लिए अनोखा है।
user_ref: उस व्यक्ति के लिए जिसने Page को मैसेज करने हेतु प्लगइन या postback बटन का इस्तेमाल किया।comment_idयाpost_id: किसी कमेंट या विज़िटर पोस्ट के निजी जवाब के लिए।- Facebook Login के ID ऐप-स्कोप्ड होते हैं और Messenger Platform पर काम नहीं करते।
किसी मैसेज के लिए कौन-सा messaging_type होना चाहिए?
यह प्रकार बताता है कि Meta को मैसेज क्यों भेजा जा रहा है, और यही तय करता है कि भेजने की अनुमति कब है। Meta के Page messages संदर्भ में चार मान सूचीबद्ध हैं:
- RESPONSE: मैसेजिंग विंडो के भीतर Page को मिले किसी मैसेज का जवाब, चाहे प्रचारात्मक हो या नहीं।
- UPDATE: Page द्वारा अपनी पहल पर भेजा गया मैसेज, चाहे प्रचारात्मक हो या नहीं, यह भी विंडो के भीतर।
MESSAGE_TAG: विंडो के बाद भेजा गया गैर-प्रचारात्मक मैसेज, जिसका टैग स्वीकृत उपयोग के मामले से मेल खाता हो।- UTILITY: स्वीकृत टेम्पलेट से बना यूटिलिटी मैसेज, जैसे ऑर्डर या अपॉइंटमेंट अपडेट।
एक मैसेज में क्या जा सकता है?
टेक्स्ट, या एक अटैचमेंट ऑब्जेक्ट जिसमें टाइप और पेलोड हो: इमेज, ऑडियो, वीडियो और फ़ाइल अटैचमेंट URL या सहेजे गए attachment_id की ओर इशारा करते हैं, और टेम्पलेट अटैचमेंट बटन वाले संरचित मैसेज लेकर चलते हैं। यही एंडपॉइंट ये भी स्वीकार करता है:
- attachments: एक ही मैसेज के रूप में भेजी जाने वाली अधिकतम 30 इमेज का ऐरे।
reply_toके साथ mid: किसी खास पिछले मैसेज का जवाब, चाहे वह व्यक्ति का हो या Page का।quick_replies: कंपोज़र के ऊपर अधिकतम 13 बटन, हर एक का शीर्षक 20 अक्षरों तक।sender_action: टाइपिंग इंडिकेटर, सीन मार्क या रिएक्शन, जो मैसेज से अलग अनुरोध में भेजा जाता है।notification_type: डिफ़ॉल्ट रूप से REGULAR, याSILENT_PUSHयाNO_PUSH।
अटैचमेंट कितने बड़े हो सकते हैं?
सहेजी गई एसेट के लिए Meta की गाइड Messenger Platform द्वारा लाए और रखे गए मीडिया की सीमाएं तय करती है: 25 MB तक की एसेट, URL से अपलोड होने पर 8 MB तक की इमेज, audio Content-Type के साथ भेजा गया ऑडियो, और 75 सेकंड के भीतर लाया गया वीडियो। is_reusable को true पर सेट करने से एक attachment_id मिलता है जिसे केवल वही Page दोबारा इस्तेमाल कर सकता है जिसने उसे भेजा, 90 दिनों तक, और POST /{page-id}/message_attachments से मीडिया पहले से अपलोड किया जा सकता है।
Send एपीआई की रेट लिमिट क्या हैं?
Meta इन्हें हर Page के हिसाब से और कॉन्टेंट के प्रकार के अनुसार गिनता है। उसके Page messages संदर्भ में 613 सूचीबद्ध है, 'Calls to this api have exceeded the rate limit', जो भेजने की गड़बड़ियों में है, इसलिए जब यह आए तो तुरंत फिर से कोशिश करने के बजाय धीमा करें:
- टेक्स्ट, लिंक, रिएक्शन और स्टिकर वाले मैसेज के लिए हर Page पर प्रति सेकंड 300 कॉल।
- ऑडियो या वीडियो वाले मैसेज के लिए हर Page पर प्रति सेकंड 10 कॉल।
- किसी एक थ्रेड में बहुत सारे मैसेज भेजने पर वह अकेले भी रेट लिमिट हो सकता है।
- कुल Messenger एपीआई कॉल: जुड़े हुए सक्रिय उपयोगकर्ताओं की संख्या का 200 गुना, रोलिंग 24 घंटों में।
- प्रति सेकंड 40 से अधिक मैसेज पर Page का इनबॉक्स नए मैसेज दिखाना बंद कर देता है, और मात्रा घटने तक Page भेज नहीं सकता।
Send एपीआई कौन-सी गड़बड़ियां लौटाता है?
Meta की Messenger गड़बड़ी तालिका हर कोड को एक सबकोड से जोड़ती है जो कारण बताता है। ये वे हैं जो Page भेजते समय सबसे अधिक सामने आती हैं:
- 10 के साथ 2018278 या 2534022: 'This message is sent outside of allowed window.'
- 10 के साथ 2018300: दूसरा ऐप बातचीत को नियंत्रित करता है।
- 100: अमान्य पैरामीटर, जैसे गलत प्राप्तकर्ता ID; सबकोड 2018001 कहता है 'No matching user found'।
- 551: व्यक्ति उपलब्ध नहीं है, शायद उसने Page को ब्लॉक किया या अपना खाता निष्क्रिय कर दिया; 1545041 के साथ 200 कहता है 'This person isn't available right now.'
- 2018028 के साथ 200: जब तक
pages_messagingकी समीक्षा न हो और ऐप लाइव न हो, ऐप अपनी भूमिकाओं से बाहर के लोगों को मैसेज नहीं कर सकता। - 10904: सेटिंग में Page के मैसेज बंद हैं: 'The page has messages disabled in the settings.'
easyCoexistence इसके ज़रिए कैसे भेजता है?
send_social_dm account_id, व्यक्ति का recipient_id, जो forwarded messages इवेंट में sender.id होता है, और टेक्स्ट लेता है, और उन्हें messaging_type RESPONSE के साथ /{page-id}/messages पर पोस्ट करता है। परिणाम Meta का जवाब होता है जिसमें message_id होता है, और अस्वीकृत भेजने पर Meta का गड़बड़ी कोड और संदेश लौटता है। मीडिया, quick replies, टेम्पलेट और sender_action टूल में शामिल नहीं हैं: send_social_dm टेक्स्ट भेजता है।
आम गड़बड़ियाँ
- टाइपिंग इंडिकेटर को मैसेज के साथ भेजना। Meta चाहता है कि sender_action अकेला प्राप्तकर्ता के साथ भेजा जाए, और टेक्स्ट या टेम्पलेट अलग अनुरोध में।
- एक व्यक्ति पर बौछार की तरह मैसेज भेजना। Page के 300 कॉल प्रति सेकंड से अलग, Meta अकेले एक थ्रेड को भी रेट लिमिट कर सकता है।
- ऑडियो या वीडियो को टेक्स्ट की दर से भेजना। ऑडियो या वीडियो वाले मैसेज हर Page पर प्रति सेकंड 10 कॉल तक सीमित हैं।
- 90 दिन से पुराना attachment_id दोबारा इस्तेमाल करना। सहेजे गए attachment ID की अवधि खत्म हो जाती है, इसलिए नए के लिए मीडिया फिर से अपलोड करें।
ऑटोमेशन नए मैसेज का स्वयं जवाब देते हैं, निश्चित टेक्स्ट या AI जवाब के साथ। US$ 9 से US$ 0.75 तक प्रति कनेक्शन प्रति माह, जुड़ते कनेक्शनों के साथ घटते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या Messenger Send एपीआई मुफ़्त है?
हाँ, मानक मैसेज के लिए। Meta का अवलोकन Messenger Platform को इस्तेमाल के लिए मुफ़्त बताता है, इसलिए जो Page अपने पास लिखने वालों को जवाब देता है, उसे हर मैसेज पर कुछ नहीं देना पड़ता; मार्केटिंग मैसेज का शुल्क प्रति मैसेज लगता है।
मैसेज भेजने के लिए कौन-सा Page कार्य चाहिए?
Meta का Messenger अवलोकन ऐसे व्यक्ति का Page टोकन मांगता है जो MESSAGING और MODERATE कार्य कर सकता हो, और pages_messaging अनुमति मिली हो।
क्या easyCoexistence Messenger पर इमेज के साथ जवाब दे सकता है?
अभी नहीं। send_social_dm टेक्स्ट भेजता है, और कोई टूल अटैचमेंट नहीं भेजता।
एक Facebook Page के लिए easyCoexistence की लागत कितनी है?
आपका हर जुड़ा हुआ Page एक कनेक्शन है, जिसका बिल आपकी संख्या के अनुसार US$ 9 से US$ 0.75 तक प्रति कनेक्शन प्रति माह है, और पहले 3 दिन मुफ़्त हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित