Integrazione con Genesys Audio Connector

Prima di iniziare

Prima di iniziare a integrare l'assistente con Genesys Audio Connector, è necessario disporre dei seguenti prerequisiti:

• Crea un nuovo account oppure accedi a un account Genesys Cloud esistente con accesso a Genesys Architect e alla regione corretta sul portale Genesys Cloud.

• Il ruolo 'Admin nell'organizzazione Genesys Cloud.

Per ulteriori informazioni sui ruoli e sulle autorizzazioni di Genesys Cloud, consultare la panoramica su ruoli e autorizzazioni.

Creare l'integrazione del connettore audio nell'assistente

1. Vai alla pagina "Integrazioni" cliccando sull'icona delle integrazioni () nel menu a sinistra.

Memorizzare le credenziali perché non è possibile vederle dopo aver fatto clic su Salva. Queste credenziali sono necessarie per configurare Genesys Audio Connector.

1. Fare clic su Aggiungi nel riquadro Telefono.

2. Fare clic sul riquadro Genesys Audio Connector.

3. Nella sezione Credenziali, copiare e memorizzare le credenziali generate automaticamente nei seguenti campi:

   • Chiave API

   • Segreto client

   • URI di collegamento audio Genesys

   • ID connettore bot

4. Fare clic su Salva ed esci.

Impostare il connettore audio per integrare l'assistente

Per configurare Genesys Audio Connector, segui la procedura descritta nell'argomento "Configurazione e attivazione di Audio Connector in Genesys Cloud ".

Nella pagina di amministrazione di Genesys, andare su Integrazioni > Configurazione per aggiungere il valore URI di Genesys audio connect copiato durante la creazione dell'integrazione Audio Connector nell'assistente.

Nella pagina di amministrazione di Genesys, andare su Integrazioni > Credenziali per aggiungere le credenziali per i campi chiave API e segreto cliente copiati durante la creazione dell'integrazione Audio Connector nell'assistente.

Condivisione del contesto attraverso le variabili di sessione

Dal nodo "Audio Connector" nel flusso di Genesys Architect è possibile specificare le variabili di sessione che possono essere utilizzate per trasmettere informazioni al generatore di assistenti AI. È possibile specificare sia i parametri di ingresso che quelli di uscita. Ai fini dell'integrazione, entrambi questi parametri vengono uniti in un unico oggetto all'interno context dell'oggetto.

Nell'assistente AI sono disponibili sia i contextparametri di input che quelli di output, e le informazioni vengono condivise ad ogni turno. Ad esempio, la context funzione disponibile nell'assistente AI è:

{
  "context": {
    "integrations": {
      "genesys_audio_connector": {
        "user_id": "<SENT FROM GENESYS>",
        "some_variable": "<SET_FROM_WATSON_ASSISTANT>"
      }
    }
  }
}

Accedi ai parametri di input del tuo assistente AI tramite la variabile di sessione ` ${system_integrations.genesys_audio_connector.user_id} `.

Per impostare i parametri di output, utilizza un'espressione del tipo ${system_integrations.genesys_audio_connector.some_variable}, a cui potrai accedere in seguito nel tuo flusso.

Per impostare una variabile di uscita, procedere come segue:

1. Vai alla sezione delle azioni dell 'assistente AI in cui desideri definire la variabile.

2. Fare clic su Imposta nuova variabile e selezionare Espressione.

3. Inserite la seguente espressione:

${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

Esempio:

${system_integrations.genesys_audio_connector.some_variable} = "this is an output variable"

In questo esempio, il nome della variabile è some_variable, con il valore impostato su "questa è una variabile di uscita".

Terminare il flusso del connettore audio Genesys

Dopo aver ricevuto la conversazione audio dall'utente, il nodo Audio Connector di Genesys Architect facilita lo scambio di messaggi tra l'utente e l'assistente fino al termine della conversazione. Per inviare la conversazione audio a Genesys, è necessario utilizzare il tipo di risposta 'end_session.

{
  "generic": [
    {
      "response_type": "text",
      "values": [
        {
          "text": "You have ended the call."
        }
      ]
    },
    {
      "response_type": "end_session"
    }
  ]
}

Tipi di risposta

Dopo aver integrato il tuo generatore di assistenti AI con Genesys Audio Connector, potrai utilizzare i seguenti tipi di risposta nell'assistente:

• Testo

• opzione

• fine_sessione

• discorso_a_testo

• testo_a_parlato

• inizio_attività

• stop_attività

• DTMF

• utente_definito

• connetti_a_agente

• immagine

• audio