Interaktionen mit einer Einbindung

Mit einer Integration, werden Endnutzerinteraktionen für Sie abgewickelt. Sie müssen nur einen Agent erstellen, optional einen Webhook implementieren und die Integration konfigurieren.

In dieser Anleitung erfahren Sie, wie Sie mit der Integration von Dialogflow CX Messenger eine einfache Textchat-Benutzeroberfläche für Ihren Agent bereitstellen.

Hinweis

Wenn Sie keine Integration verwenden möchten, können Sie diese Kurzanleitung überspringen.

Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:

  1. Grundlagen zu Abläufen
  2. Führen Sie Einrichtungsschritte aus.
  3. Die Schritte in der Kurzanleitung Agent mit Abläufen erstellen ausführen. In den folgenden Schritten wird derselbe Agent weiterverwendet. Wenn Sie diesen Agent nicht mehr haben, können Sie ihn herunterladen und wiederherstellen.

Einrichtung

So richten Sie den Zugriff ohne Authentifizierung auf Ihren Dialogflow CX Messenger-Agent ein:

  1. Rufen Sie die Dialogflow CX Console auf.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie im linken Seitenleistenmenü auf Integrations.
  6. Klicken Sie bei Dialogflow CX Messenger auf Verbinden.
  7. Ein Konfigurationsdialogfeld wird geöffnet.
  8. Wenn die Integration zuvor für diesen Agent eingerichtet wurde, wird ein einbettbarer HTML-Code angezeigt. Unabhängig davon, ob Sie eine authentifizierte oder nicht authentifizierte Integration verwenden möchten, klicken Sie unten im Dialogfeld auf die Schaltfläche Deaktivieren... , damit Sie die Einstellungen im nächsten Schritt neu konfigurieren können.
  9. Wählen Sie eine Umgebung aus.
  10. Wählen Sie Nicht authentifizierte API aus.
  11. Wählen Sie einen Stil aus.
  12. Optional können Sie den Zugriff auf Domains einschränken.
  13. Klicken Sie auf Nicht authentifizierte API aktivieren.
  14. Im Dialogfeld wird der einbettbare HTML-Code angezeigt, der in Ihre Website eingebettet werden kann. Kopieren Sie diesen Code.
  15. Klicken Sie auf Fertig.

Einbetten

Fügen Sie den oben kopierten Einbettungscode in eine Webseite auf Ihrer Website ein. Die HTML-Elemente <script> und <df-messenger> sollten sich im <body>-Element Ihrer Seite befinden.

Wenn Sie eine authentifizierte Integration verwenden, legen Sie das oauth-client-id Attribut für <df-messenger> auf Ihre OAuth-Client-ID fest. Wenn Sie die Identitäten von Endnutzern für die Tool Authentifizierung, verwenden möchten, legen Sie das access-token-name Attribut mit einem beliebigen Namen fest. Verwenden Sie dann das Bearertoken mit dem Wert $session.params.ACCESS_TOKEN_NAME für die Tool-Authentifizierung.

Aktualisieren Sie alle anderen Attribute, die aktualisiert werden müssen.

Um responsive Layouts zuzulassen, fügen Sie dem <head> Element auch Folgendes hinzu:

<meta name="viewport" content="width=device-width, initial-scale=1">

Nach dem Einbetten können Sie über die Webseite mit Ihrem Agent interagieren. Klicken Sie dazu rechts unten auf das Chatsymbol.

Screenshot der Messenger-Benutzeroberfläche

Anpassen

Sie können das Erscheinungsbild und das Verhalten dieser Benutzeroberfläche auf viele Arten anpassen. Weitere Informationen finden Sie in der Dokumentation zu Dialogflow CX Messenger.