Genesys Cloud-Anwendungsserver bereitstellen

Sie können einen Anwendungsserver zum Rendern von Agent Assist-Vorschlägen im Web in Genesys Cloud einrichten.

Ziele

Die Genesys Cloud-Integration umfasst die folgenden Prozesse:

  1. Stellen Sie den Backend-Server für das UI-Modul bereit, um die Dialogflow API aufzurufen, ein Authentifizierungstoken zu registrieren und Cloud Pub/Sub und Memorystore for Redis einzurichten.
  2. Stellen Sie den Genesys Cloud-Anwendungsserver zum Rendern des Agent Assist-UI-Moduls in Cloud Run bereit.
  3. OAuth-Client erstellen
  4. Füllen Sie die Umgebungsvariablen aus.
  5. Richten Sie das Interaktions-Widget in Genesys Cloud ein.
  6. Konfigurieren Sie die Agent Assist-Integration mit dem Interaktions-Widget in Genesys Cloud.
  7. Messenger in Genesys Cloud konfigurieren
  8. Verwenden Sie die Webchat- und Messaging-Tools von Genesys Cloud, um die Integration zu testen.

Hinweise

Sie müssen die folgenden Aktionen ausführen, bevor Sie mit der Genesys Cloud-Integration beginnen:

  1. Installieren Sie die Google Cloud CLI, falls Sie sie noch nicht konfiguriert haben.
  2. Folgen Sie der Google Cloud Anleitung zum Erstellen eines Dienstkontos und Zuweisen der Rolle „Dialogflow API Client“.
  3. Wenden Sie sich an agent-assist-ui-modules-support@google.com, um Zugriff auf das Genesys Cloud-Repository zu erhalten.
  4. Stellen Sie ein Backend für Agent Assist-UI-Module bereit. Wenn Sie den Backend-Server bereitstellen, geben Sie die Umgebungsvariable AUTH_OPTION als GenesysCloud an. Folgen Sie dazu der Bereitstellungsanleitung.

Genesys Cloud-Anwendungsserver mit der CLI bereitstellen

  1. Klonen Sie das Git-Repository mit dem folgenden Code auf Ihren lokalen Computer oder in Ihre Entwicklungsumgebung: 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
  2. Verwenden Sie in Ihrem lokalen Terminal den folgenden Code, um das aktive Verzeichnis in das Stammverzeichnis des Repositorys zu ändern, in dem sich die Docker-Datei befindet, bevor Sie die Google Cloud CLI-Builds ausführen. 
    cd genesyscloud/frontend
  3. Wenn Sie zur Eingabe eines Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste, um den Standardwert zu übernehmen.
  4. Stellen Sie die Integration mit dem folgenden Befehl bereit. Ersetzen Sie PROJECT-ID durch die Projekt-ID Ihres Agents, Google Cloud durch die Client-E-Mail-Adresse Ihres Dienstkontos und legen Sie REGION für Cloud Run fest.UI_MODULE_SERVICE_ACCOUNT 
    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
    
--source ./ 
    
--service-account=$ui_module_service_account 
    
--memory 1Gi --platform managed 
    
--region us-central1 
    
--allow-unauthenticated
  5. Klicken Sie auf Eingabe, um den Standarddienstnamen zu übernehmen.

Weitere Informationen finden Sie in der Cloud Run-Dokumentation. In der Google Cloud Console können Sie unter Cloud Run eine Liste Ihrer aktiven Integrationsbereitstellungen aufrufen.

OAuth-Client erstellen

  1. Folgen Sie der Anleitung in der Genesys Cloud-Dokumentation, um einen neuen OAuth-Client (Token Implicit Grant) zu erstellen.
  2. Prüfen Sie, ob der Grant-Typ Implizite Berechtigung (Browser) ist.
  3. Fügen Sie die URL Ihrer Anwendung dem Abschnitt Autorisierte Weiterleitungs-URIs hinzu.
  4. Aktualisieren Sie die Dauer des OAuth 2.0-Clienttokens auf 3.600 Sekunden. Dies entspricht dem JWT-Token für den Dialogflow API-Zugriff von 1 Stunde. 
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
  5. Ersetzen Sie CONVERSATION_PROFILE_NAME durch den Namen des Unterhaltungsprofils, z. B. projects/your-project/locations/your-location/conversationProfiles/abc123.
  6. Ersetzen Sie {FEATURES} durch eine durch Kommas getrennte Liste der Agent Assist-Funktionen, die in der Anwendung enthalten sein sollen. Wichtig: Fügen Sie nur Funktionen ein, die in Ihrem Konversationsprofil konfiguriert sind. Genesys Cloud unterstützt die folgenden Funktionen:
  7. Wenn Sie dem OAuth-Client Bereiche hinzufügen möchten, gehen Sie zum Bereich Bereich und wählen Sie Ihre Tags aus.

Die Bereiche sollten Benachrichtigungen, Autorisierung, Unterhaltungen, Benachrichtigungen und Organisation umfassen.

Beispiel-URL: 

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

Umgebungsvariablen vervollständigen

Die Genesys Cloud-Anwendung verwendet die folgenden Umgebungsvariablen. Folgen Sie der Cloud Run-Anleitung, um die Umgebungsvariablen festzulegen.

  • OAUTH_CLIENT_ID: Genesys Cloud-OAuth-Client-ID.
  • GENESYS_CLOUD_REGION: die Genesys Cloud-Region. Zum Beispiel usw2.pure.cloud für „US West(Oregon)“. Der Standardwert ist mypurecloud.com.
  • GENESYS_CLOUD_ENVIRONMENT: Genesys Cloud-Umgebung. Der Standardwert ist prod.
  • PROXY_SERVER: Die URL des Agent Assist-Backend-Connectors.
  • APPLICATION_SERVER_URL: URL des UI-Anwendungsservers.
  • PROJECT_ID: Ihre Google Cloud -Projekt-ID
  • CONVERSATION_PROFILE: Das zu verwendende Unterhaltungsprofil. Dieser sollte mit dem Profil in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.
  • FEATURES: Durch Kommas getrennte Konstante für Agent Assist-Funktionen. Dies sollte mit den Funktionen in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.
  • CHANNEL: Wählen Sie den Integrationstyp aus. Der Wert kann „voice“ oder „chat“ sein.

Beispiel für eine .env-Datei: 

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

Wenn Sie einen OAuth-Client erstellen, stellt Genesys Cloud auch eine Client-ID bereit.

Führen Sie den Bereitstellungsbefehl mit aktualisierten Umgebungsvariablen aus. 

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

    --source ./ 

    --service-account=$ui_module_service_account 

    --memory 1Gi --platform managed 

    --region us-central1 

    --allow-unauthenticated 

    --set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

Der Genesys Cloud-Anwendungsserver muss auf einem Google Cloud -Hostingdienst bereitgestellt werden. App Engine oder Cloud Run verwenden

Anwendungsserver herunterfahren

  1. Löschen Sie den Cloud Run-Dienst.
  2. Führen Sie in Ihrem lokalen Terminal den folgenden Befehl aus: 
    gcloud run services list
  3. Wählen Sie die zuvor ausgewählte Zielplattform aus, um aktive Bereitstellungen aufzulisten.
  4. Führen Sie dazu diesen Befehl aus: 
    gcloud run services delete agent-assist-modules-application-server

Haftungsausschluss für Preise

Wenn Sie die Genesys Cloud-Integration verwenden, fallen Kosten für den zugrunde liegenden Cloud Run-Dienst an.

Nächste Schritte