Antes de empezar

Debe tener los siguientes requisitos previos antes de empezar a integrar el asistente con Genesys Audio Connector:

• Una nueva cuenta o inicie sesión en una cuenta de Genesys Cloud existente con acceso a Genesys Architect y la región correcta en el portal de Genesys Cloud.
• El rol Admin en la organización Genesys Cloud.

Para obtener más información sobre las funciones y permisos de Genesys Cloud, consulte Visión general de funciones y permisos.

Crear la integración del conector de audio en el asistente

1. Vaya a la página Integraciones haciendo clic en el del menú de la izquierda.

Almacene las credenciales porque no puede verlas después de pulsar Guardar. Necesita estas credenciales para configurar Genesys Audio Connector.

1. Haga clic en Añadir en el mosaico Teléfono.

2. Pulse el mosaico Conector de audio de Genesys.

3. En la sección Credenciales, copie y almacene las credenciales generadas automáticamente en los campos siguientes:

   • Clave de API
   • Secreto de cliente
   • URI de conexión de audio de Genesys
   • ID de conector de bot

4. Pulse Guardar y salir.

Configurar el conector de audio para integrar el asistente

Para configurar Genesys Audio Connector, complete los pasos del tema Configurar y activar Audio Connector en Genesys Cloud de la documentación de Genesys Cloud.

En la página Admin de Genesys, vaya a Integraciones > Configuración para añadir el valor URI de conexión de audio de Genesys que copió cuando creó la integración del conector de audio en su asistente.

En la página Admin de Genesys, vaya a Integraciones > Credenciales para añadir las credenciales de los campos Clave API y Secreto de cliente que copió al crear la integración del Conector de audio en su asistente.

Uso compartido de contexto a través de variables de sesión

En el nodo Conector de audio del flujo de Genesys Architect, puede especificar variables de sesión que se pueden utilizar para pasar información a watsonx Assistant. Puede especificar los parámetros de entrada y salida. Para la integración, ambos parámetros se fusionan en un único objeto bajo el objeto context.

Los parámetros de entrada y salida están disponibles en watsonx Assistant context y la información se comparte en cada turno. Por ejemplo, el context disponible en watsonx Assistant es:

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

Acceda a los parámetros de entrada en su watsonx Assistant con la variable de sesión ${system_integrations{system_integrations.genesys_audio_connector.user_id}.

Para establecer los parámetros de salida, utilice una expresión como ${system_integrations{system_integrations.genesys_audio_connector.some_variable}, a la que podrá acceder más adelante en su flujo.

Realice los siguientes pasos para configurar una variable de salida:

1. Vaya al paso de acción en el que desea definir la variable.

2. Haga clic en Establecer nueva variable y seleccione Expresión.

3. Introduzca la siguiente expresión: ${system_integrations.genesys_audio_connector.<variable_name>} = "<variable_value>"

   Ejemplo:

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

   En este ejemplo, el nombre de la variable es some_variable, con el valor this is an output variable.

Finalización del flujo de Genesys Audio Connector

Después de recibir la conversación de audio del usuario, el nodo Conector de audio en Genesys Architect facilita el intercambio de mensajes entre el usuario y el asistente hasta el final de la conversación. Para enviar la conversación de audio de vuelta a Genesys, debe utilizar el tipo de respuesta end_session.

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

Tipos de respuesta

Después de integrar watsonx Assistant con Genesys Audio Connector, puede utilizar los tipos de respuesta siguientes en el asistente:

• Texto
• opción
• end_session
• speech_to_text
• text_to_speech
• start_activities
• stop_activities
• dtmf
• user_defined
• connect_to_agent
• imagen
• audio