बिज़नेस-स्कोप्ड यूज़र ID

बिज़नेस-स्कोप्ड यूज़र ID (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 भी बदल जाता है, इसलिए इसे अपनी ग्राहक ID के साथ स्टोर करें।

पैरेंट 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"
        }
      ]
    }
  ]
}

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

संदेश भेजें

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 ने आपका अनुरोध स्वीकार कर लिया है। डिलीवरी की पुष्टि के लिए संदेश की स्थिति जाँचें।

संदेश खोजें

संदेशों और वेबहुक में, from भेजने वाले की पहचान करता है और to प्राप्तकर्ता की। हर एक में phone_number, bsuid या दोनों हो सकते हैं।

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

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

phone_number फ़िल्टर अब बंद किया जा रहा है। इसके बजाय from या to का उपयोग करें।

संबंधित गाइड

• संपर्क कार्ड प्राप्त करना
• WhatsApp संपर्क जानकारी अनुरोध
• WhatsApp संदेश भेजना
• बिज़नेस-स्कोप्ड यूज़र ID के लिए Meta का संदर्भ