Skip to main content
Messaging API आपको उन correspondents को direct messages (DM) प्रबंधित करने की अनुमति देता है जो आपके User Profiles से संपर्क करते हैं। Correspondent वह व्यक्ति है जिसके साथ आपका user (User Profile) संवाद कर रहा है। Conversation आपके user (User Profile) और उनके correspondent के बीच messages की एक श्रृंखला है।
  • Messaging API सभी Ayrshare Business Plans के साथ शामिल है और Premium plans के लिए एक भुगतान add-on के रूप में उपलब्ध है।
  • Business और Premium plans दोनों के लिए, आपको Ayrshare dashboard के Account पेज में Messaging को activate करना होगा।
  • Messaging Facebook Messenger, Instagram Direct Messenger, X Direct Messages, और WhatsApp (Private Beta) के लिए उपलब्ध है।
WhatsApp Private Beta में है। Messaging API के माध्यम से WhatsApp संदेश भेजें और प्राप्त करें। यदि आप जल्दी एक्सेस चाहते हैं, तो lotty@ayrshare.com पर ईमेल करें।

Messaging API के बारे में और जानें

​
प्रमुख Messaging विशेषताएँ

  • अपने users के correspondents के साथ वार्तालाप प्रबंधित करें।
  • अपने users की ओर से text, image, video, और emoji संदेश भेजें।
  • पूर्ण वार्तालाप इतिहास प्राप्त करें।
  • स्वचालित संदेश प्रतिक्रियाएँ सेट करें।
  • प्राप्त संदेशों, संदेश प्रतिक्रियाओं, read receipts के लिए webhooks के माध्यम से वास्तविक-समय अद्यतन प्राप्त करें।

​
Messaging सक्षम करें

​
अपना Ayrshare Account और User Profiles सक्षम करें

DMs का प्रबंधन करने के लिए आपको पहले अपने समग्र Ayrshare account के लिए messaging सक्षम करना होगा। Ayrshare dashboard में Account पेज पर जाएँ और “Learn More” बटन पर क्लिक करें और फिर “Enable” पर क्लिक करें। इस बिंदु पर आपने अपने समग्र account के लिए messaging सक्षम कर दिया है, लेकिन आपने व्यक्तिगत User Profiles के लिए messaging सक्रिय नहीं किया है। आप व्यक्तिगत User Profiles के लिए messaging सक्रिय कर सकते हैं या तो User Profiles पेज में प्रत्येक profile के लिए “Messaging Active” checkbox पर क्लिक करके या create या update profiles endpoint का उपयोग करके। एक User Profile के लिए messaging सक्षम करने के बाद, आपको Social Accounts/Social Linking पेज में सोशल अकाउंट (Facebook और Instagram) को फिर से लिंक करना होगा। सक्षम होने के बाद आप linked social account पर “Messaging” badge देखेंगे।
Messages endpoints इन setup चरणों को अलग-अलग error codes के साथ रिपोर्ट करते हैं, ताकि आप उन्हें प्रोग्रामेटिक रूप से अलग बता सकें:
  • 403 / code 361 — Messaging सक्षम नहीं है। या तो account Messaging के लिए subscribed नहीं है, या इस User Profile को activate नहीं किया गया है। ऊपर दिए गए चरण पूरे करें; सोशल अकाउंट को relink करने से मदद नहीं मिलेगी।
  • 400 / code 362 — User Profile के लिए Messaging सक्रिय है, लेकिन इस Facebook या Instagram अकाउंट को अभी भी relink करने की आवश्यकता है। इस response में resolution: { "relink": true } शामिल है।
Messaging badge

​
WhatsApp के लिए Messaging सक्षम करें

WhatsApp Private Beta में है। सेटअप फ़्लो और Messaging API endpoints अनुमोदित beta accounts के लिए उपलब्ध हैं। एक्सेस का अनुरोध करने के लिए, lotty@ayrshare.com पर ईमेल करें।
सीधे Ayrshare dashboard से Meta के embedded signup फ़्लो के माध्यम से एक WhatsApp Business account लिंक करें:
  • आपको एक Meta Business Manager account, एक WhatsApp Business Account (WABA), और एक eligible फ़ोन नंबर की आवश्यकता है। Meta embedded signup के दौरान account और फ़ोन नंबर सत्यापित करता है।
  • Social Accounts पेज पर, WhatsApp टाइल पर Link क्लिक करें। Ayrshare Meta का embedded signup पॉप-अप लॉन्च करता है जो ग्राहक को उनका Business Manager, WABA, और फ़ोन नंबर चुनने/बनाने, और Meta की शर्तों को स्वीकार करने के लिए मार्गदर्शन करता है।
  • जब signup पूरा होता है, Ayrshare चयनित WABA और फ़ोन नंबर के स्वामित्व की पुष्टि करता है, पंजीकरण पूरा करता है, और account को WhatsApp webhooks पर subscribe करता है। आपको Ayrshare dashboard में एक अलग पंजीकरण PIN दर्ज करने की आवश्यकता नहीं है।

​
महत्वपूर्ण WhatsApp-विशिष्ट व्यवहार

  • प्राप्तकर्ता फ़ोन नंबर हैं, IDs नहीं। WhatsApp correspondents को E.164 फ़ोन नंबर (केवल अंक, + के बिना) द्वारा पहचानता है। Ayrshare से लौटाई गई Conversation IDs भी correspondent का फ़ोन नंबर होती हैं — Facebook और Instagram की तरह कोई opaque conversation IDs नहीं हैं।
  • 24-घंटे customer service window। WhatsApp Business केवल correspondent के सबसे हाल के संदेश के 24 घंटों के भीतर free-form outbound संदेशों की अनुमति देता है। उस window के बाहर Meta send को अस्वीकार कर देता है। 24-घंटे window के बाहर टेम्पलेटेड संदेश वर्तमान में Ayrshare के माध्यम से समर्थित नहीं हैं।
  • API के साथ सीधे प्राप्तकर्ता को संबोधित करें। प्राप्तकर्ता का फ़ोन नंबर Send Message को पास करें। Meta केवल तब एक free-form संदेश वितरित करता है जब वह प्राप्तकर्ता 24-घंटे customer service window के अंदर है। कोल्ड आउटरीच के लिए अनुमोदित टेम्पलेट आवश्यक हैं, और Ayrshare वर्तमान में टेम्पलेट भेजने की सुविधा प्रदान नहीं करता।
  • डिलीवरी स्थिति एक field का उपयोग करती है। जब किसी संग्रहीत outbound संदेश पर उपलब्ध हो, Get Messages status को sent, delivered, read, या failed के रूप में लौटाता है। डिलीवरी-स्थिति अपडेट और WhatsApp reactions वर्तमान में आपके पंजीकृत webhook URL पर push नहीं किए जाते।
  • Media प्रकार और आकार Meta की प्रकाशित WhatsApp Cloud API सीमाओं का पालन करते हैं — छवियाँ 5 MB तक, ऑडियो और वीडियो 16 MB तक, और दस्तावेज़ लेखन के समय 100 MB तक।

​
समर्थित WhatsApp Media

  • Image: .jpg, .jpeg, .png
  • Video: .mp4, .3gp
  • Audio: .aac, .amr, .mp3, .m4a, .ogg
  • Document: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​
Instagram App में Messaging सक्षम करें

आपको अपने Instagram अकाउंट के लिए messaging सक्षम करने की आवश्यकता हो सकती है:
  • Instagram mobile app में अपने profile पर जाएँ और Settings and activity पेज पर जाने के लिए ऊपरी दाएँ कोने में menu icon ≡ पर टैप करें।
  • How others can interact with you अनुभाग तक स्क्रॉल करें।
  • Messages and story replies पर क्लिक करें।
  • Message requests पर टैप करें।
  • Connected tool के अंतर्गत Allow access to messages स्विच को toggle on करें।
यहाँ दिखाई गई Message requests सेटिंग यह भी नियंत्रित करती है कि क्या प्राप्तकर्ता तक पहुँचा जा सकता है। यदि आप अपनी पोस्ट पर टिप्पणी करने वाले लोगों को DM भेजने के लिए comment-triggered automations का उपयोग करते हैं, तो डिलीवरी प्रत्येक प्राप्तकर्ता की Message requests सेटिंग पर निर्भर करती है — एक संदेश Instagram द्वारा स्वीकार किया जा सकता है (sent) और फिर चुपचाप छोड़ दिया जा सकता है। देखें Automation DM Sent but Not Delivered।

​
Messaging पर महत्वपूर्ण जानकारी

Facebook और Instagram के लिए, वार्तालाप correspondent द्वारा शुरू किया जाना चाहिए। एक बार वार्तालाप स्थापित हो जाने के बाद, आप अपने users की ओर से संदेश भेज सकते हैं, संदेश प्राप्त कर सकते हैं, reactions प्राप्त कर सकते हैं (जैसे thumbs ups), या read receipts प्राप्त कर सकते हैं। WhatsApp ऊपर वर्णित 24-घंटे customer service window का पालन करता है।
आपके user को Instagram वार्तालाप का जवाब correspondent द्वारा भेजे गए अंतिम संदेश के 7 दिनों के भीतर देना होगा। यदि correspondent ने 7 दिनों में कोई संदेश नहीं भेजा है तो वार्तालाप को निष्क्रिय माना जाता है और उसका उत्तर नहीं दिया जा सकता।
Comment-triggered automations एक अलग 7-दिन विंडो का उपयोग करते हैं। एक comment_keyword automation comment का उत्तर एक private reply के माध्यम से देता है, जिसकी 7-दिन विंडो टिप्पणी पर एंकर्ड होती है (किसी पूर्व संदेश पर नहीं), इसलिए किसी मौजूदा वार्तालाप की आवश्यकता नहीं होती। डिलीवरी अब भी प्राप्तकर्ता की Message requests सेटिंग के अधीन है — देखें Automation DM Sent but Not Delivered।

​
Facebook और Instagram के लिए Message History Retrieval

जब आप पहली बार एक linked Facebook या Instagram वाले user profile के लिए messaging सक्षम करते हैं, तो वार्तालाप इतिहास तक पहुँचने पर महत्वपूर्ण सीमाएँ हैं:

​
प्रारंभिक Connection सीमाएँ

  • जब आप पहली बार messaging के लिए एक account लिंक करते हैं तो Facebook और Instagram मौजूदा वार्तालापों से केवल अंतिम 20 संदेशों की पुनर्प्राप्ति की अनुमति देते हैं
  • यदि किसी वार्तालाप में 20 से अधिक संदेश हैं, तो प्रारंभ में केवल सबसे हाल के 20 ही सुलभ होंगे

​
प्रारंभिक Setup के बाद

  • Messaging सक्षम होने के बाद, भेजे गए और प्राप्त सभी नए संदेश पूरी तरह से सुलभ होंगे
  • Ayrshare आगे बढ़ते हुए पूर्ण वार्तालाप इतिहास बनाए रखता है
  • उदाहरण के लिए: यदि आप प्रारंभ में 20 संदेश पुनर्प्राप्त करते हैं, फिर 100 नए संदेश आदान-प्रदान किए जाते हैं, तो आप कुल 120 संदेशों तक पहुँच सकेंगे
यह सीमा केवल messaging सक्षम करने से पहले मौजूद ऐतिहासिक संदेशों पर लागू होती है - Facebook और Instagram के लिए सभी भविष्य की वार्तालाप गतिविधि पूरी तरह से संरक्षित और सुलभ होगी।

​
Conversation सीमा और मूल्य निर्धारण

  • प्रत्येक Ayrshare User Profile में प्रति billing cycle 1,000 सक्रिय वार्तालाप तक हो सकते हैं। सक्रिय वार्तालाप संख्या सभी सोशल नेटवर्क में योग है।
  • Premium plan: Messaging प्रति account एक flat $49 प्रति माह add-on है।
  • Launch और Business plans: Messaging को Stripe metered billing के माध्यम से $0.09 प्रति सक्रिय वार्तालाप पर बिल किया जाता है। Volume-आधारित छूट उपलब्ध हैं; विवरण के लिए अपने Ayrshare account प्रतिनिधि से संपर्क करें।
  • जब आप किसी recipient को संदेश भेजते हैं तो वार्तालाप को billing cycle के लिए सक्रिय के रूप में गिना जाता है। Recipient से inbound संदेश, अपने आप में, वार्तालाप को सक्रिय के रूप में चिह्नित नहीं करते हैं।
  • यदि 1,000 वार्तालाप सीमा पूरी हो गई है, तो आप अभी भी संदेश प्राप्त कर सकते हैं, लेकिन आप अगले billing cycle की शुरुआत तक उत्तर नहीं दे पाएँगे।
  • एक सक्रिय वार्तालाप में भेजे या प्राप्त संदेशों की संख्या असीमित है।
  • यदि आपको वार्तालाप सीमा बढ़ाने की आवश्यकता है, तो कृपया अपने Ayrshare account प्रतिनिधि से संपर्क करें।
आप user endpoint के साथ वर्तमान वार्तालाप संख्या देख सकते हैं।

​
Facebook और Instagram पर Messaging Control मुद्दे

Meta (Facebook और Instagram) messaging वार्तालापों के लिए एक “thread control” प्रणाली का उपयोग करता है। इसका मतलब है कि किसी वार्तालाप में एक बार में केवल एक ऐप संदेश भेज सकता है, जबकि अन्य ऐप्स केवल संदेश प्राप्त कर सकते हैं।

​
इसका क्या मतलब है?

यदि आप त्रुटि “Message failed to send because another app is controlling this thread now” देखते हैं, तो इसका मतलब है:
  • एक अलग third-party ऐप वर्तमान में उस वार्तालाप को नियंत्रित करता है
  • Ayrshare केवल उस वार्तालाप में संदेश प्राप्त कर सकता है
  • Ayrshare तब तक संदेश नहीं भेज सकता जब तक कि यह नियंत्रण पुनः प्राप्त न कर ले

​
इस समस्या को कैसे ठीक करें

Ayrshare को फिर से संदेश भेजने की अनुमति देने के लिए, आपको उस third-party ऐप को हटाना होगा जो वार्तालाप को नियंत्रित कर रहा है। कृपया ध्यान दें कि Meta (Facebook और Instagram) third-party ऐप्स को हटाने की प्रक्रिया को अद्यतन कर सकता है, इसलिए निम्नलिखित चरणों को एक सामान्य दिशानिर्देश के रूप में उपयोग करें। Facebook Pages के लिए:
  1. Facebook.com पर जाएँ और अपने account में लॉग इन करें
  2. ऊपरी दाएँ में menu (☰) पर क्लिक करें → Settings & Privacy → Settings
  3. बाएँ sidebar में, Apps and Websites पर क्लिक करें
  4. वह third-party ऐप ढूँढें जो आपके messaging को नियंत्रित कर रहा है
  5. उस ऐप के आगे Remove पर क्लिक करें
  6. हटाने की पुष्टि करें
Instagram Business Accounts के लिए:
  1. अपने फ़ोन पर Instagram ऐप खोलें
  2. अपने Profile पर जाएँ → menu (☰) पर टैप करें → Settings and Privacy
  3. Apps and Websites पर टैप करें
  4. Third-party ऐप ढूँढें और हटाएँ
Instagram के लिए वैकल्पिक:
  1. business.facebook.com पर जाएँ
  2. Business Settings पर navigate करें
  3. Accounts के अंतर्गत, Instagram Accounts पर क्लिक करें
  4. अपना Instagram account चुनें
  5. connected apps की जाँच करें और समस्याग्रस्त को हटा दें

​
हटाने के बाद

एक बार जब आपने third-party ऐप हटा दिया:
  • Thread control स्वचालित रूप से Ayrshare पर वापस आ जाएगा
  • आप सामान्य रूप से फिर से संदेश भेजने में सक्षम होने चाहिए
  • आपकी ओर से कोई और कार्रवाई आवश्यक नहीं है
यदि ऐप हटाने के बाद भी आपको समस्याओं का अनुभव जारी रहता है, तो कृपया हमारी support टीम से संपर्क करें।

​
Message WebHooks

संदेश, read receipts, या reactions स्वचालित रूप से प्राप्त करने के लिए Messages Webhooks देखें।