Implementar una Integrar de Agente virtual personalizada

Esta página describe el proceso general que debe seguir al implementar una integración de agente virtual personalizada. Cada entorno y cada integración personalizada son diferentes. Su situación podría exigir más tareas que no estén descritas aquí. Es su responsabilidad comprender lo que requiere su integrar y, si se necesitan tareas adicionales, dónde se ajustan en el proceso descrito en esta página.

Complete cada una de estas tareas en el orden indicado.

Configurar el Agente virtual y el servidor de autorización

Configure el agente virtual en el entorno del proveedor. Realice una prueba exhaustiva para garantizar que funcione como lo espera.

Si su integrar utiliza autenticación dinámica, configure el servidor de autorización.

Configure el Terminal del túnel de proxy

Para completar esta tarea, debe colocar el código de túnel proxy en su lugar y ejecutar los comandos que inician el código y exponen los extremos. Los pasos y comandos exactos que son necesarios variarán con cada entorno.

Configure los scripts necesarios para Studio

Permisos requeridos: ACD > Studio > Scripts de studio > Crear/Editar, Importar/Exportar, Depurar, Bloquear anulación; ACD > Studio > Grabar Avisos > Activado; ACD > Studio > Explorador de archivos > Editar, Crear

Verifique que todos los scripts de Studio necesarios estén en su entorno de producción. Es posible que deba:

  • Exporte los scripts de un entorno e impórtelos en otro. Es posible que desee crear una carpeta específicamente para los scripts relacionados con su integrar de agente virtual personalizado.
  • Guarde los scripts con nombres nuevos. Si usted usa convenciones de nomenclatura para la gestión de versiones, debe cambiar los nombres de los scripts para moverlos de desarrollo a producción. Studio no admite el cambio de nombres de scripts. Para cambiarles el nombre, debe usar la opción File > Save As.

Verifique que las acciones del agente virtual estén bien configuradas. Esto implica que:

  • La aplicación Custom Exchange Terminal se crea en Virtual Agent Hub.
  • Cada acción de agente virtual de sus scripts tiene asignada la aplicación Terminal personalizado de intercambio.
  • La conexión entre el script y el agente virtual funciona según lo previsto después de que mueve el script a producción. Realice algunas pruebas desde la aplicación Custom Exchange Endpoint en Virtual Agent Hub para verificar la conexión.

Configure la conexión entre NiCE CXone y su Agente virtual

Permisos requeridos: ACD > Studio > Studio Scripts > Create/Edit; Integrations > Launch

La conexión entre su agente virtual y NiCE CXone es la acción del agente virtual en sus scripts de Studio. La acción debe configurarse con los detalles necesarios para que los dos sistemas puedan comunicarse. Esto se hace creando una aplicación de configuración en Virtual Agent Hub y, después, asignándola a cada instancia de las acciones del agente virtual en su script.

Solo debe completar esta tarea una vez, incluso si tiene más que una acción de agente virtual en su script.

Las acciones de agente virtual son Intercambio de voicebot y Intercambio de textbot.

La Página de configuración para la aplicación Terminal personalizado de intercambio varía en función de la versión de integración que esté usando. Siga los pasos de la sección siguiente correspondientes a su versión. Las diferencia entre las versiones son las siguientes:

  • 1.0.0: Supports a single authorization header. The header is sent with the ExternalIntegrationBotExchangeRequest request.
  • 2.0.0: Admite múltiples encabezados de autorización. Los encabezados se envían con la solicitud ExternalIntegrationBotExchangeRequest como pares clave-valor.
  • 3.0.0: Admite múltiples encabezados de autorización y StandardBot. Los encabezados se envían con la solicitud ExternalIntegrationBotExchangeRequest como pares clave-valor.
  • Las versiones 1.0.0 y 2.0.0 de integrar quedarán obsoletas en una versión futura. La Versión 3.0.0 es la preferida para las integraciones personalizadas con agentes virtuales. Si actualmente utiliza las versiones 1.0.0 o 2.0.0, planifique la actualización a la versión 3.0.0. La versión 3.0.0 es prácticamente idéntica a la Versión 2.0.0. La diferencia principal es que 3.0.0 agrega soporte para StandardBot.

Configurar la Versión de integración 1.0.0

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. Haga clic en Añadir bot.
  3. Ingrese un nombre de agente virtual (bot) y seleccione Terminal personalizado de intercambio como Proveedor de bots.
  4. Hacer clicpróximo.
  5. Seleccione Versión de integración 1.0.0.

  6. Ingrese la URL de webhook para su agente virtual. Este es el terminal al que el script envía todas las solicitudes.
  7. Si utiliza autorización con su integración de agente virtual personalizada, ingrese el Encabezado de autorización de su servicio de agente virtual. El encabezado se envía con la solicitud ExternalIntegrationBotExchangeRequest.
  8. Para incluir parámetros en cada solicitud enviada al servicio de agente virtual, haga clic en Añadir Parámetros de Terminal. Ingrese el nombre del parámetro y el Valor. Repita este paso para agregar más parámetros.

  9. Para cambiar el Tiempo límite predeterminado, introduzca el número de milisegundos que el script espera para que el servicio de agente virtual responda antes de que se agote el tiempo límite. El valor predeterminado es 10000.

  10. Haga clic en Siguiente en la página de configuración.
  11. Complete las páginas Voz y Transcripción en el asistente Agregar bot.
  12. Pruebe su integrar.
  13. Asigne la aplicación de configuración de Custom Exchange Endpoints a las acciones del agente virtual en su script.

Configurar la Versión de integración: 2.0.0 y 3.0.0

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. Haga clic en Añadir bot.
  3. Ingrese un nombre de agente virtual (bot) y seleccione Terminal personalizado de intercambio como Proveedor de bots.
  4. Hacer clicpróximo.
  5. Seleccione Versión de integración 2.0.0 o 3.0.0.

  6. Ingrese la URL de webhook para su agente virtual. Este es el terminal al que el script envía todas las solicitudes.
  7. Para enviar encabezados con la URL del webhook, haga clic en Añadir Encabezados personalizados. Esto incluye Encabezados de autorización. Ingrese el nombre del encabezado y el Valor. Repita este paso para agregar más encabezados.

    Si está usando autenticación dinámica OAuth, salte este paso.

  8. Para incluir parámetros en cada solicitud enviada al servicio de agente virtual, haga clic en Añadir Parámetros de Terminal. Ingrese el nombre del parámetro y el Valor. Repita este paso para agregar más parámetros.

  9. Para cambiar el Tiempo límite predeterminado, introduzca el número de milisegundos que el script espera para que el servicio de agente virtual responda antes de que se agote el tiempo límite. El valor predeterminado es 10000.

  10. Para usar la autenticación mTLS con su integración de agente virtual personalizada, haga clic en Add Webhook Client Certificates y configure los detalles de su certificado.
  11. Para configurar la autenticación dinámica con su integración personalizada, haga clic en O Auth Required para activarlo en On y configure los campos requeridos.
  12. Haga clic en Siguiente en la página de configuración.
  13. Complete las páginas Voz y Transcripción en el asistente Agregar bot.
  14. Pruebe su integrar.
  15. Asigne la aplicación de configuración Custom Exchange Endpoints a las acciones del agente virtual en su script.

Configure mTLS Authentication with Client Certificates

Puede agregar certificados de cliente y claves a su aplicación Custom Exchange Endpoints para usar autenticación mTLS con su integración personalizada.

Antes de empezar, debe disponer de un certificado y una clave privada en formato PEM.

  1. En Virtual Agent Hub, seleccione la aplicación Custom Exchange Endpoints que quiere modificar.

  2. Haga clic en Agregar certificados de cliente de webhook.

  3. Ingrese un nombre de certificado opcional. Este puede ser cualquier palabra o frase que identifique el certificado.

  4. Copie el texto sin formato codificado del archivo PEM del certificado y péguelo en el campo Certificado.

  5. Copie el texto sin formato codificado de la clave privada del archivo PEM y péguelo en el campo Clave privada.

  6. Ingrese la Contraseña del certificado.

  7. Si necesita agregar más certificados de cliente, haga clic en Add Client Certificates y repita los pasos 2-5.

  8. Guarde sus cambios.

Configure Dinámica Authentication con OAuth para la Versión 2.0.0 o 3.0.0

Si está utilizando autenticación dinámica con su integración personalizada, puede tener la aplicación Custom Exchange Endpoint para administrar sus tokens. Si habilita esta opción, anula el valor del encabezado personalizado recuperado por el servidor de autorización.

  1. En Virtual Agent Hub, seleccione la aplicación Custom Exchange Endpoints que quiere modificar.
  2. Haga clic en OAuth necesaria para alternar al Encendido.
  3. Ingrese la URL de su servidor de autorización en el campo URL de OAuth.
  4. Seleccione JSON o Cifrar URL del formulario en Solicitar el Tipo de contenido. Este es el Tipo de cuerpo de las solicitudes de OAuth.
  5. Haga clic en Agregar OAuth Solicitud e ingrese los pares clave-valor que conforman el cuerpo de la solicitud de autenticación. Esto comprende, por ejemplo, secretos API y credenciales de cliente. intro el nombre Name y el valor Value. Repita este paso para agregar más parámetros de solicitud.
  6. Haga clic en Agregar OAuth Encabezados y escriba los pares de clave-valor para cualquier encabezado que su servidor de autorización requiera que las solicitudes incluyan. Escriba la clave nombre y Valor. Repita este paso para agregar más parámetros de encabezado.
  7. Para personalizar los encabezados de autorización que se envían con las solicitudes a su proveedor de agentes virtuales, haga clic en Aut de encabezados personalizados para alternar a Encendido y, después:

    1. Introduzca un nuevo Nombre del encabezado de Autorización para cambiar el nombre de la clave en el par clave-valor del encabezado de autorización. El valor predeterminado es Autorización.
    2. Ingrese un nuevo Prefijo de Valor de encabezado de autorización para cambiar el prefijo enviado con el valor del encabezado. El valor predeterminado Portador.
  8. Para personalizar la duración del token de autorización antes de que caduque, ingrese un nuevo tiempo de caducidad de aut. El valor predeterminado es 0.

  9. Seleccione una opción del menú desplegable Seleccionar certificado de OAuth para indicar si desea usar un certificado con su servidor de autorización de OAuth. Si desea usar un certificado, puede elegir Usar el certificado de cliente de webhook o Agregar nuevo certificado de cliente para el servidor de aut.

  10. Hacer clicGuardar.

Configurar Opciones de Voz y transcripción

La página Voice permite configurar la aplicación Custom Exchange Endpoints para que sea un agente virtual de Voz o un agente virtual de texto. Para los agentes virtuales de texto, no hay configuraciones adicionales que configurar. Para los agentes virtuales de voz, puede seleccionar:

  • El tipo de integrar de voz que está haciendo.
  • El servicio de transcripción (voz a texto/STT) que desea usar.

La página Transcripción del asistente Custom Exchange Endpoints le permite seleccionar si desea que su integración capture transcripciones de las conversaciones del agente virtual con los contactos.

  1. En Virtual Agent Hub, agregue la aplicación Custom Exchange Endpoint y complete la página de configuración para versión 1.0.0 o versión 2.0.0/3.0.0.
  2. Haga clic en Siguiente en la página de configuración.
  3. Si está configurando una integración de agente virtual de texto, seleccione Text Only en la página Voice en Voice Integration Options y, a continuación, haga clic en Next. Pase directamente al paso 10 en esta sección.

  4. Si está configurando un agente virtual de voz, seleccione la opción correspondiente al tipo de integrar de voz que está configurando en la lista de la página Voz, dentro de Opciones de Integrar de Voz.

  5. En Opciones de Transcription, seleccione el servicio de voz a texto que desea usar.

  6. Hacer clicpróximo.
  7. En la página Transcript, seleccione la opción para indicar si desea capturar las transcripciones de las conversaciones del agente virtual.

  8. Hacer clicpróximo.
  9. Pruebe la integración de su agente virtual si lo desea, o haga clic en Agregar para agregar la aplicación de configuración Custom Exchange Endpoints a Virtual Agent Hub.

Pruebe su Integrar de Agente virtual personalizado

Permisos requeridos: ACD > Studio > Studio Scripts > Crear/Editar; Integraciones > Iniciar

Este paso prueba la conexión entre NiCE CXone y el agente virtual. Garantiza que el agente virtual funcione según lo previsto al comunicarse con NiCE CXone.

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 Virtual Agent Hub. Cuando realice una prueba, 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.
  • Active un evento de intención de bienvenida para probar cómo el agente virtual inicia una conversación.
  • Active 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 DTMFClosed Tonos de señalización que se generan cuando un contacto presiona una tecla en el teclado telefónico..

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

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  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 de Prueba, ingrese un mensaje de prueba en el campo Type a message y presione intro para enviarlo.

  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 opcionesUn ícono 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 su prueba, puede:

    • Modifique los scripts de Studio para el agente virtual.
    • Modifique la configuración en la aplicación del agente virtual en Virtual Agent Hub.
    • Modifique la configuración del agente virtual en la consola del proveedor. Haga clic en el botón cuadrado grande en la página de propiedades de la aplicación en Virtual Agent Hub. El ejemplo al comienzo de esta sección muestra la aplicación Google Dialogflow CX con el botón del proveedor. It has the Un icono que tiene un cuadrado con una flecha superpuesta encima de él. La flecha apunta desde el centro del cuadrado hacia 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 en sus Scripts o en cualquier configuración de configuración.
  9. Cuando termine la prueba, haga clic en Close.

Asignar el Agente virtual a una Acción de Studio

Permisos requeridos: ACD > Studio > Studio Scripts > Crear/Editar

Cuando la aplicación de agente virtual esté configurada en Virtual Agent Hub, debe asignarla a la acción de agente virtual en su script. Esto conecta la acción y el script a su proveedor de agente virtual.

  1. En Studio, abra el script que desea modificar.
  2. Localice la VOICEBOTSTREAMacción en su script. Si aún no lo ha hecho, agréguela desde la paleta de Acciones.
  3. Haga clic en Abrir editor en la acción para abrir Virtual Agent Hub.
  4. Ubique la acción de agente virtual en el script y haga clic en Abrir editor en la acción para abrir Virtual Agent Hub.

  5. En la columna izquierda, ubique el perfil de agente virtual que desea asignar a la acción y haga clic en la marca de verificación Un ícono de un círculo con una marca de verificación adentro. que aparece junto a él.

    Una alternativa a usar la marca de verificación es crear una variable en su script Studio. Use la variable para pasar el nombre de la aplicación del agente virtual a la propiedad ID de Agente virtual de la acción Virtual Agent Hub que está utilizando.

  6. Haga clic en Cerrar.

Complete los requisitos específicos del Canal

Permisos requeridos: ACD> Configuración del contacto > Campañas > Editar, Crear; ACD> Configuración del contacto > puntos de contacto > Editar, Crear; ACD> Configuración del contacto > Habilidades > Crear, Editar, Asignar usuario; ACD> Configuración del contacto > Perfiles de charla > Crear, Editar; ACD> Digital Engagement > Ajustes de canal

Configure el canalClosed Diversos medios de comunicación de voz y digitales que facilitan las interacciones con los clientes en un centro de contacto. que usarán los contactos para iniciar las interacciones con su agente virtual.

Para canales de chat o voz de NiCE CXone:

Para los canales de Digital Experience (DX):

Si utiliza una convención de nomenclatura como el control de versiones con sus Studio scripts, asegúrese de guardar su script con su nombre de producción antes de asignarlo al punto de contacto.

Verifique que ha completado todos los requisitos necesarios para su canal, incluso cuestiones tales como:

  • Crear un perfil de chat para chat de ACD.
  • Configurar la opción de chat o mensajería para digital channels, donde las conversaciones comienzan en otros sitios web, como Instagram.
  • Agregar el chat a su sitio web o aplicación móvil (NiCE CXone chat y conversación digital).

Probar el script desde el punto de contacto

Permisos requeridos: ACD > Configuración del contacto > Points of Contact > Ver, Editar

Cuando se configura el punto de contactoClosed punto de entrada que utiliza un contacto entrante para iniciar una interacción, como un número de teléfono o una dirección de correo electrónico., debe probar su script desde el punto de contacto. Puede usar el rastreo de script para verificar la efectividad de su script e identificar cualquier problema que surja.

La prueba que realizó anteriormente en el proceso de implementación probó la conexión entre el agente virtual y NiCE CXone. La prueba en este paso verifica la integración completa, desde el contacto a través de NiCE CXone hasta el agente virtual.

  1. En Studio, abra el script al que llama el punto de contacto.
  2. Haga clic en Depurar > Capturar script > Solo Siguiente instancia.
  3. Iniciar una interacción. La manera en que la inicie variará según el canalClosed Diversos medios de comunicación de voz y digitales que facilitan las interacciones con los clientes en un centro de contacto..Por ejemplo:

    En Studio, se abre la ventana Salida de seguimiento. Muestra el progreso del script a medida que escribe las respuestas y el agente virtual responde.

  4. Haga clic en una acción del panel principal en la ventana Salida de seguimiento.

    • La pestaña variables muestra todas las variables que existen en el script cuando la acción seleccionada se ha completado. Muestra también el valor que tiene cada variable en ese punto del script.
    • La pestaña Propiedades muestra las propiedades de la acción seleccionada. Puede usarla para verificar la configuración actual de la acción.
  5. Regrese al script y aplique cambios, si fuera necesario.
  6. Seleccione una acción y pulse F1 en el teclado para acceder a la ayuda en línea de esa acción. La página de ayuda en línea de cada acción describe las propiedades y otra información sobre el uso de la acción en un script.
  7. Si desea volver a comenzar, haga clic en finalizar conversación, actualice la ventana del navegador y repita este proceso desde el paso 2.