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:
- [Empfohlen] Durchlaufe erneut den Embedded Signup-Ablauf, wähle den bestehenden Business Manager und das WABA, füge die Nummer hinzu und verifiziere sie.
- 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}"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
| Name | Beschreibung |
|---|---|
| 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. |
| Der Prüfstatus einer Änderungsanfrage des Display-Namens Dieses Feld gibt nur dann Daten zurück, wenn eine Änderung des Display-Namens angefordert wurde. |
| Gibt das aktuelle Zertifikat für diese Telefonnummer zurück. |
| 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}"
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
| Name | Beschreibung |
|---|---|
| Enthält das Feld, das zum Filtern verwendet wird. In diesem Beispiel solltest du |
| Gibt an, wie du die Accounts filtern möchtest. In diesem Beispiel solltest du |
| Gibt an, nach welchem Kontomodus du suchst. Klicke auf den Pfeil in der linken Spalte, um unterstützte Werte anzuzeigen. |
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"
}
}
}