Integrar Google Dialogflow CX

Antes de completar las tareas de esta página, verifique que se hayan cumplido los prerrequisitos para la integración.

Crear un guion

Permisos necesarios: Vista Scripts de Studio, Crear/Editar

Debe crear al menos un script de Studio para dirigir las interacciones a su agente virtual. Siga los requisitos y directrices para la creación de scripts para integrar un agente virtual. Hay scripts de ejemplo en las páginas de ayuda en línea de las acciones admitidas de Centro de Agente Virtual

Si está usando una conexión de canal posterior SIPCerrado Protocolo utilizado para señalizar y controlar sesiones de comunicación multimedia como llamadas de voz y video. con su agente virtual, su script tiene requisitos distintos.

Puede obtener más información sobre scripting de Studio en las secciones Conceptos básicos y Guía de referencia técnica de la ayuda en línea.

Prácticas recomendadas de carga útil personalizada

Siga estas prácticas recomendadas al integrar datos de carga útil personalizada de Google Dialogflow CX a CXone:

  • Dialogflow CX no usa contextos para pasar datos a DialogflowintencionesCerrado El significado o propósito detrás de lo que dice/escribe un contacto; lo que el contacto quiere comunicar o lograr como Dialogflow ES lo hace.
  • Puede pasar datos personalizados aDialogflow CX usando pares clave-valor JSON. En una de Snippet action en su script, cree un objeto dinámico customPayload y agréguele los pares clave-valor. Por ejemplo:

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • En la acción Exchange o Conversation de su script, configure la propiedad customPayload con una variable que tenga la función asJSON() en su valor. Puede encontrar esta variable en el objeto customPayload.
  • Transmita el JSON de customPayload al agente virtual usando la propiedad Payload de QueryParameters. Consulte la documentación de Google sobre QueryParameters Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para Google Dialogflow CX.
  • Los datos transmitidos a través de QueryParameters son recibidos por un webhook en Dialogflow CX. Puede escribir código en la Dialogflow Consola CX para manejar los datos pasados.
  • No inserte un objeto dentro del objeto customPayload. Los objetos insertados se envían como cadenas literales.
  • Para transmitir datos personalizados desde su agente virtual Dialogflow CX devuelta al l script, usa el campo Carga útil personalizada en la consola Dialogflow CX. Asegúrese de estar en la consola del agente virtual que está usando con CXone. Asigne esto a su script usando la variable customPayloadVarName (out) en la acción Studio de voz o chat en su script. Por ejemplo, puede usar esto para configurar los Comportamientos del siguiente indicador.
  • Los parámetros definidos con customPayload solo se pueden usar en el webhook externo. Si desea establecer parámetros para usar fuera del webhook externo, configúrelos en una acción Snippet con el campo session_params. Por ejemplo:

    {
    	"session_params":
    	{ 
    		"name": "Winnie Le Pooh"
    		"job": "Food critic"
    		"location": "Hundred Acre Wood"
    	}
    }

    Accede a los parámetros de la sesión en la DialogflowIntención del agente CX con la siguiente sintaxis:

    $session.params.name = Winnie Le Pooh

    $session.params.job = Food critic

    $session.params.location = 100 Acre Wood

    Los parámetros de sesión solo se utilizan con los agentes virtuales Dialogflow CX. Para lograr un resultado similar con Dialogflow ES, use contextos.

  • Es posible transmitir Sugerencias de contexto de voz con carga útil personalizada en el parámetro speechContexts. El valor de speechContexts.phrases debe ser un token de clase de Google Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para la sugerencia que desea ofrecer. El token debe coincidir con el idioma y la configuración regional de sus contactos. Por ejemplo:

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		
  • Al usar VOICEBOT EXCHANGE: Para configurar cuánto tiempo debe esperar el agente virtual cuando el contacto hace una pausa al hablar, agregue el parámetro maxPostEnergySilenceMS a la acción de Snippet Next Prompt Behaviorso Default Next Prompt Behaviors.

Agregar una aplicación a Centro de Agente Virtual

Permisos necesarios: Automatización e IA > Iniciar la Automatización e IA Vista Scripts de Studio, Crear/Editar

Agregar una aplicación de configuración a Centro de Agente Virtual establece la conexión entre CXone y su proveedor de agentes virtuales.

Si está usando una conexión de canal de retorno SIPCerrado Protocolo utilizado para señalizar y controlar sesiones de comunicación multimedia como llamadas de voz y video. con su agente virtual, siga los pasos para configurar este tipo de conexión.

  1. En CXone, haga clic en el selector de aplicaciones y seleccioneOtro > Automatización e IA y, después, haga clic en Centro de Agente Virtual También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Centro de Agente Virtual.
  2. Haga clic en Agregar bot.
  3. Ingrese un Nombre de agente virtual (Bot) y haga clic en Google Dialogflow CX en la lista de proveedores de agentes virtuales.

  4. Haga clic en próximo.

  5. Complete los campos del formulario de configuración y haga clic en Siguiente. Puede buscar detalles sobre este formulario en la sección Detalles de la página de configuración en esta página.

  6. Haga clic en próximo.

  7. Si está configurando un agente virtual de texto, s eleccione Solo texto (sin apoyo de voz) en la página Voz. Si está configurando un agente virtual de voz, consulte la sección Configurar las opciones de integración de voz en esta página.

  8. Haga clic en próximo.

  9. En la página Transcripción, elija si desea capturar la transcripción de la conversación y la información de intención. Puede elegir Capturar y archivar sólo la información de intención, para Capturar y archivar la transcripción y la información de intención, o Capturar y archivar sólo la transcripción. También puede elegir No capturar ni archivar la transcripción ni la información de intención. Esta opción solo está disponible para agentes virtuales de texto y agentes virtuales de voz basados en enunciados. No es compatible con las integraciones de voz que utilizan un canal de retorno SIPCerrado Protocolo utilizado para señalizar y controlar sesiones de comunicación multimedia como llamadas de voz y video..

  10. Haga clic en próximo.

  11. En la página Probar + Agregar, puede probar la conexión de su bot mediante el envío de mensajes de voz o de texto. Si sus mensajes de prueba no funcionan, haga clic enatrás para volver a la página Configuración y verificar los ajustes. Es posible que también tenga que verificar las configuraciones en la consola de administración de su proveedor de agentes virtuales.

  12. Haga clic en Agregar.

Detalles de la página de configuración de Google Dialogflow CX

Use la información de la tabla siguiente al completar la página de configuración. Observará esta página al agregar una aplicación a Centro de Agente Virtual.

Si está configurando Dialogflow CX para usar una conexión de canal de retorno SIPCerrado Protocolo utilizado para señalizar y controlar sesiones de comunicación multimedia como llamadas de voz y video. siga os pasos para configurar la conexión en lugar de los pasos de esta sección.

Configurar la salida de TTS de Google Dialogflow CX

Complete los pasos de esta sección si desea usar el servicio TTS de Google. Los campos de la imagen siguiente aparecen al activar la opción Ejecutar TTS de salida en la página de configuración de Dialogflow CX en Centro de Agente Virtual.

  1. En Centro de Agente Virtual, agregue una nueva aplicación de configuración y configúrela siguiendo los pasos detallados en la sección Agregar una aplicación a Centro de Agente Virtual en esta página.
  2. Active Ejecutar TTS de salida.
  3. Para usar un modelo de voz personalizado, active Utilizar TTS en la nube CXone e ingrese el nombre del modelo de AutoML que desea usar en el campo Modelo de voz personalizado.

  4. Si desea usar un modelo de voz Google, seleccione el Nombre de voz TTS del menú desplegable.

  5. Seleccione el Modelo y la Variante de modelo del aprendizaje automático que desea que usen los servicios TTS de Google al sintetizar la voz.

  6. Para agregar un silencio al inicio de la respuesta de audio del agente virtual, ingrese el número de milisegundos de silencio que desea en el campo Agregar silencio inicial. El silencio recomendado es de 500 milisegundos.

  7. Ingrese la Velocidad de la voz, el Tono y la Ganancia de volumen para configurar cómo desea que suene la voz TTS.

  8. Regrese a la sección Agregar una aplicación a Centro de Agente Virtual en esta página para terminar de agregar la aplicación de configuración.

Configurar las opciones de integración de voz

Permisos necesarios: Automatización e IA > Iniciar la Automatización e IA

Si está configurando un agente virtual de texto, puede omitir esta sección. Si está usando una conexión de canal de retorno SIP con su agente virtual de voz, siga en cambio los pasos para configurar el Canal de retorno SIP.

  1. En Centro de Agente Virtual, agregue una nueva aplicación de configuración y configúrela siguiendo los pasos detallados en la sección Agregar una aplicación a Centro de Agente Virtual en esta página.
  2. Haga clic en Siguiente en la página de configuración.

  3. En la página Voz, dentro de Opciones de integración de voz, seleccione Control paso a paso (Puerta de enlace del bot de voz de CXone).
  4. En Opciones de texto a voz, seleccione Usar TTS de la nube de CXone si desea usar la opción CXone TTS. Para usar el servicio de TTS del proveedor de agentes virtuales, desmarque esta casilla y configure la salida de TTS en la página Configuración del asistente.

    Si el formulario no le permite seleccionar Usar TTS de la nube de CXone, haga clic en Atrás para regresar a la página Configuración. Haga clic en el control deslizante Ejecutar TTS de salida para Desactivar. Ya puede activar TTS en la nube en la página Voz.

  5. Seleccione un Proveedor de TTS, si está usando TTS en la nube. Si está usando el servicio de TTS de su proveedor de agentes virtuales, este campo no estará visible y puede omitir este paso.
  6. En Opciones de transcripción, seleccione la opción del servicio de transcripción que desea usar.

  7. Si elige usar un perfil de transcripción de CXone , haga clic en Perfil de transcripción para seleccionar el que desea usar. Haga clic en Agregar nuevo perfil de transcripción paso a paso para crear un perfil nuevo.
  8. Haga clic en próximo.
  9. Regrese a la sección Agregar una aplicación a Centro de Agente Virtual en esta página para terminar de agregar la aplicación de configuración.

Asignar la aplicación Google Dialogflow CX a una acción

Permisos necesarios: Vista Scripts de Studio, Crear/Editar

Cuando su agente virtualCerrado El significado o propósito detrás de lo que dice/escribe un contacto; lo que el contacto quiere comunicar o lograr esté configurado y ajustado en Centro de Agente Virtual, debe asignarlo a las acciones del agente virtual en su script. Esto conecta la acción y el script a su proveedor de agente virtual.

La acción que utilice depende de su agente virtual y de lo que admita.

  1. En Studio, abra el script que desea modificar.
  2. Si aún no lo ha hecho, haga clic en la pestaña Instrumentos, expanda la categoría Automatización e IA y agregue la acción de agente virtual que quiere usar. Asegúrese de colocarlo en la ubicación correcta en su script. Si no ve la acción que espera, verifique que su tipo de medio del script sea correcto. Por ejemplo, si está creando un script para un agente virtual de voz, el script debe ser un script de teléfono.

  3. Haga doble clic en la acción para abrir Centro de Agente Virtual.

  4. En la columna de la izquierda, busque el agente virtual que desea asignar a la acción y haga clic en la opción de selección Un icono de un círculo con una marca de verificación adentro. a su lado.
  5. Hacer clicCerrar.

Cambiar el perfil de transcripción

Permisos necesarios: Automatización e IA > Iniciar la Automatización e IA Vista Scripts de Studio, Crear/Editar

Un perfil de transcripción le permite utilizar un servicio de transcripción distinto del que ofrece el proveedor de agentes virtuales. Cada agente virtual puede tener un perfil de transcripción. Sólo necesita seguir los pasos de esta sección si está trabajando con un agente virtual de voz y necesita cambiar el perfil de transcripción.

  1. En CXone, haga clic en el selector de aplicaciones y seleccioneOtro > Automatización e IA y, después, haga clic en Centro de Agente Virtual También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Centro de Agente Virtual.
  2. En la lista de aplicaciones de configuración de agentes virtuales, en el lado izquierdo de la página Centro de Agente Virtual, haga clic en el agente virtual que desea modificar.
  3. En el centro de la página de propiedades de la aplicación de agente virtual, haga clic en la pestaña Voz.
  4. En Opciones de transcripción, seleccione Usar perfil de transcripción CXone, si no está seleccionado todavía.

  5. Seleccione el Perfil de transcripción paso a paso que quiere que use esta integración de agente virtual. Si la opción que desea utilizar no está allí, puede agregarla.

  6. Haga clic en Guardar.
  7. Ponga a prueba su servicio de transcripción usando la opción de micrófono en la sección Prueba de la página de propiedades de la aplicación de agente virtual.

Probar el agente virtual

Permisos necesarios: Automatización e IA > Iniciar la Automatización e IA Vista Scripts de Studio, Crear/Editar

Puede probar muchos aspectos de su agente virtual para asegurarse de que todo funcione según lo previsto. Puede ejecutar pruebas desde la página de propiedades de la aplicación del agente virtual en Centro de Agente Virtual. Usted puede:

  • Verificar que la aplicación del agente virtual está correctamente configurada para comunicarse con el proveedor del agente virtual.
  • Agregar JSON de carga útil personalizada para probar el manejo del agente virtual de los datos de carga útil personalizados.
  • Activar un evento de intención de bienvenida para probar cómo el agente virtual inicia una conversación.
  • Activar un evento de intención personalizado para probar cualquier evento personalizado que haya creado para su agente virtual.
  • Activar un evento de tiempo de espera para probar cómo responde el agente virtual cuando se agota el tiempo de espera del contacto.
  • Probar cómo el agente virtual maneja la entrada DTMFCerrado Tonos de señalización que se generan cuando un usuario presiona o toca una tecla en el teclado de su teléfono..

La siguiente imagen es un ejemplo de la página de propiedades de una aplicación de agente virtual en Centro de Agente Virtual. Muestra las pestañas Configuración y Voz y el panel Prueba.

  1. En CXone, haga clic en el selector de aplicaciones y seleccioneOtro > Automatización e IA y, después, haga clic en Centro de Agente Virtual También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Centro de Agente Virtual.
  2. Haga clic para seleccionar la aplicación de configuración para el agente virtual que desea probar de la lista de la izquierda.
  3. En el panel Prueba, ingrese un mensaje de prueba en el campo Escriba un mensaje y prensaIngresar para enviarlo. También puede hacer clic en Micrófono Un icono con forma de micrófono. y hablar al micrófono de su computadora.

  4. Haga clic en Comience con intención de bienvenida para iniciar una conversación de prueba desde el principio. El agente virtual responde con su mensaje de bienvenida predeterminado. Puede ingresar mensajes de prueba.
  5. Haga clic en Más opciones Un icono con tres puntos verticales. para probar otros aspectos de su agente virtual.

  6. Haga clic en Restablecer para comenzar su prueba de nuevo.
  7. Si necesita realizar cambios en función de los resultados de sus pruebas, puede:

    • Modifique los scripts de Studio para el agente virtual.
    • Modifique los ajustes de configuración de la aplicación del agente virtual en Centro de Agente Virtual.
    • Modifique los ajustes de configuración del agente virtual en la consola del proveedor. Haga clic en el botón grande cuadrado de la página de propiedades de la aplicación en Centro de Agente Virtual. El ejemplo al comienzo de esta sección muestra la aplicación Google Dialogflow CX con el botón del proveedor. Tiene el Un icono que tiene un cuadrado con una flecha superpuesta encima. La flecha apunta desde el centro del cuadrado hasta la esquina superior derecha del cuadrado. icono en él para indicar que el enlace abre un sitio externo.
  8. Pruebe el agente virtual exhaustivamente después de cada cambio de sus scripts o de cualquier configuración.
  9. Cuando haya terminado de probar, haga clic en Cerca.