Salesforce-Chatintegration

Bei dieser Chat-Integration wird eine Salesforce Lightning Web Component (LWC) verwendet, um Agent Assist-UI-Module für Chat-Unterhaltungen zu integrieren.

Hier ist eine allgemeine Übersicht über die Chat-Integration:

Architektur für die Agent Assist-Chatintegration mit Salesforce

Hinweis

Wenn Sie Agent Assist-UI-Module in Salesforce einbinden möchten, müssen Sie zuerst die erforderlichen Ressourcen einrichten.

Schritt 1: Salesforce-Entwicklungsprojekt einrichten

So beginnen Sie mit der Integration von Agent Assist-UI-Modulen:

  1. Führen Sie den folgenden Code aus, um das Agent Assist-Integrations-Repository zu klonen und Ihr Projekt zu öffnen:

    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd salesforce/aa-lwc

  2. Führen Sie die folgenden Befehle aus, um die JavaScript-Dateien der UI-Module herunterzuladen, die Sie später als Statische Ressourcen bereitstellen. Salesforce erfordert statische Ressourcen, um JavaScript von Drittanbietern zu laden. Außerdem gilt ein Limit von 5 MB für statische Ressourcendateien. Daher werden die JavaScript-Dateien als ZIP-Datei hochgeladen.

    npm run generate-static-resources
npm install

Schritt 2: Salesforce-Umgebung einrichten

Sie können Agent Assist-UI-Module in eine bestimmte Umgebung einbinden, z. B. in die Produktions- oder Entwicklungsumgebung. In Salesforce werden diese Umgebungen als Organisationen bezeichnet.

Organisation in der Salesforce-Konsole konfigurieren

Führen Sie in der Salesforce-Konsole die folgenden Schritte aus, um Ihre Organisation für die Agent Assist-Integration zu konfigurieren.

  1. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Omni-Channel-Einstellungen ein und klicken Sie dann auf Omni-Channel-Einstellungen.
    1. Wählen Sie Omni-Channel aktivieren aus.
    2. Wählen Sie Agenten automatisch im neuen Fenster oder Tab bei Omni-Channel anmelden aus.
    3. Klicken Sie auf Speichern.
  2. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Communities ein und klicken Sie dann auf Digitale Erlebnisse > Einstellungen.
    1. Wählen Sie Experience Workspaces aktivieren aus.
    2. Klicken Sie auf Speichern.

Organisation mit der Salesforce-Befehlszeile konfigurieren

Führen Sie die folgenden Schritte aus, um die Salesforce-Befehlszeile zu verwenden, um Ihre Organisation für die Agent Assist-Integration zu konfigurieren.

  1. Führen Sie den folgenden Code aus und authentifizieren Sie die Befehlszeile mit den Salesforce-Anmeldedaten, die Sie normalerweise verwenden.

    npm run login

  2. Führen Sie den folgenden Code aus, um die LWC in der Organisation bereitzustellen.

    npm run deploy

Schritt 3: Externe Client-App erstellen

Die Salesforce-LWC verwendet den OAuth 2.0-Vorgang für Clientanmeldedaten, um Sie zu authentifizieren. Eine externe Client-App ermöglicht den Flow für Clientanmeldedaten. Verwenden Sie den Consumer-Key und das Consumer-Secret der App, um die Salesforce-LWC so zu konfigurieren, dass Nutzer mit Salesforce authentifiziert werden.

  1. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Manager für externe Client-Apps ein.
    1. Klicken Sie auf Manager für externe Client-Apps > Neue externe Client-App > Erstellen und geben Sie dann die folgenden Informationen ein.
      • Name der externen Client-App: lwc auth
      • API-Name: lwc_auth
      • E‑Mail-Adresse für Kontakt: your_email@example.com
      • API (OAuth-Einstellungen aktivieren) > OAuth aktivieren: ausgewählt
      • API (OAuth-Einstellungen aktivieren) > Callback-URL: https://login.salesforce.com/services/oauth2/callback
      • API (OAuth-Einstellungen aktivieren) > Ausgewählte OAuth-Bereiche: Zugriff auf den Dienst für die Identitäts-URL
      • API (OAuth-Einstellungen aktivieren) > Flow für Clientanmeldedaten aktivieren : ausgewählt
    2. Klicken Sie auf Erstellen.
  2. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Manager für externe Client-Apps ein.
    1. Klicken Sie auf den Namen Ihrer externen Client-App > Bearbeiten.
    2. Gehen Sie zu OAuth-Richtlinien > OAuth-Flows und Erweiterungen für externe Client-Apps.
    3. Achten Sie darauf, dass Flow für Clientanmeldedaten aktivieren ausgewählt ist.
    4. Geben Sie unter Ausführen als Ihren Anmeldenamen ein.
    5. Klicken Sie auf Speichern.
  3. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Manager für externe Client-Apps ein.
    1. Klicken Sie auf den Namen Ihrer externen Client-App > Bearbeiten.
    2. Gehen Sie zu OAuth-Einstellungen > App-Einstellungen > Consumer-Key und ‑Secret.
    3. Geben Sie den Bestätigungscode ein, der an Ihre E‑Mail-Adresse gesendet wurde.
    4. Kopieren Sie den Consumer-Key und das Consumer-Secret an einen sicheren Ort. Sie benötigen sie für einen späteren Schritt.

CORS- und Content Security Policies einrichten

  1. Klicken Sie auf Einrichtung > Einrichtung.
  2. Geben Sie im Feld Schnellsuche den Wert CORS ein und klicken Sie dann auf Bearbeiten.
    1. Wählen Sie CORS für OAuth-Endpunkte aktivieren aus.
    2. Klicken Sie auf Speichern.
  3. Klicken Sie auf Einrichtung > Einrichtung.
  4. Geben Sie im Feld Schnellsuche den Wert Vertrauenswürdige URLs ein und klicken Sie dann auf Neue vertrauenswürdige URL.
  5. Geben Sie die folgenden Informationen ein:
    • API-Name: ui_connector
    • URL: Geben Sie die URL des Cloud Run-Dienstendpunkts für den UI-Connector ein, den Sie mit dem Agent Assist-Integrations-Backend bereitgestellt haben. Sie finden diese URL in der Cloud Run-Konsole. Beispiel: https://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • CSP-Anweisungen: Wählen Sie alle Kästchen aus.
    • Klicken Sie auf Speichern und neu.
  6. Geben Sie die folgenden Informationen ein:
    • API-Name: ui_connector_wss
    • URL: Geben Sie die Secure WebSockets-URL für den Dienstendpunkt des UI-Connectors ein: wss://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • CSP-Anweisungen: Wählen Sie alle Kästchen aus.
    • Klicken Sie auf Speichern und neu.
  7. Geben Sie die folgenden Informationen ein:
    • API-Name: salesforce_domain
    • URL: Geben Sie die URL Ihrer Salesforce-Domain im folgenden Format ein: https://YOUR_SUBDOMAIN.my.salesforce.com.
    • CSP-Anweisungen: Wählen Sie alle Kästchen aus.
    • Klicken Sie auf Speichern.

Schritt 4: Chat-Client konfigurieren

Wenn Sie Agent Assist-UI-Module mit Salesforce verwenden möchten, benötigen Sie einen Chat-Client auf Ihrem Agent-Desktop.

Erweiterten Chat konfigurieren

Führen Sie die folgenden Schritte aus, um Ihren Messenger zu konfigurieren.

  1. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Queues ein und klicken Sie dann auf Neu.
    1. Geben Sie die folgenden Informationen ein:
      • Label: Messaging Queue
      • Queue Name: Messaging_Queue
      • Routing Configuration: Messaging_Routing_Configuration
    2. Klicken Sie auf Unterstützte Objekte und fügen Sie Messaging-Nutzer und Messaging Sitzung hinzu.
    3. Klicken Sie auf Queue-Mitglieder und fügen Sie Nutzer: Ihr Anmeldenutzer hinzu.
    4. Klicken Sie auf Speichern.
  2. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Berechtigungssätze ein.
    1. Klicken Sie auf Berechtigungssatz für Messaging-Agenten.
    2. Klicken Sie auf Zugriff auf Service Presence-Status > Bearbeiten.
    3. Wählen Sie die Status Beschäftigt und Online – Messaging aus.
    4. Klicken Sie auf Hinzufügen > Speichern.
  3. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Nutzer ein und klicken Sie dann auf Nutzer.
    1. Klicken Sie auf Ihren Nutzernamen und prüfen Sie, ob Service Cloud-Nutzer aktiviert ist.
    2. Suchen Sie auf der Seite nach Zuweisungen von Berechtigungssatzlizenzen.
    3. Klicken Sie auf Zuweisungen bearbeiten und wählen Sie dann Enhanced Chat User aus.
    4. Klicken Sie auf Speichern.
    5. Suchen Sie auf der Seite nach Berechtigungssatzzuweisungen.
    6. Klicken Sie auf Zuweisungen bearbeiten und wählen Sie dann Berechtigungssatz für Messaging-Agenten aus.
    7. Klicken Sie auf Hinzufügen > Speichern.
  4. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Messaging-Einstellungen ein und klicken Sie dann auf Neu er Kanal.
    1. Wählen Sie Erweiterter Chat aus.
    2. Geben Sie den Namen ein: Messaging Channel.
    3. Klicken Sie auf Speichern.
    4. Setzen Sie Routing-Typ auf Omni-Queue und Queue auf Messaging Queue.
    5. Klicken Sie auf Speichern und gehen Sie zu den Messaging-Einstellungen.
    6. Klicken Sie auf den Namen Ihres Messaging-Kanals und dann auf Aktivieren.
    7. Lesen und akzeptieren Sie die Nutzungsbedingungen.
  5. Klicken Sie auf Einrichtung > Einrichtung. Geben Sie im Feld Schnellsuche den Wert Bereitstellungen für eingebettete Dienste ein und klicken Sie dann auf Neue Bereitstellung.
    1. Klicken Sie auf Erweiterter Chat > Weiter > Web > Weiter.
    2. Geben Sie die folgenden Details ein:
      • Name: Messaging Embedded Service Deployment
      • Name des Entwicklers: Messaging_Embedded_Service_Deployment
      • Domain: example.com
      • Kanal: Messaging Channel
    3. Klicken Sie auf Speichern. Warten Sie, bis die Bereitstellung abgeschlossen ist.
    4. Klicken Sie in den Einstellungen für Bereitstellung für eingebettete Dienste auf Veröffentlichen.
    5. Klicken Sie auf Aktualisieren und dann auf Messaging testen.

Erweiterten Chat testen

Führen Sie die folgenden Schritte aus, um Ihren Messenger zu testen.

  1. Klicken Sie auf Messaging testen.
  2. Nachdem der neue Tab geladen wurde, klicken Sie auf die Sprechblase, um eine neue Testunterhaltung zu starten.
  3. Senden Sie eine Nachricht, z. B. Test.
  4. Gehen Sie zum Salesforce-Browsertab.
  5. Klicken Sie auf das Menü App Launcher und wählen Sie dann Service Console aus.
  6. Klicken Sie auf Omni-Channel.
  7. Setzen Sie Ihren Status auf Online – Messaging.
  8. Akzeptieren Sie die eingehende Nachricht. Dadurch wird in der Service Console ein neuer Tab für die Unterhaltung geöffnet. Sie können das Chat-Transkript nicht sehen.
  9. Klicken Sie auf Einstellungen und wählen Sie Seite bearbeiten aus.
  10. Ziehen Sie im Menü Komponenten die Komponente Erweiterte Unterhaltung in den Bereich Unterhaltung.
  11. Klicken Sie auf Speichern > Aktivieren > Als Standard für Organisation zuweisen > Desktop > Zurück .
  12. Aktualisieren Sie die Seite.
  13. Klicken Sie auf Omni-Channel.
  14. Setzen Sie Ihren Status auf Online – Messaging.
  15. Antworten Sie auf die Nachricht Test , um zu prüfen, ob Messaging funktioniert.

Wenn Sie nicht weiterkommen und weitere Informationen benötigen, lesen Sie den umfassenden Einrichtungsleitfaden für den erweiterten Chat in Salesforce.

Schritt 5: Salesforce Lightning Web Component installieren

Führen Sie die folgenden Schritte aus, um die Salesforce-LWC mit dem Lightning Experience-Editor zu einer Seite für Messaging-Sitzungen hinzuzufügen. Fahren Sie mit der Testunterhaltung aus Schritt 4 fort.

  1. Klicken Sie auf Einstellungen und wählen Sie Seite bearbeiten aus.

  2. Ziehen Sie agentAssistContainerModule aus der Liste Komponenten auf die Seite.

  3. Klicken Sie auf die Komponente, die Sie im vorherigen Schritt platziert haben.

  4. Füllen Sie die Formularfelder wie folgt aus, um Konfigurationsdetails hinzuzufügen.

    • Endpunkt: Die URL des UI-Connectors Ihres Agent Integration-Backends, z. B. eine URL aus der Cloud Run-Konsole wie: https://UI_CONNECTOR_ENDPOINT.GCP_REGION.run.app
    • Kanal: Geben Sie an, dass der Kanal chat ist.
    • Plattform: Geben Sie an, dass die Plattform messaging ist.
    • conversationProfile: Ihr Agent Assist-Unterhaltungsprofil Ressourcenname (Beispiel: projects/GCP_PROJECT_ID/locations/GCP_REGION/conversationProfiles/CONVERSATION_PROFILE_ID)
    • consumerKey: Der Consumer-Key der externen Client-App aus Schritt 3.
    • consumerSecret: Das Consumer-Secret der externen Client-App aus Schritt 3.
    • containerHeight: Die Höhe des Agent Assist-Containers.