Registrierung
Damit du deine Unternehmenstelefonnummer mit der Cloud API verwenden kannst, musst du sie registrieren. Registriere deine Unternehmenstelefonnummer in folgenden Szenarien:
- Kontoerstellung: Wenn du diese API implementierst, musst du die Unternehmenstelefonnummer registrieren, die du verwenden möchtest, um Nachrichten zu senden. Um deinen Konten eine weitere Sicherheitsebene hinzuzufügen, setzen wir während der Kontoerstellung die Einrichtung einer Verifizierung in zwei Schritten durch.
- Namensänderung: In diesem Fall ist deine Telefonnummer bereits registriert und du möchtest deinen Display-Namen ändern. Um dies zu tun, musst du zunächst eine Namensänderung im WhatsApp Manager beantragen. Sobald der Name genehmigt wurde, musst du deine Telefonnummer unter dem neuen Namen erneut registrieren.
- Migration deiner Nummer von der On-Premises API zur Cloud API. Siehe Ausnahme bei Migration.
Bevor du deine Unternehmenstelefonnummer registrieren kannst, musst du zuerst die Inhaberschaft verifizieren.
Ausnahme bei Migration
Wenn du eine Telefonnummer von der On-Premises API zur Cloud API migrierst, musst du zusätzliche Schritte durchlaufen, bevor du eine Telefonnummer bei der Cloud API registrierst. Den gesamten Prozess findest du unter Migration zwischen On-Premises und Cloud API.
Eine Unternehmenstelefonnummer registrieren
Sende zur Registrierung deiner verifizierten Unternehmenstelefonnummer eine POST-Anfrage an PHONE_NUMBER_ID/register. Beziehe die unten aufgelisteten Parameter ein.
| Endpunkt | Authentifizierung |
|---|---|
(Siehe ID der Telefonnummer abrufen) |
Solution Partners must authenticate themselves with an access token with the |
Einschränkungen
Anfragen an den Registrierungsendpunkt sind auf 10 Anfragen pro Unternehmensnummer in einem gleitenden Zeitfenster von 72 Stunden begrenzt.
Bei einer Registrierungsanfrage prüfen wir, wie viele Registrierungsanfragen du in den letzten 72 Stunden zur Registrierung dieser Nummer gestellt hast. Wenn du bereits 10 Anfragen gestellt hast, gibt die API den Fehlercode 133016 zurück und die Nummer kann innerhalb der nächsten 72 Stunden nicht registriert werden.
Parameter
| Name | Beschreibung |
|---|---|
| Erforderlich. Verwendeter Messaging-Dienst. Lege hierfür |
| Erforderlich. Wenn für deine verifizierte Unternehmenstelefonnummer bereits die Verifizierung in zwei Schritten aktiviert ist, lege für diesen Wert die sechsstellige PIN deiner Nummer für die Verifizierung in zwei Schritten fest. Wenn du deine PIN nicht mehr weißt, kannst du sie aktualisieren. Wenn für deine verifizierte Unternehmenstelefonnummer noch keine Verifizierung in zwei Schritten aktiviert ist, lege für diesen Wert eine sechsstellige PIN fest. Diese ist die PIN der neu verifizierten Unternehmenstelefonnummer für die Verifizierung in zwei Schritten. |
| Optional. Falls enthalten, wird das lokale Speichern für die Unternehmenstelefonnummer aktiviert. Der Wert muss ein ISO 3166-Länderkennzeichen mit zwei Buchstaben sein (z. B. Unterstützte Werte: APAC
Europa
LATAM
MEA
NORAM
Sobald der Parameter aktiviert ist, kann er nicht direkt deaktiviert oder geändert werden. Stattdessen musst du die Nummer deregistrieren und ohne diesen Parameter erneut registrieren (zum Deaktivieren) oder den Parameter mit dem neuen Länderkennzeichen hinzufügen (zum Ändern). Um die lokale Speicherung für eine bereits registrierte Nummer zu aktivieren, musst du die Nummer deregistrieren, sie anschließend erneut registrieren und diesen Parameter angeben. |
Beispielanfrage ohne lokale Speicherung
curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834"
}
Beispielanfrage mit lokaler Speicherung
curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834",
"data_localization_region": "CH"
}
All API calls require authentication with access tokens.
Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.
Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.
Deregistrierung einer Unternehmenstelefonnummer
Durch die Deregistrierung einer Unternehmenstelefonnummer kann diese nicht mehr mit der Cloud API verwendet werden und die lokale Speicherung der Nummer wird deaktiviert, sofern diese aktiviert wurde.
Durch die Deregistrierung wird die Nummer und der entsprechende Nachrichtenverlauf nicht gelöscht. Informationen zum Löschen einer Nummer und ihres Verlaufs findest du unter Telefonnummer aus einem WABA löschen.
Sende zur Deregistrierung einer Unternehmenstelefonnummer eine POST-Anfrage an PHONE_NUMBER_ID/deregister:
| Endpunkt | Authentifizierung |
|---|---|
(Siehe ID der Telefonnummer abrufen) |
Solution Partners must authenticate themselves with an access token with the |
Einschränkungen
Anfragen an den Deregistrierungsendpunkt sind auf 10 Anfragen pro Unternehmenstelefonnummer in einem gleitenden Zeitfenster von 72 Stunden beschränkt.
Bei einer Deregistrierungsanfrage prüfen wir, wie viele Deregistrierungsanfragen du in den letzten 72 Stunden gestellt hast, um diese Nummer zu deregistrieren. Wenn du bereits 10 Anfragen gestellt hast, gibt die API den Fehlercode 133016 zurück und die Nummer kann innerhalb der nächsten 72 Stunden nicht deregistriert werden.
Beispiel
Beispielanfrage:
curl -X POST \
'https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER_ID/deregister' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Eine erfolgreiche Antwort sieht wie folgt aus:
{
"success": true
}