Salesforce-Integration

Verwenden Sie die Salesforce Lightning Web Component (LWC), um die Agent Assist-UI-Module für Chatunterhaltungen einzubinden.

Hinweise

Um Agent Assist-UI-Module in Salesforce einzubinden, benötigen Sie Zugriff auf die folgenden Ressourcen:

  • Node.js

    Folgen Sie der empfohlenen Installationsanleitung für Ihr Betriebssystem.

  • Salesforce-Befehlszeile

    Die Installation der Salesforce-Befehlszeile mit npm kann zu Kompatibilitätsproblemen führen. Um diese Probleme zu vermeiden, verwenden Sie eine der Installationsoptionen pkg (macOS), exe (Windows) oder TAR (Linux).

  • gcloud-CLI

    Installieren Sie den gcloud-Befehl wie beschrieben und authentifizieren Sie sich mit gcloud auth login.

  • Salesforce-Benutzeroberfläche

    • Melden Sie sich über die URL Ihrer Instanz oder die Salesforce-Anmeldeseite an und beachten Sie Folgendes:
      • Ihre Salesforce-Meine Domain-URL. So finden Sie die Meine Domain-URL:
        1. Gehen Sie zur Menüleiste > Menü Einrichtung.
        2. Klicken Sie auf Einrichten.
        3. Geben Sie in der Schnellsuche den Begriff Meine Domain ein. Der Domainname hat das folgende Format: MY-DOMAIN-NAME.develop.my.salesforce.com.
      • Ihre Salesforce-Organisations-ID. So finden Sie die Organisations-ID:
        1. Gehen Sie zur Menüleiste > Menü Einrichtung.
        2. Klicken Sie auf Einrichten.
        3. Geben Sie in der Schnellsuche „Unternehmensinformationen“ ein. Hinweis: Diese Integrationsschritte wurden nur mit der Salesforce Developer Edition getestet. Wenn Sie eine andere Version verwenden, kann es zu Unterschieden bei den Funktionslizenzen und der Salesforce-Benutzeroberfläche kommen.
  • Agent Assist-Integrations-Backend

    1. Folgen Sie der Anleitung, um die Integration einzurichten.
    2. Konfigurieren Sie vor dem Ausführen des Bereitstellungsskripts die folgenden Umgebungsvariablen mit deploy.sh oder in einer .env-Datei im Projektstammverzeichnis:
      • AUTH_OPTION: Setzen Sie dies auf SalesforceLWC.
      • SALESFORCE_DOMAIN: Ein Domainname, der YOUR_SUBDOMAIN.develop.lightning.force.com ähnelt. Diesen Wert haben Sie in der Salesforce-UI-Voraussetzung notiert. https:// darf nicht enthalten sein.
      • SALESFORCE_ORGANIZATION_ID: Diesen Wert haben Sie in der Salesforce-Benutzeroberfläche notiert.

Schritt 1: Projekt einrichten

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

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

    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    cd salesforce/aa-lwc
    
  2. Laden Sie die JS-Dateien herunter, die später als statische Ressourcen bereitgestellt werden, indem Sie die folgenden Befehle ausführen:

    npm run generate-static-resources
    npm install
    

Schritt 2: Umgebung einrichten

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

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 in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Omni-Channel Settings“ (Omnichannel-Einstellungen) ein und klicken Sie dann auf Omni-Channel Settings (Omnichannel-Einstellungen).
    1. Klicken Sie auf Omni-Channel aktivieren.
    2. Wählen Sie im neuen Fenster oder Tab Agents automatisch in Omni-Channel anmelden aus.
    3. Klicken Sie auf Speichern.
  2. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Communities“ ein und klicken Sie dann auf Digital Experiences (Digitale Erlebnisse) > Settings (Einstellungen).
    1. Klicken Sie das Kästchen Experience Workspaces aktivieren an.
    2. Klicken Sie auf Speichern.

Organisation mit der Salesforce-Befehlszeile konfigurieren

So konfigurieren Sie Ihre Organisation mit der Salesforce CLI für die Agent Assist-Integration:

  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 Ablauf der Clientanmeldedaten. Verwenden Sie den Consumer-Key und das Consumer-Secret der App, um die Salesforce-LWC zu konfigurieren, damit Nutzer bei Salesforce authentifiziert werden.

  1. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Manager für externe Client-Apps“ ein.
    1. Klicken Sie auf External Client App Manager > New External Client App > Create und geben Sie die folgenden Informationen ein.
      • Name der verbundenen 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) > Rückruf-URL: https://login.salesforce.com/services/oauth2/callback
      • API (OAuth-Einstellungen aktivieren) > Ausgewählte OAuth-Bereiche: Auf den Identitäts-URL-Dienst zugreifen
      • API (OAuth-Einstellungen aktivieren) > Ablauf der Clientanmeldedaten aktivieren: Ausgewählt
    2. Klicken Sie auf Erstellen.
  2. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Manager für externe Client-Apps“ ein.
    1. Klicken Sie auf den Namen der verbundenen App > Bearbeiten.
    2. Rufen Sie OAuth-Richtlinien > OAuth-Flows und externe Client-App-Erweiterungen auf.
    3. Achten Sie darauf, dass Clientanmeldedaten-Flow aktivieren ausgewählt ist.
    4. Geben Sie unter Ausführen als Ihren Anmeldenamen ein.
    5. Klicken Sie auf Speichern.
  3. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Manager für externe Client-Apps“ ein.
    1. Klicken Sie auf den Namen der verbundenen App > Bearbeiten.
    2. Gehen Sie zu OAuth-Einstellungen > App-Einstellungen > Consumer-Schlüssel 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 diese für einen späteren Schritt.
  4. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „CORS“ ein und klicken Sie auf Bearbeiten.
    1. Aktivieren Sie CORS für OAuth-Endpunkte aktivieren.
    2. Klicken Sie auf Speichern.

Weitere Informationen zu verbundenen Apps finden Sie in den folgenden Salesforce-Ressourcen.

Schritt 4: Chatclient konfigurieren

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

Mitteilungen für In-App und Web konfigurieren

So konfigurieren Sie Ihren Messenger:

  1. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Vertrauenswürdige URLs“ ein und klicken Sie dann auf Neue vertrauenswürdige URL.
    1. Geben Sie den API-Namen ein: ui_connector.
    2. Geben Sie die URL des Cloud Run-Dienstendpunkts des UI-Connectors ein, den Sie mit dem Backend Ihrer Agent Assist-Integration bereitgestellt haben. Sie finden diese URL in der Cloud Run-Konsole. Beispiel: https://UI_CONNECTOR_SUBDOMAIN.us-central1.run.app
    3. Wählen Sie alle Optionen unter CSP-Anweisungen aus.
    4. Klicken Sie auf Save & New (Speichern und neu).
    5. Geben Sie den API-Namen ein: twilio_flex.
    6. Geben Sie die URL https://flex.twilio.com ein.
    7. Wählen Sie alle Optionen unter CSP-Anweisungen aus.
    8. Klicken Sie auf Save & New (Speichern und neu).
    9. Geben Sie den API-Namen ein: salesforce_domain.
    10. Geben Sie die URL Ihrer Salesforce-Domain im folgenden Format ein: https://YOUR_SUBDOMAIN.my.salesforce.com.
    11. Wählen Sie alle Optionen unter CSP-Anweisungen aus.
    12. Klicken Sie auf Speichern.
  2. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Warteschlangen“ ein und klicken Sie auf Neu.
    1. Geben Sie die folgenden Informationen ein:
      • Label: Messaging Queue
      • Warteschlangenname: Messaging_Queue
      • Routingkonfiguration: Messaging_Routing_Configuration
    2. Klicken Sie auf Unterstützte Objekte und fügen Sie dann „Messaging User, Messaging Session“ (Messaging-Nutzer, Messaging-Sitzung) hinzu.
    3. Klicken Sie auf Queue Members (Warteschlangenmitglieder) und fügen Sie dann „User: Your Login User“ (Nutzer: Ihr Anmeldenutzer) hinzu.
    4. Klicken Sie auf Speichern.
  3. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Berechtigungssätze“ ein.
    1. Klicken Sie auf Messaging Agents Permission Set (Berechtigungssatz für Messaging-Agents).
    2. Klicken Sie auf Zugriff auf Servicepräsenzstatus > Bearbeiten.
    3. Wählen Sie die Status Beschäftigt und Online – Messaging aus.
    4. Klicken Sie auf Hinzufügen > Speichern.
  4. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Nutzer“ ein und klicken Sie dann auf Nutzer.
    1. Klicken Sie auf Ihren Nutzernamen und prüfen Sie, ob Service Cloud User aktiviert ist.
    2. Suchen Sie auf der Seite nach Zuweisungen von Berechtigungssatzlizenzen.
    3. Klicken Sie auf Zuweisungen bearbeiten und setzen Sie dann ein Häkchen bei Messaging for In-App and Web User (Messaging für In-App- und Webnutzer).
    4. Klicken Sie auf Speichern.
    5. Suchen Sie auf der Seite nach Zuweisungen des Berechtigungssatz.
    6. Klicken Sie auf Zuweisungen bearbeiten und wählen Sie dann Berechtigungssatz für Messaging-Kundenservicemitarbeiter aus.
    7. Klicken Sie auf Hinzufügen > Speichern.
  5. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Messaging Settings“ (Messaging-Einstellungen) ein und klicken Sie dann auf New Channel (Neuer Channel).
    1. Wählen Sie Messaging für In-App und Web aus.
    2. Geben Sie den Namen ein: Messaging-Kanal.
    3. Klicken Sie auf Speichern.
    4. Legen Sie Routing Type auf „Omni-Queue“ und Queue auf „Messaging Queue“ fest.
    5. Klicken Sie auf Speichern und rufen Sie die Messaging-Einstellungen auf.
    6. Klicken Sie auf den Namen Ihres Messaging-Kanals und dann auf Aktivieren.
    7. Lesen Sie die Nutzungsbedingungen und akzeptieren Sie sie.
  6. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie in der Schnellsuche „Embedded Service Deployments“ (Bereitstellungen eingebetteter Dienste) ein und klicken Sie dann auf New Deployment (Neue Bereitstellung).
    1. Klicken Sie auf Messaging für In-App und Web > Weiter > Web > Weiter.
    2. Geben Sie die folgenden Informationen ein:
      • Name: Messaging Embedded Service Deployment
      • Name des Entwicklers: Messaging_Embedded_Service_Deployment
      • Domain: beispiel.de
      • Channel: Messaging-Channel
    3. Klicken Sie auf Speichern. Warten Sie, bis die Bereitstellung abgeschlossen ist.
    4. Klicken Sie in den Einstellungen für Bereitstellung des eingebetteten Dienstes auf Veröffentlichen.
    5. Klicken Sie auf Aktualisieren und dann auf Test-Messaging.

Messaging für In-App und Web testen

So testen Sie Ihren Messenger:

  1. Klicken Sie auf Messaging testen.
  2. Klicken Sie nach dem Laden des neuen Tabs auf die Sprechblase, um eine neue Testunterhaltung zu starten.
  3. Senden Sie eine Nachricht, z. B. "Test".
  4. Rufen Sie den Salesforce-Browsertab auf.
  5. Klicken Sie in der Symbolleiste Einrichtung auf das Menü App Launcher und wählen Sie Service Console aus.
  6. Klicken Sie in der Dienstprogrammleiste auf Omni-Channel.
  7. Stellen Sie Ihren Status auf Online – Messaging ein.
  8. Nehmen Sie die eingehende Nachricht an. Dadurch wird ein neuer Tab in der Service Console für die Unterhaltung geöffnet. Sie können das Chat-Transkript nicht sehen.
  9. Gehen Sie zur Menüleiste > Menü Einrichtung.
  10. Klicken Sie auf Seite bearbeiten.
  11. Ziehen Sie aus dem Menü „Komponenten“ die Option Erweiterte Unterhaltung in den Bereich Unterhaltung.
  12. Klicken Sie auf Speichern > Aktivieren > Als Standard für Organisation zuweisen > Desktop > Zurück .
  13. Aktualisieren Sie die Seite.
  14. Klicken Sie in der Dienstprogrammleiste auf Omni-Channel.
  15. Stellen Sie Ihren Status auf Online – Messaging ein.
  16. Antworten Sie auf die Nachricht „Test“, um zu prüfen, ob die Nachrichtenfunktion funktioniert.

Wenn Sie nicht weiterkommen und weitere Informationen benötigen, lesen Sie den ausführlichen Einrichtungsleitfaden für Salesforce Messaging für In-App und Web.

Schritt 5: Salesforce-LWC installieren

So fügen Sie die Salesforce-LWC mit dem Lightning Experience-Editor in eine Seite für Messaging-Sitzungen ein: Fahren Sie mit der Testunterhaltung aus Schritt 4 fort.

  1. Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Seite bearbeiten.
  2. Verschieben Sie agentAssistContainerModule aus der Seitenleiste Komponenten in die Seitenleiste.

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

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

    • Endpunkt: Die URL Ihres Agent Integration Backend-UI-Connectors, z. B. eine URL aus der Cloud Run-Konsole, wie: https://UI-CONNECTOR-ENDPOINT.GCP-REGION.run.app
    • Funktionen: Agent Assist-Funktionen, die in Ihrem Unterhaltungsprofil aktiviert sind,z. B. CONVERSATION_SUMMARIZATION,KNOWLEDGE_ASSIST_V2,SMART_REPLY und AGENT_COACHING
    • conversationProfile: Der Ressourcenname Ihres Agent Assist-Konversationsprofils (Beispiel: projects/GCP-PROJECT-ID/locations/GCP-REGION/conversationProfiles/CONVERSATION-PROFILE-ID)
    • consumerKey: Der Consumer-Key der verbundenen App aus Schritt 3.
    • consumerSecret: Das Consumer-Secret der verbundenen App aus Schritt 3