Identyfikatory użytkowników przypisane do firmy

Identyfikator użytkownika przypisany do firmy (BSUID) pozwala pisać do użytkownika WhatsApp bez jego numeru telefonu. Identyfikuje użytkownika w Twoim portfolio firmowym Meta.

Nazwy użytkowników WhatsApp

Użytkownicy WhatsApp z nazwą użytkownika mogą pisać do Ciebie bez udostępniania numeru telefonu. Ich wiadomości zawierają from.bsuid; from.phone_number może być nieobecne. Użytkownicy bez nazwy użytkownika też mogą mieć BSUID.

Meta dołącza numer telefonu, jeśli użytkownik jest w Twojej książce kontaktów Meta lub wymieniał wiadomości albo połączenia z Twoim numerem firmowym w ciągu ostatnich 30 dni. Reguła 30 dni obowiązuje osobno dla każdego numeru firmowego.

from.username i from.display_name są opcjonalne. Nie można wysyłać wiadomości na żadną z tych wartości.

Format BSUID

BSUID składa się z kodu kraju ISO 3166 alpha-2 zapisanego wielkimi literami, kropki i maksymalnie 128 liter lub cyfr. Na przykład: US.13491208655302741918.

Zapisuj i wysyłaj pełną wartość bez zmian. Używaj numeru nadawcy z tego samego portfolio firmowego. Meta odrzuca wiadomości wysłane z innych portfolio.

BSUID zmienia się, gdy użytkownik zmieni numer telefonu. Zapisuj go więc pod własnym identyfikatorem klienta.

Nadrzędny BSUID działa w portfolio zgłoszonych przez zarządzaną firmę. Zawiera dodatkowe ENT. po kodzie kraju: US.ENT.11815799212886844830. Limit 128 znaków dotyczy części po ENT.. Bird akceptuje oba formaty.

Poproś o numer telefonu

Te przykłady z API wiadomości pokazują tylko pola potrzebne w tej wymianie.

{
  "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"
        }
      ]
    }
  ]
}

Jeśli użytkownik zamknie prośbę, nie otrzymasz wiadomości ani webhooka. Ustaw limit czasu, aby aplikacja mogła kontynuować bez numeru.

Wyślij wiadomość

Ustaw to na BSUID, a from na swój numer firmowy WhatsApp:

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

Jeśli wiadomość przychodząca zawiera tylko BSUID, odpowiedz na ten BSUID z tego samego numeru firmowego. Numer telefonu z Twoich własnych danych może nie mieć otwartego okna obsługi, co spowoduje 422 E15044.

• Szablony uwierzytelniające wymagają numeru telefonu.
• Nieprawidłowy numer telefonu lub BSUID zwraca 422 E15001.
• Cena wiadomości zależy od kodu kraju w BSUID.

Okno obsługi klienta dotyczy też BSUID. Odpowiedź 202 oznacza, że API przyjęło żądanie. Sprawdź status wiadomości, aby potwierdzić doręczenie.

Znajdź wiadomości

W wiadomościach i webhookach from identyfikuje nadawcę, a to odbiorcę. Każde z nich może zawierać phone_number, bsuid lub oba pola.

Aby wyświetlić listę wiadomości, filtruj według:

• from lub to dla nadawcy lub odbiorcy, podając numer telefonu lub BSUID.
• bsuid dla wiadomości wysłanych do tego samego użytkownika WhatsApp lub od niego otrzymanych.

Filtr phone_number jest przestarzały. Zamiast niego używaj from lub to.

Powiązane przewodniki

• Odbieranie kart kontaktów
• Prośby o dane kontaktowe w WhatsApp
• Wysyłanie wiadomości WhatsApp
• Dokumentacja Meta dotycząca identyfikatorów użytkowników przypisanych do firmy