Serie: Leitfaden für die Migration von Web-Chat zu Web-Messaging

Migrieren Sie Web-Chat-Flüsse in Nachrichtenflüsse

Voraussetzungen
  • Genesys Cloud CX 2, Genesys Cloud CX 3, Genesys Cloud CX 1 Digital Add-on II, Genesys Cloud CX 2 Digital, oder Genesys Cloud CX 3 Digital Lizenz
  • Web-Bereitstellungen > Konfigurationen > Alle Berechtigung
  • Web-Einsätze > Einsätze > Alle Genehmigung
  • Ein eingehender Nachrichtenfluss

In diesem Artikel wird davon ausgegangen, dass Ihr Unternehmen über veröffentlichte eingehende Chat-Flows von Architect verfügt, und es wird beschrieben, wie Sie Ihre vorhandenen eingehenden Chat-Flows in eingehende Nachrichten-Flows migrieren.

Web-Messaging erfordert einen eingehenden Nachrichtenfluss und Änderungen an Ihrer Website, um den neuen Messenger einzusetzen. Eingehende Web-Chat-Flows können nicht für Web-Messaging verwendet werden. Derzeit gibt es in Genesys Cloud kein automatisches Tool, um die Logik zwischen verschiedenen Flussarten zu migrieren. Sie müssen eingehende Chatflüsse manuell als eingehende Nachrichtenflüsse neu erstellen. 

Planen Sie für Ihren Migrationspfad die Einrichtung des neuen Messenger- und Web-Messaging-Kanals und fügen Sie ihn zu Ihrer Website hinzu. Testen Sie sie parallel zu den bestehenden Web-Chat-Funktionen. Weitere Informationen finden Sie unter Über Web-Messaging

Bevor Sie beginnen

Lesen Sie die folgenden Artikel:

Auswirkung

Eingebaute variable Überlegungen

Nachdem Sie einen eingehenden Chatfluss in einen eingehenden Nachrichtenfluss migriert haben, überprüfen Sie die migrierten integrierten Variablen.

Ändern Sie im neuen Nachrichtenfluss chat-spezifische Ausdrücke, die mit Nachrichtenflüssen kompatibel sind. Ändern Sie zum Beispiel einen referenzierten Wert Chat.Languagein Message.Language. Beachten Sie jedoch die eingebauten Chat-Variablen, die keine äquivalenten Nachrichtenvariablen haben, wie z.B. Chat.Guest.

Suche nach Aufgaben der alten Warteschlange in eingehenden Chatflüssen

Die Aktion Alte Warteschlange suchen ist spezifisch für Chatflüsse und wird diesen Flüssen standardmäßig hinzugefügt. Da diese Aufgabe in eingehenden Nachrichtenflüssen nicht gültig ist, können Sie sie nicht von einem eingehenden Chatfluss in einen eingehenden Nachrichtenfluss kopieren. In diesem Fall empfiehlt es sich, die Aufgabe "Alte Warteschlange suchen" zu ignorieren, wenn Sie die Logik zwischen eingehendem Chat und eingehenden Nachrichtenflüssen kopieren und einfügen.

Zu unternehmende Schritte

Genesys bietet zwei Möglichkeiten, um eingehende Chatflüsse manuell in eingehende Nachrichtenflüsse zu migrieren:

  • Option 1: Migrieren mit Archy, geeignet für Abläufe, die eine lange oder komplexe Logik enthalten.
  • Option 2: Kopieren Sie die Logik aus einem Chatablauf und fügen Sie sie in einen Nachrichtenablauf ein. Dies eignet sich für einfachere Abläufe mit wenigen Zuständen oder Aufgaben.

Option 1: Verwenden Sie Archy, um eingehende Chatflüsse in eingehende Nachrichtenflüsse umzuwandeln

Um Archy für die Migration von eingehenden Chatflüssen zu eingehenden Nachrichtenflüssen zu verwenden, bereiten Sie Archy zunächst in Ihrer Umgebung vor, indem Sie das Programm installieren und einrichten. Verwenden Sie dann Archy, um Ihre eingehenden Chatflüsse in eingehende Nachrichtenflüsse umzuwandeln.

Bereiten Sie Archy in Ihrer Umgebung vor

  1. Installieren Sie Archy.
  2. Richten Sie Archyein.
  3. Führen Sie den Befehl archy refresh aus
  4. Integration von Archy mit der Visual Studio Code YAML-Erweiterung.

Verwenden Sie Archy, um einen eingehenden Chatfluss in einen eingehenden Nachrichtenfluss umzuwandeln

  1. Exportieren Sie den Chatverlauf in das YAML-Format.
  2. Öffnen Sie in Ihrem Verzeichnis archyHome den exportierten YAML-Flow
    Hinweis: Sie erstellen dieses Verzeichnis, wenn Sie Archy in Ihrer Umgebung einrichten.
  3. Ändern Sie in der ersten Zeile der Datei die Eigenschaft von inboundChat in inboundShortMessage
  4. Wiederholen Sie Schritt 3 für jede Instanz der Eigenschaft inboundChat
  5. Fügen Sie in der zweiten Zeile einen aussagekräftigen Namen für den Fluss hinzu.
  6. Wenn Ihr eingehender Chatfluss die ursprüngliche Aufgabe "Find Legacy Queue" verwendet, kann ein Fehler auftreten, der angibt, dass Chat.Guest.customFields innerhalb des angestrebten Nachrichtenflusses nicht gültig ist Um diesen Fehler zu beheben, führen Sie einen der folgenden Schritte aus:
    • Entfernen Sie die gesamte Aufgabe aus dem YAML-Fluss und passen Sie die Struktur entsprechend an.
    • Entfernen Sie die Schleifenaktion, die einen Verweis auf Chat.Guest.customeFieldsenthält.
  7. Wenn Ihr ursprünglicher Chatablauf irgendwelche Aktionen zum Senden von Antworten verwendet, entfernen Sie alle Verweise auf messageBodyStyle und seine verschachtelten Attribute.
                       - sendResponse:
                           name: Send Response
                           messageBodyStyle:   <-- remove this
                             lit: notice       <-- remove this
                           messageBody:
                             exp: "\"Hello!\""
  8. Flow speichern
  9. Verwenden Sie den Befehl archy create von Archy, um den eingehenden Nachrichtenfluss in Architect zu erstellen
  10. Überprüfen und korrigieren Sie eventuelle Fehler im YAML-Fluss. 
  11. Wenn Sie Korrekturen am Ablauf vornehmen, speichern Sie Ihre Änderungen mit dem Befehl archy update
  12. Veröffentlichen Sie den Fluss mit dem Befehl archy publish
    Hinweis: Sie können zusätzliche Bereinigungen und Verfeinerungen in der Benutzeroberfläche des Architects vornehmen, indem Sie die Aufgabe Find Legacy Queue vollständig aus der Ablaufstruktur entfernen, wenn sie für Ihre Ablauflogik irrelevant ist.

Option 2: Verwenden Sie Kopieren und Einfügen, um Chat-Flows in Messaging-Flows zu migrieren

Sie können die Bearbeitungswerkzeuge des Architekten verwenden, um benutzerdefinierte Aufgaben und Zustände aus einem Chatablauf in einen Nachrichtenablauf zu kopieren und einzufügen. Weitere Informationen finden Sie unter Arbeiten mit Architect-Bearbeitungswerkzeugen.

Notizen: 
  • Sie können nur Objekte kopieren und einfügen, die in kompatiblen Bewegungsarten gemeinsam genutzt werden. Sie können keine bewegungsspezifischen Objekte gemeinsam nutzen, die in einer Bewegungsart verfügbar sind, in einer anderen aber nicht. Sie können z. B. eine Aktion Antwort senden oder Übergabe an ACD kopieren, da sie sowohl für Chats als auch für Nachrichtenflüsse gelten.
  • Sie können bis zu 10 Aufgabeneditor-Aktionen kopieren.
  • Wenn Sie eine Aufgabe kopieren, benennt Architect die Aufgabe um und fügt ihr eine fortlaufende Nummer hinzu. Zum Beispiel, Aufgabe 1.
  • Wenn Sie eine Aufgabe kopieren, macht Architect einen Schnappschuss der Aufgabe in Echtzeit, so dass Sie mehrere Versionen der gleichen Aufgabe kopieren können.
  • Wenn Sie ein Objekt in die Zwischenablage kopieren, erscheint es in der Liste der eingefügten Objekte. Um Informationen über das Objekt anzuzeigen, klicken Sie auf das Hilfesymbol des eingefügten Objekts. 
  • Kopierte Inhalte sind zwischen Registerkarten nicht verfügbar. Wenn Sie zum Beispiel Architekturflüsse in verschiedenen Registerkarten geöffnet haben, schlägt der Versuch, ein Objekt von einer Registerkarte in eine andere zu kopieren, fehl. Wenn Sie die Registerkarte, die einen Architektenfluss enthält, aktualisieren, bleibt der Inhalt der Zwischenablage nicht erhalten.
  • Wenn Sie eine Aktion mit einer unsicheren String-Variable (z. B. Task.myString) in einen sicheren Ablauf kopieren, der eine Variable mit demselben Namen enthält, erstellt Architect eine Variable. Dieses Verhalten tritt auf, weil die Sicherheitseinstellungen nicht übereinstimmen.

Kopieren und Einfügen von Logik aus einem bestehenden eingehenden Chatfluss in einen neuen eingehenden Nachrichtenfluss

  1. Öffnen Sie den Webchatablauf, der die zu kopierenden Objekte enthält.
  2. Klicken Sie neben den Objekten, die Sie kopieren möchten, z. B. eine komplette Aufgabe oder einen Zustand, auf . Weitere .
  3. Klicken Sie im angezeigten Menü auf Kopieren.
  4. Inbound-Nachrichten-Flow auswählen
  5. Navigieren Sie zu der Stelle im Nachrichtenfluss, an der Sie die kopierte Auswahl einfügen möchten.
  6. Klicken Sie auf Mehr .
  7. Klicken Sie im angezeigten Menü unter Objekt einfügen auf die entsprechende kopierte Auswahl
    Hinweis: Wenn Architect eine Aufgabe in die Zwischenablage kopiert, benennt es die Aufgabe um und fügt ihr eine fortlaufende Nummer hinzu. Zum Beispiel: Neue Aufgabe 1.
  8. Sichern und veröffentlichen Sie den eingehenden Nachrichtenfluss.