Migration

Falls du bereits über ein Setup des WhatsApp Business API-Client mit einer Datenbank verfügst und Client und Datenbank zu einem neuen Setup mit derselben Telefonnummer migrieren möchtest, wird dir in diesem Dokument gezeigt, wie du die notwendigen Änderungen identifizierst und wie du vorgehen musst.

Bevor du beginnst

• Backup ist der wichtigste Schritt der Migration.
• Nach der Migration musst du deine Telefonnummer nicht erneut registrieren. Du kannst Nachrichten senden, sobald die Migration abgeschlossen ist.
• Das neue Setup muss über dieselbe Anzahl Shards verfügen wie das alte. Während des Migrationsprozesses kannst du nicht nach oben oder unten skalieren. Wenn dein altes Setup mit einer Anzahl von X Mastern und einer Anzahl von Y Coreapps konfiguriert ist, muss das neue Setup über genau dieselbe Anzahl an Mastern und Coreapps verfügen. Stimmt die Anzahl an Mastern und Coreapps vor und nach der Migration nicht überein, schlägt die Migration fehl.
• Versuche vor der Migration eines Produktionskontos ein Testkonto zu migrieren.
• Du musst mit einer Ausfallzeit rechnen. Die Länge der Ausfallzeit hängt von der Migrationsoption ab, aber grundsätzlich ist jede Migration mit einer Ausfallzeit verbunden.

Migration-Optionen

In Abhängigkeit von der Menge der zu migrierenden Daten stehen verschiedene Migration-Optionen zur Verfügung. Wähle die Option aus, die deinen Anforderungen am ehesten entspricht.

• Option 1: Nur Einstellungen
• Option 2: Einstellungen und Nachrichten
• Option 3: Vollständige Migration

Für die verschiedenen Optionen beibehaltenen Daten

Typischer Anwendungsfall und übliche Ausfallzeit für die verschiedenen Migration-Optionen

In diese Tabelle findest du Beschreibungen der typischen Anwendungsfälle und der üblichen Ausfallzeiten für die verschiedenen Migrationsoptionen. Dabei handelt es sich nur um typische Anwendungsfälle. Du kannst je nach deinen Anforderungen deine bevorzugte Migrationsoption auswählen.

Option 1: Nur Einstellungen

Mit einer Migration vom Typ „Nur Einstellungen“ werden nur die Einstellungsinformationen gesichert und wiederhergestellt. Informationen zu Nachrichten und Authentifizierungsschlüssel werden nicht migriert.

Schritt 1: Ein neues Setup installieren

Richte deinen neuen WhatsApp Business API-Client anhand der Installationsdokumentation ein.

Schritt 2: Für das neue Setup einen neuen Authentifizierungsschlüssel beziehen

Der aktuelle Authentifizierungsschlüssel ist in der neuen Umgebung ungültig. Melde dich für das neue Setup an, um einen neuen Authentifizierungsschlüssel zu beziehen.

Schritt 3: Bereinigung

• [Optional] Deaktiviere die zweistufige Authentifizierung. Das ist dann hilfreich, wenn der Code für die zweistufige Authentifizierung vergessen wurde und du neu registrieren musst. Für eine reibungslose Migration ist die erneute Registrierung zwar nicht erforderlich, du musst dich jedoch gegebenenfalls neu registrieren, wenn Backup und Wiederherstellung aus unbekannten Gründen fehlschlagen. Befolge die Anweisungen zur Deaktivierung des Codes für die zweistufige Authentifizierung.
  Hinweis: Wenn du keine Zweifel an der Richtigkeit deines Codes für die zweistufige Authentifizierung hast, ist dieser Schritt optional.
• [Optional] Setze alle Webhooks zurück. Wenn Webhooks so eingerichtet sind, dass sie eingehende Benachrichtigungen erhalten, und der Webhook-Server während der Migration ebenfalls geändert wird, musst du den alten Webhook-Server in den Anwendungseinstellungen deaktivieren.
  Hinweis: Dieser Schritt ist optional, wenn du den Webhook-Server nach der Migration nicht änderst.

Schritt 4: Ein Backup der Einstellungen aus dem aktuellen Setup erstellen

Verwende den aktuellen Authentifizierungsschlüssel, um aus dem aktuellen WhatsApp Business API-Client ein Backup aus den Einstellungsdaten zu erstellen.

Schritt 5: Das aktuelle Setup deinstallieren

Dieser Schritt ist mit einer Ausfallzeit für das Messaging verbunden. Um diese möglichst kurz zu halten, solltest du sicherstellen, dass der WhatsApp Business API-Client an dem neuen Standort ausgeführt werden kann. Anweisungen hierzu findest du im Abschnitt Deinstallation des entsprechenden Installationsleitfadens. Stelle sicher, dass du nur den WhatsApp Business API-Client deinstallierst, der die Docker-Container von Coreapp, Webapp und Master beinhaltet. Lösche nicht die Datenbank.

Schritt 6: Die Einstellungen im neuen Setup wiederherstellen

Melde dich an, wenn du nicht bereits einen neuen Authentifizierungsschlüssel verwendest, und führe eine Wiederherstellung für das neue Setup durch.
Dein neuer WhatsApp Business API-Client sollte mit allen erforderlichen Informationen ausgeführt werden und für das Messaging vorbereitet sein. Dabei ist vor allem zu berücksichtigen, dass eine erneute Registrierung des WhatsApp-Kontos nicht erforderlich ist, wenn die Einstellungen richtig gesichert und wiederhergestellt werden.

Schritt 7: Eine Systemdiagnose durchführen

Führe eine Systemdiagnose durch und sende eine Testnachricht, um zu verifizieren, dass der WhatsApp Business API-Client funktioniert.

Schritt 8: [Optional] Die zweistufige Authentifizierung aktivieren

Falls du diese in Schritt 3 deaktiviert hast, aktiviere die zweistufige Authentifizierung jetzt erneut. Damit kannst du dein WhatsApp-Konto zusätzlich schützen.

Schritt 9: Webhooks einrichten

Richte deine Webhooks ein, um eingehende Benachrichtigungen zu aktivieren.

Schritt 10: Die alte Datenbank löschen

Deine alte Datenbank enthält die Daten deiner alten Einstellungen, Nachrichten und Authentifizierungsschlüssel. Falls du in der Zukunft einige dieser Daten wiederherstellen möchtest, solltest du die alte Datenbank nicht löschen. Wenn du entschieden hast, die Datenbank zu löschen, solltest du sicherstellen, dass der WhatsApp Business API-Client in den vergangenen 14 Tagen ausgeführt wurde und dass das Messaging einwandfrei funktioniert. Erst dann solltest du sie löschen.

Option 2: Einstellungen und Nachrichten

Mit einer Migration vom Typ „Einstellungen und Nachrichten“ werden nur die Einstellungs- und die Nachrichteninformationen gesichert und wiederhergestellt. Informationen zu Authentifizierungsschlüsseln werden nicht migriert.

Verschaffe dir einen Überblick über die Datenmenge, die auf einen anderen Computer übertragen werden muss. Da mehr Daten gesichert und wiederhergestellt werden müssen, ist die Ausfallzeit länger als bei Option 1. Die gesamte Ausfallzeit variiert je nach übertragener Datenmenge und Netzwerklatenzen.

Schritt 1: Bereinigung

• [Optional] Deaktiviere die zweistufige Authentifizierung. Das ist dann hilfreich, wenn der Code für die zweistufige Authentifizierung vergessen wurde und du neu registrieren musst. Für eine reibungslose Migration ist die erneute Registrierung zwar nicht erforderlich, du musst dich jedoch gegebenenfalls neu registrieren, wenn Backup und Wiederherstellung aus unbekannten Gründen fehlschlagen. Befolge die Anweisungen zur Deaktivierung des Codes für die zweistufige Authentifizierung.
  Hinweis: Wenn du keine Zweifel an der Richtigkeit deines Codes für die zweistufige Authentifizierung hast, ist dieser Schritt optional.
• [Optional] Setze alle Webhooks zurück. Wenn Webhooks so eingerichtet sind, dass sie eingehende Benachrichtigungen erhalten, und der Webhook-Server während der Migration ebenfalls geändert wird, musst du den alten Webhook-Server in den Anwendungseinstellungen deaktivieren. Dies ist der erste Schritt, bei dem Ausfallzeiten für das Messaging auftreten.
  Hinweis: Dieser Schritt ist optional, wenn du den Webhook-Server nach der Migration nicht änderst.

Schritt 2: Das aktuelle Setup deinstallieren

Dieser Schritt ist mit einer Ausfallzeit für das Messaging verbunden. Um diese möglichst kurz zu halten, solltest du sicherstellen, dass der WhatsApp Business API-Client an dem neuen Standort ausgeführt werden kann. Anweisungen hierzu findest du im Abschnitt Deinstallation des entsprechenden Installationsleitfadens. Stelle sicher, dass du nur den WhatsApp Business API-Client deinstallierst. Lösche nicht die Datenbank.

Schritt 3: Ein Backup der Datenbank erstellen

Sichere alle Datenbanken (ausgenommen waweb, die Benutzer-/Authentifizierungsdaten enthält), mit einem Hilfsprogramm wie mysqldump oder pg_dump aus dem aktuellen WhatsApp Business API-Client.
Hinweis: Dabei ist es wichtig, waweb auszuschließen, wenn du ein Lösungsanbieter bist, der ein Unternehmen von oder auf seine Plattform migriert. Du möchtest möglicherweise keine aktuell gespeicherten Authentifizierungsschlüssel und Benutzerdaten weiterleiten oder übergeben.

Schritt 4: Die Datenbank wiederherstellen

Stelle die Datenbank mit einem Hilfsprogramm wie mysqldump oder pg_dump auf dem neuen WhatsApp Business API-Client wieder her.

Schritt 5: Ein neues Setup installieren

Richte deinen neuen WhatsApp Business API-Client anhand der Installationsdokumentation ein. Stelle sicher, dass du deine Datenbank auf den wiederhergestellten Standort aus Schritt 4 verweist.

Schritt 6: Für das neue Setup einen neuen Authentifizierungsschlüssel beziehen

Der aktuelle Authentifizierungsschlüssel ist in der neuen Umgebung ungültig. Melde dich für das neue Setup an, um einen neuen Authentifizierungsschlüssel zu beziehen.
Dein neuer WhatsApp Business API-Client sollte mit allen erforderlichen Informationen ausgeführt werden und für das Messaging vorbereitet sein. Dabei ist vor allem zu berücksichtigen, dass eine erneute Registrierung des WhatsApp-Kontos nicht erforderlich ist, wenn die Datenbank richtig gesichert und wiederhergestellt wird.

Schritt 7: Eine Systemdiagnose durchführen

Führe eine Systemdiagnose durch und sende eine Testnachricht, um zu verifizieren, dass der WhatsApp Business API-Client funktioniert.

Schritt 8: [Optional] Die zweistufige Authentifizierung aktivieren

Falls du diese in Schritt 1 deaktiviert hast, aktiviere die zweistufige Authentifizierung jetzt erneut. Damit kannst du dein WhatsApp-Konto zusätzlich schützen.

Schritt 9: Webhooks einrichten

Richte deine Webhooks ein, um eingehende Benachrichtigungen zu aktivieren.

Schritt 10: Die alte Datenbank löschen

Deine alte Datenbank enthält die Daten deiner alten Einstellungen, Nachrichten und Authentifizierungsschlüssel. Falls du in der Zukunft einige dieser Daten wiederherstellen möchtest, solltest du die alte Datenbank nicht löschen. Wenn du entschieden hast, die Datenbank zu löschen, solltest du sicherstellen, dass der WhatsApp Business API-Client in den vergangenen 14 Tagen ausgeführt wurde und dass das Messaging einwandfrei funktioniert. Erst dann solltest du sie löschen.

Option 3: Vollständige Migration

Mit einer vollständigen Migration werden alle Einstellungen, Nachrichten und Authentifizierungsschlüssel gesichert und wiederhergestellt.

Diese Option scheint unter Umständen die beste zu sein, aber du solltest dir einen Überblick über die Datenmenge verschaffen, die auf einen anderen Computer übertragen werden muss. Da mehr Daten gesichert und wiederhergestellt werden müssen, ist die Ausfallzeit länger als bei Option 1 und Option 2.

Schritt 1: Bereinigung

• [Optional] Deaktiviere die zweistufige Authentifizierung. Das ist dann hilfreich, wenn der Code für die zweistufige Authentifizierung vergessen wurde und du neu registrieren musst. Für eine reibungslose Migration ist die erneute Registrierung zwar nicht erforderlich, du musst dich jedoch gegebenenfalls neu registrieren, wenn Backup und Wiederherstellung aus unbekannten Gründen fehlschlagen. Befolge die Anweisungen zur Deaktivierung des Codes für die zweistufige Authentifizierung.
  Hinweis: Wenn du keine Zweifel an der Richtigkeit deines Codes für die zweistufige Authentifizierung hast, ist dieser Schritt optional.

Schritt 2: Ein Backup deines aktuellen Authentifizierungsschlüssels erstellen

Ein Schlüssel ist maximal sieben Tage gültig. Vergewissere dich, dass die Gültigkeit deines Schlüssels ausreicht, um die Migration durchzuführen.

Schritt 3: Das aktuelle Setup deinstallieren

Dieser Schritt ist mit einer Ausfallzeit für das Messaging verbunden. Um diese möglichst kurz zu halten, solltest du sicherstellen, dass der WhatsApp Business API-Client an dem neuen Standort ausgeführt werden kann. Anweisungen hierzu findest du im Abschnitt Deinstallation des entsprechenden Installationsleitfadens. Stelle sicher, dass du nur den WhatsApp Business API-Client deinstallierst. Lösche nicht die Datenbank.

Schritt 4: [Optional] Ein Backup der Datenbank erstellen

Erstelle ein Backup der Datenbank mit einem Hilfsprogramm wie mysqldump oder pg_dump, um die Daten für die Einstellungen, Nachrichten und Auth.schlüssel zu erfassen.
Hinweis: Wenn du nur den WhatsApp Business API-Client migrierst, nicht jedoch die Datenbank, ist dieser Schritt optional.

Schritt 5: Die Datenbank wiederherstellen

Stelle die Datenbank mit einem Hilfsprogramm wie mysqldump oder pg_dump auf dem neuen WhatsApp Business API-Client wieder her.

Schritt 6: Ein neues Setup installieren

Richte deinen neuen WhatsApp Business API-Client anhand der Installationsdokumentation ein. Stelle sicher, dass du deine Datenbank auf den wiederhergestellten Standort aus Schritt 5 verweist.
Dein neuer WhatsApp Business API-Client sollte mit allen erforderlichen Informationen ausgeführt werden und für das Messaging vorbereitet sein. Dabei ist vor allem zu berücksichtigen, dass eine erneute Registrierung des WhatsApp-Kontos nicht erforderlich ist, wenn die Daten richtig gesichert und wiederhergestellt werden.

Schritt 7: Eine Systemdiagnose durchführen

Führe eine Systemdiagnose durch und sende eine Testnachricht, um zu verifizieren, dass der WhatsApp Business API-Client funktioniert.

Schritt 8: [Optional] Die zweistufige Authentifizierung aktivieren

Falls du diese in Schritt 1 deaktiviert hast, aktiviere die zweistufige Authentifizierung jetzt erneut. Damit kannst du dein WhatsApp-Konto zusätzlich schützen.

Schritt 9: Webhooks einrichten

Richte deine Webhooks ein, um eingehende Benachrichtigungen zu aktivieren.

Schritt 10: Die alte Datenbank löschen

Deine alte Datenbank enthält die Daten deiner alten Einstellungen, Nachrichten und Authentifizierungsschlüssel. Falls du in der Zukunft einige dieser Daten wiederherstellen möchtest, solltest du die alte Datenbank nicht löschen. Wenn du entschieden hast, die Datenbank zu löschen, solltest du sicherstellen, dass der WhatsApp Business API-Client in den vergangenen 14 Tagen ausgeführt wurde und dass das Messaging einwandfrei funktioniert. Erst dann solltest du sie löschen.