Telefonnummern und Zertifikate verwalten

Dieser Leitfaden bietet einen Überblick über Telefonnummern für Lösungspartner und Kund*innen. Darüber hinaus enthält er Prozessinformationen für Lösungspartner für den Fall, dass sie die Telefonnummer und Zertifikate von Kund*innen verwalten müssen.

Vorabinformationen zu Telefonnummern

Es gibt einige Details, die Unternehmen über Telefonnummern und Embedded Signup wissen müssen.

Unternehmen benötigen eine dedizierte Nummer, um WhatsApp über Embedded Signup verwenden zu können. Wenn ein Unternehmen über eine Nummer verfügt, die aktiv in WhatsApp Messenger oder der WhatsApp Business App registriert ist, kann es nicht dieselbe Telefonnummer verwenden.

Unternehmen können mehrere Telefonnummern mit ihrem Meta-Unternehmenskonto verknüpfen. Das heißt, sie müssen nur eine weitere Telefonnummer hinzufügen und diese für WhatsApp verwenden.

Ein Unternehmen kann sich über den Embedded Signup-Ablauf nicht mit einer Telefonnummer registrieren, die bereits bei den Business- oder Verbraucher*innen-Anwendungsversionen von WhatsApp registriert wurden.

Ausführlichere Informationen zu Telefonnummern und WhatsApp Business Platform findest du unter Telefonnummern.

Informationen zum Migrieren einer vorhandenen registrierten WhatsApp-Telefonnummer findest du unter Telefonnummer migrieren.

Anweisungen für Kund*innen

Dieser Abschnitt richtet sich an Kund*innen von Embedded Signup und enthält Informationen zu Maßnahmen, die sie im Zusammenhang mit Telefonnummern ergreifen können.

Einem WhatsApp Business-Konto Telefonnummern hinzufügen

Es gibt zwei Verfahren, um einem WhatsApp Business-Konto (WhatsApp Business Account, WABA) weitere Telefonnummern hinzuzufügen:

  1. [Empfohlen] Durchlaufe erneut den Embedded Signup-Ablauf, wähle den bestehenden Business Manager und das WABA, füge die Nummer hinzu und verifiziere sie.
  2. Navigiere im Business Manager zum Tab Telefonnummern von WhatsApp Manager und wähle Telefonnummer hinzufügen. Bei dieser Option muss die Telefonnummer vom Lösungspartner manuell verifiziert werden, da die Telefonverifizierung im Business Manager nicht verfügbar ist. Aus diesem Grund wird Unternehmen empfohlen, zum Hinzufügen weiterer Nummern den Embedded Signup-Ablauf zu befolgen.

Anweisungen für Lösungspartner

Dieser Abschnitt richtet sich an Lösungspartner und enthält Anweisungen zur Verwaltung von Telefonnummern und Zertifikaten von Kund*innen.

Telefonnummern für Cloud API registrieren

Nach einer erfolgreichen Telefonverifizierung über den Embedded Signup-Ablauf sollte die Registrierung mit einem API-Aufruf am register-Endpunkt erfolgreich sein. Gib dazu eine beliebige code_method (sms | voice) an. Da die Telefonnummer bereits verifiziert ist, musst du dir über den Registrierungscode keine Gedanken machen. Der verify-API-Aufruf ist nicht erforderlich.

Alternativ kannst du Telefonnummern vorab verifizieren und sie deinen Kund*innen im Rahmen des Embedded Signup-Ablaufs anbieten. So müssen Kund*innen dich während des Freischaltungsprozesses nicht kontaktieren, um ein Einmalpasswort zu erhalten. Siehe Vorab verifizierte Telefonnummern.

Telefonnummern für lokale Umgebungen registrieren

Nach einer erfolgreichen Telefonverifizierung über den Embedded Signup-Ablauf sollte die Registrierung mit einem API-Aufruf am account-Endpunkt erfolgreich sein. Gib dazu eine beliebige code_method (sms | voice) an. Da die Telefonnummer bereits verifiziert ist, musst du dir über den Registrierungscode keine Gedanken machen. Der verify-API-Aufruf ist nicht erforderlich.

Alternativ kannst du Telefonnummern vorab verifizieren und sie deinen Kund*innen im Rahmen des Embedded Signup-Ablaufs anbieten. So müssen Kund*innen dich während des Freischaltungsprozesses nicht kontaktieren, um ein Einmalpasswort zu erhalten. Siehe Vorab verifizierte Telefonnummern.

Eine Telefonnummer muss bis spätestens 14 Tage, nachdem sie den Prozess der eingebetteten Anmeldung durchlaufen hat, registriert werden. Wenn eine Telefonnummer nicht innerhalb dieses Zeitraums registriert wird, muss sie den Prozess der eingebetteten Anmeldung erneut durchlaufen, bevor sie registriert werden kann.

Telefonstatus und Zertifikat abrufen

Mit dem Endpunkt phone_numbers kannst du nach einer Namensänderung den Status des Display-Namens einer Telefonnummer ermitteln und das Zertifikat abrufen. Weitere Informationen findest du unter Telefonnummern lesen.

Beispielanfrage

Verwende im folgenden Beispiel die ID für den zugewiesenen WABA.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"
Die ID eines WhatsApp Business-Kontos findest du unter Business Manager > Unternehmenseinstellungen > Konten > WhatsApp Business-Konten. Suche dort nach dem Konto, das zu verwenden möchtest, und klicke darauf. Es wird eine Ansicht mit Informationen zum Konto angezeigt, einschließlich der ID.

Beispielantwort

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

Antwortparameter

NameBeschreibung

name_status

Der Prüfstatus der aktuellen Anfrage für den Display-Namen

Klicke auf den Pfeil in der linken Spalte, um die verfügbaren Optionen anzuzeigen.

Verfügbare Optionen

  • APPROVED: Der Name wurde genehmigt. Du kannst dein Zertifikat jetzt herunterladen.
  • DECLINED: Der Name wurde nicht genehmigt. Du kannst dein Zertifikat nicht herunterladen.
  • EXPIRED: Dein Zertifikat ist abgelaufen und du kannst es nicht mehr herunterladen.
  • PENDING_REVIEW: Deine Namensanfrage wird geprüft. Du kannst dein Zertifikat nicht herunterladen.
  • NONE: Es ist kein Zertifikat verfügbar.

new_name_status

Der Prüfstatus einer Änderungsanfrage des Display-Namens Dieses Feld gibt nur dann Daten zurück, wenn eine Änderung des Display-Namens angefordert wurde.

certificate

Gibt das aktuelle Zertifikat für diese Telefonnummer zurück.

new_certificate

Das Zertifikat eines neuen Display-Namens, nachdem die Namensänderung genehmigt wurde. Dieses Feld gibt nur dann Daten zurück, wenn die angeforderte Display-Namensänderung genehmigt wurde, und ist so lange verfügbar, bis die Telefonnummer mit dem neuen Zertifikat registriert wurde.

OTP-Status des Telefons abrufen

Um festzustellen, ob eine Telefonnummer mittels Einmalpasswort (One Time Password, OTP) verifiziert wurde, überprüfe das Feld code_verification_status der Nummer. Starte zunächst einen GET-Aufruf an den Endpunkt /{whatsapp-business-account-id}/phone_numbers:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

Die Antwort enthält den „code_verification_status“ mit einer der folgenden Optionen: VERIFIED oder NOT_VERIFIED. Eine Antwort sieht zum Beispiel wie folgt aus:

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

Alternativ kannst du den Status durch Abfragen der ID einer Telefonnummer erhalten:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"
Um die ID einer Telefonnummer abzurufen, führe einen Aufruf an https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers aus. Ersetze {whatsapp-business-account-ID} durch die ID des WhatsApp Business-Kontos, zu dem die Telefonnummer gehört. Ein Beispiel findest du unter Alle Telefonnummern abrufen.

Telefonnummern nach „Account Mode“ filtern

Du kannst Telefonnummern abfragen und sie basierend auf ihrem account_mode filtern. Für die Anfrage kannst du die unten aufgeführten Parameter verwenden.

Anfrageparameter

NameBeschreibung

field

Enthält das Feld, das zum Filtern verwendet wird. In diesem Beispiel solltest du account_mode verwenden.

operator

Gibt an, wie du die Accounts filtern möchtest. In diesem Beispiel solltest du EQUAL verwenden.

value

Gibt an, nach welchem Kontomodus du suchst.

Klicke auf den Pfeil in der linken Spalte, um unterstützte Werte anzuzeigen.

Unterstützte Werte

  • SANDBOX: Das Konto ist nicht verifiziert.

  • LIVE: Das Konto ist für die nicht verifizierte Testversion nicht berechtigt oder wurde auf ein verifiziertes Konto aktualisiert.

Beispielanfrage

Verwende im folgenden Beispiel die ID für den zugewiesenen WABA.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

Beispielantwort

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}