Diese Seite wurde von der Cloud Translation API übersetzt.

Salesforce-Chatintegration

Verwenden Sie die Salesforce Lightning-Webkomponente (LWC), um die Integration mit Agent Assist-UI-Modulen für Chatunterhaltungen zu ermöglichen.

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

Folgen Sie der empfohlenen Installationsanleitung für Ihr Betriebssystem.
Google Cloud CLI

Installieren Sie den gcloud-Befehl wie beschrieben und authentifizieren Sie sich mit gcloud auth login.
Salesforce
1. Melden Sie sich über Ihre Instanz-URL oder die Salesforce-Anmeldeseite an und beachten Sie Folgendes:
2. 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 im Feld Schnellsuche Meine Domain ein. Der Domainname hat das folgende Format: MY-DOMAIN-NAME.develop.my.salesforce.com.
3. 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 im Feld Schnellsuche Unternehmensinformationen ein. Hinweis: Diese Integrationsschritte wurden nur mit der Salesforce Developer Edition getestet. Wenn Sie eine andere Edition verwenden, kann es zu Unterschieden bei den Funktionslizenzen und der Salesforce-Benutzeroberfläche kommen.
Back-End für die Agent Assist-Integration
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:
3. AUTH_OPTION: Setzen Sie dies auf SalesforceLWC.
4. SALESFORCE_DOMAIN: Ein Domainname, der YOUR_SUBDOMAIN.develop.lightning.force.com ähnelt. Diesen Wert haben Sie in den Salesforce-Voraussetzungen notiert. https:// darf nicht enthalten sein.
5. SALESFORCE_ORGANIZATION_ID: Diesen Wert haben Sie in der Salesforce-Voraussetzung notiert.

Schritt 1: Projekt einrichten

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

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
```
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.

Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld Schnellsuche den Wert Omni-Channel Settings (Omni-Channel-Einstellungen) ein und klicken Sie dann auf Omni-Channel Settings (Omni-Channel-Einstellungen).
1. Wählen Sie Omnichannel aktivieren aus.
2. Wählen Sie im neuen Fenster oder Tab Agents automatisch bei Omni-Channel anmelden aus.
3. Klicken Sie auf Speichern.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld Schnellsuche Communities ein und klicken Sie dann auf Digital Experiences > 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 Ihre Organisation mit der Salesforce CLI für die Agent Assist-Integration zu konfigurieren.

Führen Sie den folgenden Code aus und authentifizieren Sie die Befehlszeile mit den Salesforce-Anmeldedaten, die Sie normalerweise verwenden.
```
npm run login
```
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.

Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld 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.
2. Name der externen Client-App: lwc auth
3. API-Name: lwc_auth
4. E‑Mail-Adresse für Kontakt: your_email@example.com
5. API (OAuth-Einstellungen aktivieren) > OAuth aktivieren: Ausgewählt
6. API (OAuth-Einstellungen aktivieren) > Rückruf-URL: https://login.salesforce.com/services/oauth2/callback
7. API (OAuth-Einstellungen aktivieren) > Ausgewählte OAuth-Bereiche: Auf den Identitäts-URL-Dienst zugreifen
8. API (OAuth-Einstellungen aktivieren) > Ablauf für Clientanmeldedaten aktivieren: Ausgewählt
9. Klicken Sie auf Erstellen.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld Schnellsuche Manager für externe Client-Apps ein.
1. Klicken Sie auf den Namen Ihrer externen Client-App > Bearbeiten.
2. Rufen Sie OAuth-Richtlinien > OAuth-Abläufe und externe Client-App-Erweiterungen auf.
3. Achten Sie darauf, dass Enable Client Credentials Flow (Ablauf für Clientanmeldedaten aktivieren) ausgewählt ist.
4. Geben Sie unter Ausführen als Ihren Anmeldenamen ein.
5. Klicken Sie auf Speichern.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld Schnellsuche 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-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.

CORS- und Content Security Policy festlegen

Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung.
Geben Sie im Feld Schnellsuche CORS ein und klicken Sie dann auf Bearbeiten.
1. Wählen Sie CORS für OAuth-Endpunkte aktivieren aus.
2. Klicken Sie auf Speichern.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung.
Geben Sie im Feld Schnellsuche Vertrauenswürdige URLs ein und klicken Sie dann auf Neue vertrauenswürdige URL.
Geben Sie den API-Namen ein: ui_connector
1. Geben Sie die URL des Cloud Run-Dienstendpunkts für den UI-Connector ein, den Sie mit dem Backend Ihrer Agent Assist-Integration bereitgestellt haben. Sie finden diese URL in der Cloud Run-Konsole. Beispiel: https://<var>UI_CONNECTOR_SUBDOMAIN</var>.<var>GCP_REGION</var>.run.app.
2. Klicken Sie alle Kästchen unter CSP-Anweisungen an.
3. Klicken Sie auf Save & New (Speichern und neu).
Geben Sie den API-Namen ein: salesforce_domain
1. Geben Sie die URL Ihrer Salesforce-Domain im folgenden Format ein: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
2. Klicken Sie alle Kästchen unter CSP-Anweisungen an.
3. Klicken Sie auf Speichern.

Schritt 4: Chatclient konfigurieren

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

Erweiterten Chat konfigurieren

So konfigurieren Sie Ihren Messenger:

Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld 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 für den UI-Connector ein, den Sie mit dem Backend für die Agent Assist-Integration bereitgestellt haben. Sie finden diese URL in der Cloud Run-Konsole. Beispiel: https://<var>UI_CONNECTOR_SUBDOMAIN</var>.us-central1.run.app
3. Klicken Sie alle Kästchen unter CSP-Anweisungen an.
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. Klicken Sie alle Kästchen unter CSP-Anweisungen an.
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://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
11. Klicken Sie alle Kästchen unter CSP-Anweisungen an.
12. Klicken Sie auf Speichern.
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:
2. Label: Messaging Queue (Warteschlange für Nachrichten)
3. Name der Warteschlange: Messaging_Queue
4. Routingkonfiguration: Messaging_Routing_Configuration
5. Klicken Sie auf Unterstützte Objekte und fügen Sie dann Messaging User (Messaging-Nutzer) und Messaging Session (Messaging-Sitzung) hinzu.
6. Klicken Sie auf Queue Members (Warteschlangenmitglieder) und fügen Sie dann User: Your Login User (Nutzer: Ihr Anmeldenutzer) hinzu.
7. Klicken Sie auf Speichern.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld 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.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld 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 Permission Set License Assignments (Zuweisungen von Berechtigungssatzlizenzen).
3. Klicken Sie auf Zuweisungen bearbeiten und wählen Sie dann Erweiterter Chatnutzer aus.
4. Klicken Sie auf Speichern.
5. Suchen Sie auf der Seite nach Permission Set Assignments (Zuweisungen des Berechtigungssatzes).
6. Klicken Sie auf Zuweisungen bearbeiten und wählen Sie dann Berechtigungssatz für Messaging-Agenten aus.
7. Klicken Sie auf Hinzufügen > Speichern.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld Schnellsuche Messaging-Einstellungen ein und klicken Sie dann auf Neuer Channel.
1. Wählen Sie Erweiterter Chat aus.
2. Geben Sie den Namen ein: Messaging Channel (Messaging-Kanal).
3. Klicken Sie auf Speichern.
4. Setzen Sie Routing-Typ auf Omni-Warteschlange und Warteschlange auf Messaging-Warteschlange.
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.
Klicken Sie in der Menüleiste auf das Menü Einrichtung und dann auf Einrichtung. Geben Sie im Feld Schnellsuche Embedded Service Deployments (Bereitstellungen für eingebettete Services) ein und klicken Sie dann auf New Deployment (Neue Bereitstellung).
1. Klicken Sie auf Erweiterter Chat > Weiter > Web > Weiter.
2. Geben Sie die folgenden Informationen ein:
3. Name: Messaging Embedded Service Deployment
4. Name des Entwicklers: Messaging_Embedded_Service_Deployment
5. Domain: beispiel.de
6. Channel: Messaging Channel
7. Klicken Sie auf Speichern. Warten Sie, bis die Bereitstellung abgeschlossen ist.
8. Klicken Sie in den Einstellungen für Bereitstellung eingebetteter Dienste auf Veröffentlichen.
9. Klicken Sie auf Aktualisieren und dann auf Test-Messaging.

Erweiterten Chat testen

So testen Sie Ihren Messenger:

Klicken Sie auf Messaging testen.
Klicken Sie nach dem Laden des neuen Tabs auf die Sprechblase, um eine neue Testunterhaltung zu starten.
Senden Sie eine Nachricht, z. B. Test.
Rufen Sie den Salesforce-Browsertab auf.
Klicken Sie in der Symbolleiste Einrichtung auf das Menü App Launcher und wählen Sie Service Console aus.
Klicken Sie in der Dienstprogrammleiste auf Omni-Channel.
Stellen Sie Ihren Status auf Online – Messaging ein.
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.
Gehen Sie zur Menüleiste > Menü Einrichtung.
Klicken Sie auf Seite bearbeiten.
Ziehen Sie die Komponente Erweiterte Unterhaltung aus dem Menü Komponenten in den Bereich Unterhaltung.
Klicken Sie auf Speichern > Aktivieren > Als Standard für Organisation zuweisen > Desktop > Zurück .
Aktualisieren Sie die Seite.
Klicken Sie in der Dienstprogrammleiste auf Omni-Channel.
Stellen Sie Ihren Status auf Online – Messaging ein.
Antworten Sie auf die Nachricht Test, um zu bestätigen, dass die Nachrichtenübermittlung funktioniert.

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

Schritt 5: Salesforce Lightning-Webkomponente 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.

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

Hinweis :Diese Komponente wurde vom Befehl npm deploy bereitgestellt.
Klicken Sie auf die Komponente, die Sie im vorherigen Schritt platziert haben.
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://<var>UI_CONNECTOR_ENDPOINT</var>.<var>GCP_REGION</var>.run.app
- Funktionen: Agent Assist-Funktionen, die in Ihrem Unterhaltungsprofil aktiviert sind,z. B. CONVERSATION_SUMMARIZATION,KNOWLEDGE_ASSIST_V2,SMART_REPLY und AGENT_COACHING
- Kanal: Gib an, dass der Kanal chat ist.
- platform: Geben Sie an, dass die Plattform messaging ist.
- conversationProfile: Der Ressourcenname Ihres Agent Assist-Konversationsprofils (Beispiel: projects/<var>GCP_PROJECT_ID</var>/locations/<var>GCP_REGION</var>/conversationProfiles/<var>CONVERSATION_PROFILE_ID</var>)
- consumerKey: Der Consumer-Key der externen Client-App aus Schritt 3
- consumerSecret: Das Consumer-Secret der externen Client-App aus Schritt 3.