व्यवसाय-विशिष्ट यूज़र आईडी

व्यवसाय-विशिष्ट यूज़र आईडी (BSUID) से आप किसी WhatsApp उपयोगकर्ता का फ़ोन नंबर जाने बिना उसे संदेश भेज सकते हैं। यह आपके Meta बिज़नेस पोर्टफ़ोलियो में उपयोगकर्ता की पहचान करती है।

WhatsApp यूज़रनेम

यूज़रनेम वाले WhatsApp उपयोगकर्ता अपना फ़ोन नंबर साझा किए बिना आपको संदेश भेज सकते हैं। उनके संदेशों में from.bsuid होता है; from.phone_number मौजूद नहीं भी हो सकता है। बिना यूज़रनेम वाले उपयोगकर्ताओं के पास भी BSUID हो सकता है।

अगर उपयोगकर्ता आपकी Meta संपर्क पुस्तिका में है या पिछले 30 दिनों में उसने आपके बिज़नेस नंबर के साथ संदेश या कॉल का आदान-प्रदान किया है, तो Meta फ़ोन नंबर शामिल करता है। 30 दिन का नियम हर बिज़नेस नंबर पर अलग से लागू होता है।

from.username और from.display_name वैकल्पिक हैं। आप इनमें से किसी भी मान पर संदेश नहीं भेज सकते।

BSUID का फ़ॉर्मैट

BSUID में बड़े अक्षरों वाला ISO 3166 alpha-2 देश कोड, एक बिंदु और अधिकतम 128 अक्षर या अंक होते हैं। उदाहरण: US.13491208655302741918।

पूरा मान बिना बदले सेव करें और भेजें। उसी बिज़नेस पोर्टफ़ोलियो का प्रेषक नंबर इस्तेमाल करें। Meta दूसरे पोर्टफ़ोलियो से भेजे गए संदेश अस्वीकार करता है।

उपयोगकर्ता का फ़ोन नंबर बदलने पर BSUID बदल जाता है, इसलिए इसे अपनी ग्राहक आईडी के तहत सेव करें।

पैरेंट BSUID किसी प्रबंधित व्यवसाय के पंजीकृत पोर्टफ़ोलियो में काम करता है। इसमें देश कोड के बाद ENT. जुड़ता है: US.ENT.11815799212886844830। 128 वर्णों की सीमा ENT. के बाद वाले हिस्से पर लागू होती है। Bird दोनों फ़ॉर्मैट स्वीकार करता है।

फ़ोन नंबर माँगें

मैसेज API के इन उदाहरणों में इस बातचीत के लिए ज़रूरी फ़ील्ड ही दिखाए गए हैं।

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918"
  },
  "to": {
    "phone_number": "+14155550100"
  },
  "text": {
    "body": "Can I book a repair?"
  }
}

{
  "direction": "outbound",
  "from": {
    "phone_number": "+14155550100"
  },
  "to": {
    "bsuid": "US.13491208655302741918"
  },
  "interactive": {
    "type": "request_contact_info",
    "body_text": "Share your number."
  }
}

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918",
    "phone_number": "+14155550101"
  },
  "contact_cards": [
    {
      "origin": "contact_request",
      "phone_numbers": [
        {
          "phone_number": "+14155550101"
        }
      ]
    }
  ]
}

अगर उपयोगकर्ता अनुरोध बंद कर देता है, तो आपको कोई संदेश या webhook नहीं मिलता। समय सीमा तय करें, ताकि आपका ऐप नंबर के बिना भी आगे बढ़ सके।

संदेश भेजें

to में BSUID और from में अपना WhatsApp बिज़नेस नंबर सेट करें:

{
  "to": "US.13491208655302741918",
  "from": "+14155550100",
  "text": { "body": "Your repair is booked." }
}

अगर आने वाले संदेश में केवल BSUID है, तो उसी बिज़नेस नंबर से उस BSUID पर जवाब दें। आपके अपने रिकॉर्ड के फ़ोन नंबर के लिए सेवा विंडो खुली नहीं भी हो सकती है, जिससे 422 E15044 मिलता है।

• प्रमाणीकरण टेम्पलेट के लिए फ़ोन नंबर ज़रूरी है।
• अमान्य फ़ोन नंबर या BSUID पर 422 E15001 मिलता है।
• संदेश की कीमत BSUID के देश कोड पर निर्भर करती है।

ग्राहक सेवा विंडो BSUID पर भी लागू होती है। 202 जवाब का मतलब है कि API ने आपका अनुरोध स्वीकार कर लिया है। डिलीवरी की पुष्टि के लिए संदेश का स्टेटस देखें।

संदेश खोजें

संदेशों और webhook में, from प्रेषक और to प्राप्तकर्ता की पहचान करता है। दोनों में phone_number, bsuid या दोनों हो सकते हैं।

संदेशों की सूची पाने के लिए इन फ़िल्टर का इस्तेमाल करें:

• प्रेषक या प्राप्तकर्ता के लिए from या to, उनके फ़ोन नंबर या BSUID के साथ।
• उसी WhatsApp उपयोगकर्ता को भेजे गए या उससे मिले संदेशों के लिए bsuid।

phone_number फ़िल्टर अब पुराना है। इसके बजाय from या to इस्तेमाल करें।

संबंधित गाइड

• संपर्क कार्ड प्राप्त करना
• WhatsApp संपर्क जानकारी के अनुरोध
• WhatsApp संदेश भेजना
• व्यवसाय-विशिष्ट यूज़र आईडी पर Meta का संदर्भ