Verwalten Sie den WhatsApp-Migrationsprozess mit dem eingebetteten Anmeldefluss

Voraussetzungen
  • Wenn Sie als Neu- oder Bestandskunde das neue WhatsApp Self-Service-Onboarding Erstellen Sie einen neuen WhatsApp Business Account (WABA) mit dem Eingebetteter Anmeldeablauf .
    • Registrieren Sie im Rahmen dieses WABA mindestens eine neue Telefonnummer und erstellen Sie eine WhatsApp-Integration in Ihrer Genesys Cloud-Organisation. Bei der neuen Telefonnummer kann es sich um eine Testnummer oder Integration handeln, die Sie später löschen können, wenn Sie die anderen Nummern auf dieses WABA migriert haben. Ohne die Registrierung mindestens einer neuen Nummer über die eingebettete Anmeldung können Sie die Kreditlinie oder Zahlungsmethode von Genesys nicht mit der WABA verknüpfen. Ohne eine gültige Zahlungsmethode kann WhatsApp Telefonnummern nicht zu einem WABA migrieren. Daher müssen Sie mindestens eine neue Nummer registrieren.
  • Erstellen Sie im Meta Business Manager eine Meta-App und fügen Sie das WhatsApp-Produkt hinzu. Sie benötigen dieses App-Setup, um eine Graph-API-Anfrage mit den WhatsApp-Berechtigungen auszuführen und den Telefonnummernmigrationsprozess zu starten. Sie verwenden die App zu keinem anderen Zweck als zum Generieren eines Zugriffs- oder Benutzertokens, zum Ausüben von Berechtigungen und zum Starten der Migration. Sie können die App später aus dem Business Manager löschen, sobald Sie alle Nummern migriert haben. 
  • Starten Sie die Migration mithilfe der Graph API. Genesys kann die Migration nicht in Ihrem Namen durchführen, da die über Embedded Signup erstellten WABAs Eigentum des Unternehmens und nicht von Genesys sind.

Um eine Meta-App mit dem WhatsApp-Produkt zu erstellen, führen Sie die folgenden Schritte aus:

  1. Im Meta-Business-Einstellungen Seite, gehen Sie wie folgt vor:
    1. Konten Abschnitt klicken Apps .
    2. Klicken Hinzufügen und wählen Sie Erstellen einer neuen App-ID .
    3. Im Erstellen einer App wählen Sie Andere .
    4. Im Wählen Sie einen App-Typ aus wählen Sie Geschäft .
    5. Klicken Sie auf Weiter.
    6. Im Einen App-Namen hinzufügen Geben Sie in das Feld den App-Namen ein.
    7. (Optional) Im Geschäftskonto Wählen Sie im Feld „Genesys Cloud Services, Inc.“ aus.
    8. Klicken App erstellen . Das Meta-App-Dashboard wird angezeigt.
    9. Im Fügen Sie Ihrer App Produkte hinzu Seite, in der WhatsApp Kachel, klicken Sie auf Aufstellen .
    10. Im Schnellstart Seite, im linken Bereich unter App-Überprüfung , klicken Berechtigungen und Funktionen .
    11. Im Berechtigungen und Funktionen Seite, in der Suchen Geben Sie im Feld „business_management“ ein.
    12. Zeigen Sie im Abschnitt „Berechtigungen und Funktionen“ die Optionen „WhatsApp_Business_Management“ und „Business_Management“ mit der Zugriffsebene „Standardzugriff“ an.
  2. Navigieren Sie zur Registerkarte „Meta“ und klicken Sie auf Aktualisierung.
  3. Zeigen Sie die Genesys Cloud-App an, die Sie auf der Seite mit den Geschäftseinstellungen erstellt haben.

Nachdem Sie die App erstellt haben, konfigurieren Sie in der App eine Test-Webhook-Callback-URL für Ihr WhatsApp-Produkt. Führen Sie die folgenden Schritte aus, um die WhatsApp Webhook-Callback-URL für Ihre Meta-App zu konfigurieren:

  1. Im einzigartigen URL-Finder , erstellen Sie die eindeutige URL. 
  2. Kopieren Sie die eindeutige URL, fügen Sie sie in einen anderen Browser-Tab ein und wechseln Sie dann zurück zur URL Ihrer Webhook-Site.
  3. Gehen Sie in der Webhook-Site-URL wie folgt vor:
    1. Klicken Sie oben auf der Seite auf Bearbeiten .
    2. Im URL bearbeiten im Dialogfeld Antworttext Geben Sie im Feld $request.query.hub_challenge$ als Variable ein.
    3. Klicken Sie auf Speichern.
  4. Gehen Sie in der Meta-App wie folgt vor:
    1. Navigieren Sie im linken Bereich zu WhatsApp > Konfiguration , klicken Bearbeiten .
    2. Im Bearbeiten der Rückruf-URL des Webhooks im Dialogfeld Rückruf-URL Fügen Sie die eindeutige URL in das Feld ein. 
    3. Im Token überprüfen Geben Sie die Details des Tokens ein (das eine beliebige Textzeichenfolge enthalten kann).
    4. Klicken Verifizieren und speichern , um Ihre Konfiguration zu speichern.
  5. Gehen Sie neben dem Feld „Webhook“ wie folgt vor:
    1. Unter dem Bearbeiten auf Verwalten .
    2. Im Webhook-Felder im Dialogfeld Abonnieren alle Kästchen unter dem Abonnieren Spalte.
    3. Klicken Sie auf Erledigt.

Hinweis: Sie müssen das Webhook-Setup nur durchführen, wenn Sie Ihre Nummern von einem anderen BSP migrieren, der sich auf der WhatsApp-Cloud-Plattform befindet. Wenn Sie Nummern von einer lokalen WhatsApp-Plattform oder einem vorhandenen WABA von Genesys zu Ihrem neuen eingebetteten WABA migrieren, fahren Sie direkt mit der Einleitung der Telefonmigration fort.

Bleiben Sie angemeldet bei Ihrem Meta-Geschäftskonto und navigieren Sie zu Metas Graph API Explorer . Stellen Sie auf der rechten Seite der API Explorer-Seite sicher, dass die Authentifizierungsparameter richtig eingestellt sind, bevor Sie POST-Anfragen mit den APIs stellen.
Führen Sie die folgenden Schritte aus, um eine Telefonmigration zu starten:
  1. Im Zugangstoken im Dialogfeld Meta App Wählen Sie im Feld den Meta-App-Namen aus, den Sie zuvor erstellt haben.
  2. Im Benutzer oder Seite Wählen Sie im Feld „Benutzertoken“ die Option „Benutzertoken“ aus.
  3. Im Hinzufügen einer Berechtigung Feld, einschließen whatsapp_business_management Und Business_Management-Berechtigungen in der Liste der Berechtigungen. Wenn nicht, klicken Sie auf die Dropdown-Liste und wählen Sie sie aus. Sie finden die   whatsapp_business_management im Andere Berechtigungskategorie und betriebswirtschaft im Veranstaltungen Gruppen Seiten Berechtigungskategorie.
  4. Drücke den Zugriffstoken generieren Taste. Wenn Sie vom System dazu aufgefordert werden, wählen Sie alle WABAs aus. Normalerweise müssen Sie für eine Migration nur die WABA auswählen, zu der die Nummer migriert wird. Der Zugriffstoken läuft nach einer gewissen Zeit der Inaktivität ab. Aktualisieren Sie im Falle eines Ablaufs die Seite oder generieren Sie das Token erneut.
  5. Klicken Sie auf Senden Sie.

Um zu bestätigen, ob Sie die Migration eingeleitet haben, navigieren Sie zu Ihrem WhatsApp Manager und unter Konto-Tools > Telefonnummern , zeigen Sie Ihre Nummer an, die dem WABA im Status „Ausstehend“ oder „Offline“ hinzugefügt wurde.

Hinweis: Wenn Sie die Migration initiieren, wird die Nummer lediglich zum neuen WABA hinzugefügt. Der Datenverkehr fließt jedoch über Ihre vorhandene WhatsApp-Integration, die mit dem alten WABA verknüpft ist, bis Sie die Migration abgeschlossen haben.

Verwenden Sie den eingebetteten Anmeldefluss von WhatsApp in der Genesys Cloud und schließen Sie Ihre WhatsApp-Telefonverifizierung und -Registrierung ab. Wenn die Zwei-Faktor-Authentifizierung für die Nummer nicht deaktiviert ist, wird das Telefon verifiziert, Sie können jedoch keine eingebettete WhatsApp-Integration erstellen. Das Deaktivieren von 2FA ist eine zwingende Voraussetzung. Bitte wenden Sie sich an GenesysCloudWhatsAppRequests@genesys.com um die Zwei-Schritt-Verifizierung für Ihre Nummer im alten, von Genesys verwalteten WABA zu deaktivieren. Wenn Sie die Nummer von einem anderen BSP migrieren und dieser Ihr WABA verwaltet, müssen Sie es von ihm für Sie deaktivieren lassen.

Sie können Ihre Telefonnummer aktivieren, wenn Ihre API-Anfrage erfolgreich war und Sie die Nummernmigration einleiten konnten. Wenn die API-Anforderung einen Fehler zurückgibt, der darauf hinweist, dass mindestens eine Ihrer Meta-Apps für das Ziel-WABA bei Webhooks angemeldet sein muss , Erstellen Sie ein neues Webhook-Abonnement für das Ziel-WABA, indem Sie einen POST-Aufruf an den /WHATSAPP_BUSINESS_ACCOUNT_ID/abonnierte_Apps Endpunkt. 

Sie können überprüfen, ob das Abonnement erfolgreich war, indem Sie einen GET-Aufruf an den Endpunkt /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps senden.

Notiz :Um das Risiko von Ausfallzeiten auf Ihrem WhatsApp-Kanal zu vermeiden, aktivieren Sie bei Produktionsnummern die Telefonnummer während eines geplanten Wartungsfensters, wenn Ihr Contact Center geschlossen ist. Ihr WhatsApp-Verkehr ist davon nicht betroffen und wird nicht umgestellt, bis die alte Integration gelöscht und eine neue Integration erstellt und in GC aktiviert wird.

Führen Sie die folgenden Schritte aus, um die Telefonnummer mithilfe des eingebetteten Anmeldeflusses zu aktivieren:

  1. Löschen Sie Ihre aktuelle WhatsApp-Integration in der Genesys Cloud, die mit der Telefonnummer des alten WABA verknüpft ist. Möglicherweise müssen Sie zuerst die mit der Integration verknüpfte Nachrichtenroute löschen, bevor Sie die Integration selbst löschen.
  2. Konfigurieren Sie im Rahmen des neuen WABA eine neue WhatsApp-Integration für die von Ihnen initiierte Nummer. Weitere Informationen zum Konfigurieren einer neuen WhatsApp-Integration finden Sie unter Arbeiten mit eingebettetem Anmeldefluss . 
  3. Wenn Sie den Vorgang abgeschlossen haben, gehen Sie wie folgt vor: 
    1. Wählen Sie Ihr Meta-Business-Konto aus.
    2. Wählen Sie das WhatsApp-Geschäftskonto aus, dem die Nummer nach dem Starten der Migration hinzugefügt wurde.
    3. Wählen Sie die migrierte Telefonnummer/das migrierte Geschäftsprofil aus.
    4. Überprüfen/registrieren Sie die Nummer und speichern Sie die Integration.

Es kann einige Minuten dauern, bis alle Ihre genehmigten WhatsApp-Nachrichtenvorlagen automatisch von Ihrem alten WABA auf das neue WABA migriert wurden. Sobald dies erledigt ist, wird eine neue Nachrichtenvorlage Namensraum wird von WhatsApp vergeben. Um vorgefertigte Antworten neu zu konfigurieren, führen Sie die folgenden Schritte aus:

  1. Melden Sie sich bei Ihrem Meta-Geschäftsmanager .
  2. Wählen Sie Ihr Unternehmen aus.
  3. Navigieren Sie zu WhatsApp Manager > Konto-Tools > Nachrichtenvorlagen
  4. Konfigurieren Sie die Nachrichtenvorlagen/vorgefertigten Antworten in Ihrer Genesys Cloud-Organisation aufgrund des neuen von WhatsApp zugewiesenen Namespace neu. Weitere Informationen zum Hinzufügen einer WhatsApp-Vorlagennachricht und zur Verwendung einer WhatsApp-Vorlagennachricht finden Sie unter Eine WhatsApp-Vorlagennachricht hinzufügen Und Verwenden einer WhatsApp-Vorlagennachricht . 

    Wenn Sie ein neues Webhook-Abonnement für das Ziel-WABA erstellt haben und die Anforderung löschen möchten, führen Sie die folgenden Schritte aus:

    1. Im Graph API Explorer , Abschnitt „Zugriffstoken“, entfernen Sie ihn durch machen ein LÖSCHEN Anruf an die /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps-Endpunkt.
    2. Geben Sie die WhatsApp Business-Konto-ID ein.
    3. Klicken Sie auf Senden Sie.