Telefonnummer-Migration zur WhatsApp Cloud API

Vorteile der Migration zur WhatsApp Cloud API

WhatsApp Cloud API ist eine neue Plattform, die Unternehmen eine direkte Verbindung zur WhatsApp's Infrastruktur bietet und eine Self-Service-Option im Vergleich zu WhatsApp Partnern (BSPs). Einige Vorteile der Nutzung der WhatsApp Cloud API sind:

eine kostengünstigere Option.
eine zuverlässigere und stabilere Verbindung zur Plattform.
die Fähigkeit, kundenspezifische Integrationen zu entwickeln, die Ihren spezifischen geschäftlichen Anforderungen entsprechen.
eine flexible und skalierbare Lösung für Unternehmen aller Größen.

Erfahren Sie mehr über WhatsApp Cloud API hier.

Was wird migriert?

Beachten Sie, dass die folgenden Elemente von WhatsApp BSP in die WhatsApp Cloud API migriert werden können.

Kann migriert werden

Telefonnummer des Kontos zugeordnet.
Alle zuvor genehmigten hochwertigen Nachrichtenvorlagen.
Zeigt den Namen der Telefonnummer an.
Qualitätsbewertung der Telefonnummer.
Grenzen für Nachrichten.
Offizielle WABA-Status.

Kann nicht migriert werden

Niedrige Qualität, abgelehnte oder ausstehende Nachrichtenvorlagen.

Vormigrationsvoraussetzungen: Was bereiten Sie sich auf Ihr Migration-Setup vor

Beachten Sie Phrasen, die in diesem Dokument häufig verwendet werden:
-Source WABA: Die WhatsApp BSP von der wir migrieren.
-Ziel WABA: Die WhatsApp Cloud API, auf die wir migrieren.

Checkliste für Migrationsvoraussetzungen:

Vorhandene Meta-Entwickler-App: Wenn Sie keine Entwickler-App erstellt haben, hier klicken, um Ihre App im Meta Business Manager (MBM) zu erstellen und mit der WhatsApp Cloud API zu starten. Diese App muss unter demselben Geschäftskonto (Business-ID) wie die Quelle WABA erstellt werden.
Business-ID: Die Quell- und Ziel-WABAs müssen mit dem gleichen MBM assoziiert sein oder die gleiche Business-ID haben.
Unternehmensüberprüfung: Die Business-ID muss überprüft werden. Wenn Ihr Unternehmen noch nicht verifiziert ist, befolge diese Schritte, um es zu verifizieren.
WABA Review-Status: Der Review-Status des Quell- und Ziel-WABAs muss genehmigt werden.
Zahlung Methode: Eine Zahlungsmethode muss sowohl für die Quelle als auch für das Ziel WABA konfiguriert werden. Stellen Sie sicher, dass die Zahlungsmethode sowohl an der Quelle als auch am Zielort eingerichtet ist.
Zwei-Schritt-Verifizierung: Zwei-Schritt-Verifizierung muss auf der zu migrierenden Telefonnummer deaktiviert werden.

Wenn all dies überprüft und abgeschlossen ist, kann der Migrationsprozess fortgesetzt werden.

Konfigurieren von Telefonnummern und WABA-IDs

Meta hat die WABA-IDs so konzipiert, dass sie nicht migrierbar sind. Aufgrund bestimmter Einschränkungen wurde eine Problemumgehung als Lösung implementiert. Für die Migration von Telefonnummern müssen sowohl Quell- als auch Ziel-WABA-IDs unter dem gleichen Meta-Manager-Konto liegen. Das bedeutet, dass die Migration einer Telefonnummer nur zur Übertragung dieser Nummer zwischen WABAs führt und keine weiteren Änderungen zulässt. Um eine Telefonnummer erfolgreich zu migrieren, müssen folgende Schritte durchgeführt werden:

Fügen Sie eine neue Nummer zum Ziel WABAhinzuformat@@1 : Dies generiert eine neue WABA-ID für die Nummer, auf die Sie migrieren möchten. Sie können diesen Schritt überspringen, wenn Sie eine vorhandene WABA mit einer Zahl haben, die nicht mehr verwendet wird.

Erfahren Sie mehr über die Verbindung von Telefonnummern mit der WhatsApp Cloud API hier.

Lösche die neue Nummer aus dem Zielort WABA: Damit wird ein Platz für eine Nummer freigegeben, die zum Ziel WABA hinzugefügt werden soll. Alternativ können Sie diese Zahl löschen, wenn Sie eine nicht verwendete Nummer haben.

Sobald die Nummer gelöscht wurde, migrieren Sie die aktuelle Nummer des Kunden'in das neue WhatsApp-Geschäft.

API-Dokumentation für den Migrationsprozess

Das ist derzeit wichtig zu beachten. diese in der API-Dokumentation beschriebenen Migrationsschritte können nur von einem Entwickler oder einer Person mit ähnlichem technischen Hintergrund ausgeführt werden. Allerdings, Wir verstehen, dass dies eine Einschränkung für einige sein kann und arbeiten daran, in Zukunft eine benutzerfreundlichere und zugänglichere Lösung zu entwickeln. Brauchst du Hilfe? Kontaktieren Sie unshier!

Schritt 1: Migration der Telefonnummer beginnen

Callback URL:

POST <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>

Name	In	Benötigt	Typ	Beschreibung
version	pfad	Richtig	string	Die API-Version.
wabaId	pfad	Richtig	string	Die WhatsApp Cloud API WABA ID.

Gehen Sie zu Business Manager > Business Settings > Accounts > WhatsApp Business Accounts , um die ID eines WhatsApp Business Accounts zu finden. Wählen Sie das Konto, das Sie verwenden möchten. Ein Panel mit Kontoinformationen, einschließlich der ID wird angezeigt.

Parameter

Kopfzeile

Autorisierung: Bearer {Access Token}

Der Systembenutzer generiert Ihr Zugangs-Token in der Registerkarte WhatsApp Business Accounts des Business Managers. Lesen Sie diese Anleitung , um zu erfahren, wie Sie auf den Systembenutzer zugreifen und einen erstellen oder kopieren.

Körper

Name	Typ	Beschreibung
cc	num	Numerische Landesvorwahl für die registrierte Telefonnummer: Plus (+) Zeichen wird für Landesvorwahl nicht benötigt.
phone_nummer	num	Telefonnummer wird migriert, ohne Landesvorwahl oder Plus-Symbol (+).
migrate_phone_number	boolean	Auf true setzen, um die Telefonnummer zu migrieren.

Status

Name	Beschreibung
200 OK	Erfolgreich.

Antwort

{ "id": "phoneNumberId" }

Schritt 2: Codeanfrage (PIN) zum Verifizieren des Telefonbesitzes

Callback URL

POST <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>

Name	In	Benötigt	Typ	Beschreibung
version	pfad	Richtig	string	Die API-Version.
phoneNumberId	pfad	Richtig	string	Dies ist die Antwort, die in Schritt 1 zurückgegeben wird. Kopieren und Einfügen der Nummer in die Callback-URL in diesem Schritt.

Parameter

Kopfzeile

Autorisierung: Bearer {Access Token}

Körper

Name	Typ	Beschreibung
-Methode	enum	Methode des Empfangs des Registrierungs-Codes. Unterstützte Werte: SMS und Stimme.
sprache	enum	Sprache, in der Sie den Registrierungscode erhalten möchten. Siehe Sprachcodes.

Status

Name	Beschreibung
200 OK	Erfolgreich.

Antwort

{ "Erfolg": true }

Der Code wurde an die Telefonnummer gesendet, die über die gewählte Methode migriert wird (SMS oder Voice).

Schritt 3: Überprüfen Sie den Code

Callback URL

POST: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>

Der Code (6-stellige Pin) erhalten in der Telefonnummer von Schritt 2 wird verwendet, um das Eigentum zu überprüfen.

Parameter

Kopfzeile

Autorisierung: Bearer {Access Token}

Körper

Name	Typ	Beschreibung
kode	num	6-stelligen Registrierungscode erhalten nach dem Abschluss von Schritt 2.

Status

Name	Beschreibung
200 OK	Erfolgreich.

Antwort

{ "Erfolg": true }

Bestätigt, dass der Telefonbesitz verifiziert ist.

Schritt 4: Telefonnummer registrieren

Callback URL

POST <https://graph.facebook.com/{version}/{phoneNumberId}/register>

Parameter

Kopfzeile

Autorisierung: Bearer {Access Token}

Körper

Name	Typ	Beschreibung
messaging_product	enum	Nachrichtendienst verwendet. In diesem Fall verwenden Sie "whatsapp".
pin	num	6-stellige Registrierungscode erhalten nach Schritt 2.

Status

Name	Beschreibung
200 OK	Erfolgreich.

Antwort

{ "Erfolg": true }

Die Telefonnummer wurde erfolgreich in der WhatsApp Cloud API WABA registriert. Sie können nun Nachrichten an Ihr Ziel WABA senden.

WABA ID wird nicht migriert. Die neu migrierte Nummer wird der WABA-ID der zuvor gelöschten Zahl zugeordnet.

Schritt 5: Überprüfen Sie die migrierte Telefonnummer in der Meta-Entwickler-App

Eine erfolgreiche Migration kann durch die Meta Developer App verifiziert werden. Um dies zu tun, folgen Sie diesen Schritten:

Navigiere zu WhatsApp > Startet
Bestätigen Sie in der Dropdown-Liste der Telefonnummern, dass die Nummer vorhanden und korrekt reflektiert ist.