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-Konto, 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

Vorlagen werden automatisch im Ziel-WABA dupliziert und erhalten die gleichen Qualitätsbewertungen und Status wie deren Gegenstücke in der Quelle.

Nur Vorlagen mit einem status von APPROVED und quality_score von GREEN sind für die Duplizierung berechtigt. Wenn der Ziel-WABA nicht alle neuen Vorlagen aufnehmen kann, werden so viele Vorlagen wie möglich dupliziert, bis das Vorlagenlimit des Ziel-WABA erreicht ist. Nicht duplizierte Vorlagen müssen neu erstellt und zur Genehmigung übermittelt werden, wenn sie im Ziel-WABA verwendet werden sollen.

Abrechnung

Nachrichten, die vor Abschluss der Migration gesendet werden, werden dem alten Lösungspartner in Rechnung gestellt. Nicht zugestellte Nachrichten, die vor Abschluss der Migration gesendet werden, werden dem alten Lösungspartner in Rechnung gestellt, wenn sie nach Abschluss der Migration zugestellt werden.

Nachrichten, die nach Abschluss der Migration gesendet werden, werden dem neuen Lösungspartner in Rechnung gestellt.

Downtime

Die Downtime beginnt erst, wenn du den letzten Schritt (Registrierung) durchführst. Bis dahin können mit der Unternehmenstelefonnummer ohne Unterbrechung Nachrichten versendet und empfangen werden.

Sobald du den letzten Registrierungsschritt durchgeführt hast, beginnt die Ausfallzeit und dauert an, bis wir die Vorlagenduplizierung abgeschlossen haben.

Nach Abschluss kann wieder die Unternehmenstelefonnummer zum Senden und Empfangen von Nachrichten verwendet werden, die dem neuen WABA des*der Kund*in zugeordnet wird.

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.

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 in der Payload 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 Nutzung mit der Cloud API (du kannst eine migrierte Unternehmenstelefonnummer nicht für die Nutzung mit der On-Premises API registrieren).