Connessione a Genesys Bot Connector

Modifica online

Anteprima

Genesys Bot Connector consente di integrare senza problemi bot di terze parti nei flussi di messaggi di Genesys Architect. Ciò consente al vostro agente di interagire con gli utenti attraverso formati di messaggistica ricchi, come le risposte rapide e le schede, migliorando l'esperienza di conversazione complessiva. Per ulteriori dettagli, consultare la documentazione relativa al Genesys Bot Connector.

Una volta integrato, l'agente può:

  • Partecipare ai flussi di messaggistica guidati dall'architetto

  • Rispondere con elementi dell'interfaccia utente ricchi, come le risposte rapide e le schede

  • Operare come agente virtuale all'interno dell'ambiente Genesys

Nota:

Il connettore bot Genesys potrebbe andare in timeout dopo 8 secondi durante la gestione delle richieste. Se una risposta richiede più di 8 secondi, la richiesta potrebbe non andare a buon fine e causare un errore del server, che è più probabile che si verifichi durante flussi complessi o quando vengono utilizzati strumenti.

Prima di iniziare

Prima di iniziare l'integrazione, è necessario soddisfare i seguenti prerequisiti:

  • Si dispone di un account Genesys Cloud con accesso a Genesys Architect nella regione corretta. Accedi al portale Genesys Cloud.

  • Si ricopre il ruolo di amministratore nell'organizzazione Genesys Cloud. Per ulteriori dettagli, consultare la panoramica su ruoli e autorizzazioni.

Panoramica della configurazione

Per collegare l'agente a Genesys Bot Connector, seguire i seguenti passaggi:

Creare un canale Genesys Bot Connector

  1. Vai alla pagina di configurazione dell'agente.

  2. Vai su Canali > Genesys Bot Connector e seleziona l'ambiente in cui desideri creare la connessione (Bozza o Live).

  3. Fare clic su Crea nuovo per creare un nuovo canale Genesys Bot Connector.

Aggiungere lo schema bot all'elenco bot di Genesys

Per registrare un bot su Genesys, inviare il seguente payload JSON all'endpoint dello schema dell'elenco dei bot. Utilizzare l'API e l'endpoint Genesys per completare la richiesta.

{
  "chatBots": [
    {
      "id": "IBM-Watsonx-Genesys-BotConnector",
      "name": "IBM Watsonx Orchestrate BotConnector",
      "description": "IBM Watsonx Orchestrate Genesys Bot Connector Channel",
      "versions": [
        {
          "version": "1.0",
          "supportedLanguages": [
            "en-us"
          ],
          "intents": [
            {
              "name": "Success",
              "slots": {
                "Intent": {
                  "name": "Intent",
                  "type": "string"
                }
              }
            }
          ]
        }
      ]
    }
  ]
}

Dopo l'aggiunta del bot, è possibile selezionare IBM Watsonx Orchestrate BotConnector come nome del bot nel flusso Genesys.

Configurazione del connettore Bot in Genesys

  1. Configurare la sorgente bot dal menu di amministrazione di Genesys Cloud.

  2. Per ulteriori dettagli, consultare la sezione "Creazione di un connettore bot" in Genesys.

Integrare il connettore con l'agente

Per completare l'integrazione:

  1. Accedere al proprio account Genesys Cloud con accesso Architect.

  2. Per completare la connessione del bot, tieni a portata di mano il tuo ID di integrazione e il valore segreto definito nella scheda Credenziali.

  3. Raccogliere i seguenti dettagli:

    • ID cliente e segreto cliente : nella pagina di amministrazione di Genesys, vai su Integrazioni > Autenticazione, copia l'ID cliente e il segreto cliente e incollali nei campi corrispondenti.

    • Token di verifica : Il valore segreto definito nella scheda Credenziali (associato a x-watson-genesys-verification-token).

    • ID Bot Connector : L'ID di integrazione del Genesys Bot Connector.

    • URI dell'API : nella pagina di panoramica dell'API di Genesys, vai alla sezione "URI del server API ", copia l'URI relativo alla tua regione e incollalo nel campo "URI dell'API".

  4. Incollare questi valori nei campi corrispondenti della configurazione del bot e fare clic su Avanti.

Configurare le impostazioni di Genesys Bot Connector

  1. Copiare l' URI generato, andare alla scheda di configurazione Genesys nelle proprietà e incollarlo per sostituire l'URI del webhook segnaposto.

  2. Esempio di webhook generato URL :

https://channels.example-wa.watson-orchestrate.ibm.com/tenants/20250416-0421-5968-60b1-d30aead4c4fd8/agents/baab6d4e-212c-4b56-a2af/environments/56b65c96-ae20-4310-9d0b-9307af8497c3/channels/genesys_bot_connector/30e40672-a41b-4ccf-bb70/events

  1. Fare clic su Fine per completare l'impostazione.

Cosa fare successivamente

Per aggiungere variabili di contesto specifiche del canale per Genesys, seguire le istruzioni fornite nelle variabili di contesto Genesys.