Bedrijfsgebonden gebruikers-ID's

Met een bedrijfsgebonden gebruikers-ID (BSUID) kun je een WhatsApp-gebruiker berichten sturen zonder diens telefoonnummer. De ID identificeert de gebruiker binnen je Meta-bedrijfsportfolio.

WhatsApp-gebruikersnamen

WhatsApp-gebruikers met een gebruikersnaam kunnen je berichten sturen zonder hun telefoonnummer te delen. Hun berichten bevatten from.bsuid; from.phone_number kan ontbreken. Ook gebruikers zonder gebruikersnaam kunnen een BSUID hebben.

Meta geeft het telefoonnummer mee als de gebruiker in je Meta-contactenboek staat of in de afgelopen 30 dagen berichten of oproepen met je bedrijfsnummer heeft uitgewisseld. De regel van 30 dagen geldt per bedrijfsnummer.

from.username en from.display_name zijn optioneel. Je kunt naar geen van beide waarden berichten sturen.

BSUID-formaat

Een BSUID bestaat uit een ISO 3166 alpha-2-landcode in hoofdletters, een punt en maximaal 128 letters of cijfers. Bijvoorbeeld: US.13491208655302741918.

Bewaar en verstuur de volledige waarde ongewijzigd. Gebruik een afzendernummer uit hetzelfde bedrijfsportfolio. Meta weigert berichten vanuit andere portfolio's.

Een BSUID verandert als de gebruiker van telefoonnummer verandert. Sla de ID daarom op onder je eigen klant-ID.

Een bovenliggende BSUID werkt binnen de portfolio's die een beheerd bedrijf heeft aangemeld. Deze voegt ENT. toe na de landcode: US.ENT.11815799212886844830. De limiet van 128 tekens geldt voor het deel na ENT.. Bird accepteert beide formaten.

Een telefoonnummer vragen

Deze voorbeelden uit de berichten-API tonen alleen de velden die voor deze uitwisseling nodig zijn.

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

Als de gebruiker het verzoek sluit, ontvang je geen bericht of webhook. Stel een time-out in zodat je app zonder het nummer kan doorgaan.

Een bericht sturen

Stel to in op de BSUID en from op je WhatsApp-bedrijfsnummer:

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

Als het inkomende bericht alleen een BSUID bevat, antwoord dan naar die BSUID vanaf hetzelfde bedrijfsnummer. Een telefoonnummer uit je eigen gegevens heeft mogelijk geen open servicevenster. Dat leidt tot 422 E15044.

• Authenticatietemplates vereisen een telefoonnummer.
• Een ongeldig telefoonnummer of een ongeldige BSUID geeft 422 E15001 terug.
• De berichtprijs hangt af van de landcode van de BSUID.

Het klantenservicevenster geldt ook voor BSUID's. Een 202-antwoord betekent dat de API je verzoek heeft geaccepteerd. Controleer de berichtstatus om de aflevering te bevestigen.

Berichten zoeken

Bij berichten en webhooks geeft from de afzender aan en to de ontvanger. Beide kunnen phone_number, bsuid of allebei bevatten.

Om berichten op te vragen, filter je op:

• from of to voor een afzender of ontvanger, met diens telefoonnummer of BSUID.
• bsuid voor berichten van of aan dezelfde WhatsApp-gebruiker.

Het filter phone_number is verouderd. Gebruik in plaats daarvan from of to.

Gerelateerde handleidingen

• Contactkaarten ontvangen
• Verzoeken om contactgegevens in WhatsApp
• WhatsApp-berichten versturen
• Meta-referentie voor bedrijfsgebonden gebruikers-ID's