WhatsApp Business Management API

Telefonnummern zwischen WhatsApp-Unternehmenskonten über Embedded Signup migrieren

In diesem Dokument wird beschrieben, wie du mit Embedded Signup Unternehmenstelefonnummern von einem WhatsApp-Unternehmenskonto (WhatsApp Business Account, WABA) zu einem anderen migrierst.

Kund*innen können ihre Unternehmenstelefonnummern zwischen WhatsApp-Unternehmenskonten (WhatsApp Business Accounts, WABAs) migrieren und ihre Display-Namen, Qualitätsbewertungen, Nachrichten-Limits für Vorlagen, offizielle Unternehmenskonten und genehmigte, hochwertige Vorlagen beibehalten Die Migration wird normalerweise nur durchgeführt, wenn ein*e Kund*in seine*ihre Unternehmenstelefonnummer von einem Lösungspartner zu einem anderen verschieben möchte.

Um eine Migration für eine*n Kund*in durchzuführen, hast du zwei Möglichkeiten: die Migration über Embedded Signup oder die programmgesteuerte Migration.

Die Migration über Embedded Signup ist einfacher und die bevorzugte Lösung, da sie von deinen Kund*innen initiiert werden kann, automatisch alle erforderlichen Assets generiert und deren Inbesitznahme gewährt, deiner App Zugriff auf diese Assets gewährt und weniger API-Aufrufe erfordert.

Die programmgesteuerte Migration muss von dir initiiert werden und beinhaltet zusätzliche API-Aufrufe, da du überprüfen musst, dass abhängige Assets korrekt konfiguriert sind, und alle neuen benötigten Assets selbst generieren und sie zu anderen Assets zuordnen musst. Aus diesem Grund wird die programmgesteuerte Migration nur dann empfohlen, wenn du mit dem*der Kund*in nach dem On-Behalf-Of-Modell zusammenarbeitest (d. h. du erstellst und besitzt das Ziel-WABA und seine Assets und teilst sie mit dem*der Kund*in).

Wenn du Kund*innentelefonnummern programmgesteuert migrieren möchtest, lies unser Dokument Telefonnummern zwischen WhatsApp-Unternehmenskonten über Embedded Signup migrieren.

So funktioniert’s

Kund*innen können deine Implementierung von Embedded Signup (Version 2) verwenden, um den Migrationsprozess zu starten. Beim Embedded Signup werden Kund*innen dazu aufgefordert, ihre Unternehmenstelefonnummer und einen neuen Ziel-WABA (WhatsApp Business Account) einzugeben.

Wenn der*die Kund*in den Ablauf abschließt, generiert Embedded Signup seinen*ihren neuen WABA, verknüpft ihn mit seinem*ihrem Meta-Business-Portfolio, gewährt deiner App Zugriff auf den WABA und gibt dann die neu erstellte WABA-ID und die Unternehmenstelefonnummern-ID zurück.

Du musst diese IDs erfassen und zusammen mit der API verwenden, um deine Kreditlinie zu teilen, Webhooks zu abonnieren und die Nummer für die Verwendung mit der Cloud API zu registrieren. Sobald du den letzten Schritt (Registrierung) abgeschlossen hast, wird die Unternehmenstelefonnummer dem Ziel-WABA zugeordnet und die Nummer kann anschließend wieder zum Senden und Empfangen von Nachrichten verwendet werden.

Da sich die Unternehmenstelefonnummer des*der Kund*in nicht ändert, bleiben der Display-Name, die Qualitätsbewertung, das Nachrichten-Limit und der Status des offiziellen Unternehmenskontos erhalten.

Darüber hinaus werden alle berechtigten Vorlagen automatisch im Ziel-WABA dupliziert und erhalten denselben Status wie ihre Gegenstücke in der Quelle, und alle auf die Unternehmenstelefonnummer des*der Kund*in hochgeladenen Medien können weiterhin verwendet werden.

WhatsApp-Unternehmenskonten

Embedded Signup generiert automatisch den neuen WABA des*der Kund*in, verknüpft ihn mit dem entsprechenden Meta-Unternehmenskonto und gewährt deiner App Zugriff auf den WABA.

Vorlagen

Templates are automatically duplicated in the destination WABA and granted the same quality ratings and statuses as their source counterparts. The duplicated templates will be subjected to Template Categorization Guidelines checks to ensure that the templates are correctly categorized. This may result in some of the duplicated templates being REJECTED.

Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA'S template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.

Please note that the quality ratings of templates will NOT be migrated. All migrated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.

Abrechnung

Messages sent before migration is complete are charged to the old Solution Partner. Undelivered messages sent before migration is complete will be charged to the old Solution Partner if they are delivered after migration is complete.

Messages sent after migration is complete are charged to the new Solution Partner.

Ausfallzeit bei Vorlagen

Die Registrierung geschäftlicher Telefonnummern erfolgt unmittelbar, sodass du Nachrichten weiterhin ohne Unterbrechung senden und empfangen kannst.

Da die Duplizierung von Vorlagen jedoch Zeit in Anspruch nimmt, kannst du die betroffenen Vorlagen erst verwenden, wenn sie migriert wurden.

Um diese Ausfallzeit zu vermeiden, kannst du mit der Migration der Vorlagen beginnen, bevor du die Telefonnummern registrierst.

Durchsatzratenbegrenzungen

Wenn die Vorlagenduplizierung automatisch als Teil des Migrationsprozesses ausgelöst wird, wird dies nicht im Rahmen der Ratenbegrenzung angerechnet. API-Aufrufe, die du durchführst, werden jedoch angerechnet.

Einschränkungen

  • Von WhatsApp herausgegebene Testtelefonnummern für Unternehmen können nicht migriert werden.
  • Migrierte Unternehmenstelefonnummern können nur zur Verwendung mit der Cloud API registriert werden.
  • Der Chatverlauf und hochgeladene Medien werden nicht migriert, wenn sich die WABA-Quelle auf der On-Premises API befindet.
  • Unternehmenstelefonnummern müssen über einen genehmigten Display-Namen verfügen (name_status ist APPROVED).
  • Unternehmenstelefonnummern dürfen über keine zugehörigen ausstehenden Anträge zur Änderung des Display-Namen verfügen.
  • Die Qualitätsbewertung von Vorlagen wird NICHT migriert. Alle migrierten Vorlagen beginnen mit einer Qualitätsbewertung von UNKNOWN. Diese Qualitätsbewertung bleibt für die ersten 24 Stunden bestehen, danach wird eine neue Bewertung generiert, wenn genügend Daten verfügbar sind.

Anforderungen

Kund*innen

Bitte den*die Kund*in, dem*der die Unternehmenstelefonnummer gehört, zu bestätigen, dass er*sie die folgenden Anforderungen erfüllt. Kund*innen können dies über den Meta Business Manager tun, wenn sie ihren WABA besitzen, indem sie WhatsApp-Konten > (ihren WABA-Namen) > Einstellungen aufrufen. Wenn sie ihren WABA nicht besitzen, müssen sie ihren BSP um Bestätigung bitten.

  • Das Meta-Unternehmenskonto muss einen verifizierten Status haben.
  • Das bestehende WABA der Kund*innen muss einen genehmigten Status haben.
  • Der bestehende WABA muss eine gültige Zahlungsmethode hinterlegt haben (unter Zahlungseinstellungen).
  • Die Verifizierung in zwei Schritten muss für die Unternehmenstelefonnummer deaktiviert werden. Kund*innen, die ihren WABA besitzen, können den WhatsApp Manager verwenden, um die Verifizierung in zwei Schritten für ihre Nummer zu deaktivieren, sonst müssen sie ihren Lösungsanbieter bitten, diese für sie zu deaktivieren.

Lösungsanbieter

Mindestens eine App muss bereits Webhooks auf dem Ziel-WABA abonniert haben (siehe Webhooks), und du musst Embedded Signup Version 2 mit aktivierter Sitzungsprotokollierung verwenden.

Migrationsschritte

Schritt 1: Kund*innen anweisen, die Verifizierung in zwei Schritten zu deaktivieren

Falls du dies noch nicht getan hast, weise deine Kund*innen an, den WhatsApp Manager zu verwenden, um die Verifizierung in zwei Schritten für seine*ihre Unternehmenstelefonnummer zu deaktivieren (oder seinen*ihren aktuellen Lösungsanbieter zu bitten, diese für ihn*sie zu deaktivieren).

Du kannst die restlichen Schritte erst durchführen, wenn die Verifizierung in zwei Schritten deaktiviert ist.

Schritt 2: Embedded Signup bereitstellen

Weise den*die Kund*in an, auf deine Implementierung von Embedded Signup (Version 2) zuzugreifen und seine*ihre Unternehmenstelefonnummer und seinen*ihren Display-Namen anzugeben, wenn er*sie im Vorgang dazu aufgefordert wird.

Schritt 3: Asset-IDs erfassen

Wenn der*die Kund*in den Vorgang abgeschlossen hat, erfasse die Unternehmenstelefonnummer-ID und den neuen WABA, der im Message-Event zurückgegeben wurde.

Schritt 4: Deine Kreditlinie teilen

Teile deine Kreditlinie mit dem WABA wie üblich, nachdem du das Onboarding eines*einer Kund*in über Embedded Signup abgeschlossen hast.

Schritt 5: Webhooks abonnieren

Abonniere Webhooks für deine App auf dem neuen WABA des*der Kund*in.

Schritt 6: Registriere die Telefonnummer für die Cloud API

Registriere die Unternehmenstelefonnummer für die Verwendung mit der Cloud API (du kannst eine migrierte Unternehmenstelefonnummer nicht für die Verwendung mit der On-Premises API registrieren).

Problembehebung

Wenn die Vorlagenmigration fehlschlägt, findest du in der folgenden Dokumentation Anweisungen zum manuellen Auslösen einer Vorlagenmigration: Vorlagenmigration.