Sign inGet Started
Jetzt starten
Anleitungen
API-Referenz
SDKs
CLI
Wissensdatenbank
Changelog

Unternehmensbezogene Benutzer-IDs

Mit einer unternehmensbezogenen Benutzer-ID (BSUID) können Sie einem WhatsApp-Benutzer ohne dessen Telefonnummer schreiben. Sie identifiziert den Benutzer innerhalb Ihres Meta-Unternehmensportfolios.

WhatsApp-Benutzernamen

WhatsApp-Benutzer mit einem Benutzernamen können Ihnen schreiben, ohne ihre Telefonnummer zu teilen. Ihre Nachrichten enthalten from.bsuid; from.phone_number kann fehlen. Auch Benutzer ohne Benutzernamen können eine BSUID haben.

Meta übermittelt die Telefonnummer, wenn der Benutzer in Ihrem Meta-Kontaktbuch steht oder in den letzten 30 Tagen Nachrichten oder Anrufe mit Ihrer Geschäftsnummer ausgetauscht hat. Die 30-Tage-Regel gilt pro Geschäftsnummer.

from.username und from.display_name sind optional. An diese Werte können Sie keine Nachrichten senden.

BSUID-Format

Eine BSUID besteht aus einem ISO-3166-Alpha-2-Ländercode in Großbuchstaben, einem Punkt und bis zu 128 Buchstaben oder Ziffern. Beispiel: US.13491208655302741918.

Speichern und senden Sie den vollständigen Wert unverändert. Verwenden Sie eine Absendernummer aus demselben Unternehmensportfolio. Meta lehnt Nachrichten aus anderen Portfolios ab.

Eine BSUID ändert sich, wenn der Benutzer seine Telefonnummer ändert. Speichern Sie sie daher unter Ihrer eigenen Kunden-ID.

Eine übergeordnete BSUID gilt für die Portfolios, die ein betreutes Unternehmen dafür angemeldet hat. Sie ergänzt ENT. nach dem Ländercode: US.ENT.11815799212886844830. Die Grenze von 128 Zeichen gilt für den Teil nach ENT.. Bird akzeptiert beide Formate.

Eine Telefonnummer anfordern

Diese Beispiele aus der Nachrichten-API zeigen nur die für diesen Austausch benötigten Felder.

1. Der Benutzer schreibt Ihnen

Diese Nachricht enthält die BSUID des Benutzers, aber keine Telefonnummer.

Sie haben 24 Stunden, um ohne Vorlage zu antworten.

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

2. Fragen Sie nach der Nummer

Senden Sie eine Anfrage nach Kontaktinformationen an die BSUID. WhatsApp zeigt einen Button zum Teilen einer Telefonnummer an.

Außerhalb des 24-Stunden-Fensters senden Sie eine Vorlage mit einem request_contact_info-Button.

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

3. Der Benutzer tippt auf den Button

Sie erhalten eine Kontaktkarte mit origin: "contact_request" und der geteilten Nummer in phone_numbers.

In dieser Antwort enthält from auch die Telefonnummer des Benutzers.

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

Wenn der Benutzer die Anfrage schließt, erhalten Sie weder eine Nachricht noch einen Webhook. Legen Sie eine Zeitüberschreitung fest, damit Ihre App ohne die Nummer fortfahren kann.

Eine Nachricht senden

Setzen Sie to auf die BSUID und from auf Ihre WhatsApp-Geschäftsnummer:

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

Wenn die eingehende Nachricht nur eine BSUID enthält, antworten Sie von derselben Geschäftsnummer an diese BSUID. Für eine Telefonnummer aus Ihren eigenen Daten kann das Servicefenster geschlossen sein. Das führt zu 422 E15044.

  • Authentifizierungsvorlagen erfordern eine Telefonnummer.
  • Eine ungültige Telefonnummer oder BSUID gibt 422 E15001 zurück.
  • Der Nachrichtenpreis richtet sich nach dem Ländercode der BSUID.

Das Kundenservicefenster gilt auch für BSUIDs. Eine 202-Antwort bedeutet, dass die API Ihre Anfrage angenommen hat. Prüfen Sie den Nachrichtenstatus, um die Zustellung zu bestätigen.

Nachrichten finden

Bei Nachrichten und Webhooks bezeichnet from den Absender und to den Empfänger. Beide können phone_number, bsuid oder beides enthalten.

Um Nachrichten aufzulisten, filtern Sie nach:

  • from oder to für einen Absender oder Empfänger, anhand seiner Telefonnummer oder BSUID.
  • bsuid für Nachrichten an oder von demselben WhatsApp-Benutzer.

Der Filter phone_number ist veraltet. Verwenden Sie stattdessen from oder to.

Weitere Anleitungen

Verwandte Ressourcen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Übung ausprobieren und ein Implementierungs-Briefing erhalten