Configure la Extensión de API de Señalar y TMS en el Flujo de AI Agents (Cognigy)

Después de cargar la extensión, configure el Flujo de AI Agents (Cognigy) para capturar los metadatos de SIP. y la transcripción de la conversación, y para enviar la señal de control correcta a NiCE CXone al final de cada interacción.

Cuando utiliza las plantillas de script Studio proporcionadas por los Servicios Profesionales de NiCE CXone, los campos de Interacción de salida se completan previamente. Se recomienda revisar el valor de cada campo para verificar que coincida con su entorno antes de realizar la prueba.

Captura de Metadatos SIP

  1. En AI Agents (Cognigy), abra el Flujo que configuró para el integrar de bot de voz.

  2. Seleccione Flujo Principal del selector de flujos en la parte superior del editor si el proyecto contiene múltiples Flujos.

  3. En la rama On First Time del Flujo, haga clic en el ícono + y agregue un nodo Agregar a Contexto.

  4. Configure el nodo Add to Context para almacenar la carga útil de la solicitud SIP entrante:

    1. En el campo clave Contexto, ingrese: sipBody

    2. En el campo Valor, ingrese la expresión que se asigna al cuerpo de la solicitud SIP entrante. NiCE CXone Servicios Profesionales confirmará la expresión exacta para su entorno.

  5. Haga clic en Guardar Nodo . La clave de contexto sipBody ahora está disponible en todo el Flujo para que el nodo salida de Interacción la referencie.

Agregar Lógica de Bot de Voz

  1. Agregue o verifique los nodos de lógica del bot en el Flujo, como los nodos Say, nodos Question, los controladores de intención y las alternativas de Error.

  2. Asegúrese de que el Flujo incluya una ruta clara hacia la conclusión de la interacción (derivación o finalización) que se conecte con el nodo Get Transcript y el nodo salida de interacción que agregará en los pasos siguientes.

Captura la transcripción de la conversación

  1. En la rama Después del Flujo (o inmediatamente antes del nodo salida de Interacción), haga clic en + y agregue un nodo Obtener Transcripción.

  2. Configure el nodo Get Transcript con la siguiente configuración:

    1. Ubicación de almacenamiento

    2. Clave de entrada

      Para obtener más detalles, consulte el tema Get Transcript node.

    3. Límite: Introduzca la cantidad máxima de turnos de conversación que se van a capturar. Un valor de 25 es adecuado para la mayoría de las implementaciones.

  3. Haga clic en Guardar Nodo. El nodo Obtener transcripción captura la transcripción y la almacena en la introducir variable de transcripción. El nodo salida de interacción lee esta variable y la envía a NiCE CXone TMS en el siguiente paso.

    El nodo Get Transcript captura la transcripción solo dentro del Flujo. La transcripción no se envía a NiCE CXone hasta que el nodo Exit Interaction se ejecuta en el siguiente paso.

Configure el Nodo de salida de Interacción

  1. Después del nodo Get Transcript, haga clic en + y seleccione la pestaña Extensiones .

  2. En la categoría CXone, seleccione salida de interacción. El nodo se agrega al Flujo.

  3. Haga clic en el nodo Exit Interaction y seleccione Edit Node.

  4. Configure los siguientes campos. Use la tabla a continuación para conocer las descripciones de los campos, los valores aceptables y el impacto de los valores incorrectos.

    Campo

    Descripción

    Impact si es incorrecto
    Entorno Seleccione la región de entorno NiCE CXone que coincida con su abonado. Seleccione Other si usa una URL base NiCE CXone personalizada. Obligatorio. Una selección de región incorrecta provoca que las solicitudes de la API de Señalar fallen de forma silenciosa.
    URL base del entorno La URL base para su entorno de API de NiCE CXone. Por ejemplo, https://cognigy-na1.nicecxone.com Se requiere cuando Entorno está configurado en Otro. Debe coincidir exactamente con la región de abonado de su NiCE CXone.
    Acción de transferencia Seleccione Escalate to Agent para transferir el contacto a una cola de Agentes activa, o seleccione End Conversation para terminar la interacción. Obligatorio. Esta es la señal de control principal enviada a NiCE CXone mediante la API de señalar.
    Número de unidad de negocio Su NiCE CXone ID de unidad de negocio. Normalmente se asigna a partir de los encabezados SIP. Por ejemplo, {{context.sipBody.headers["X-InContact-BusNo"]}} Obligatorio. NiCE CXone usa este valor para identificar al abonado correcto. Un valor incorrecto provoca que la autenticación de la API de Señalar falle.
    Id de contacto principal El id de contacto principal NiCE CXone para la interacción. Asignado desde las Cabeceras SIP. Por ejemplo, {{context.sipBody.headers["X-InContact-ContactId"]}} Obligatorio. Identifica la interacción de voz específica que se debe escalar o finalizar.
    Id de contacto generado El id de contacto generado o secundario para el canal secundario SIP. Asignado desde los encabezados SIP. Por ejemplo, {{context.sipBody.headers["X-InContact-SpawnedId"]}} Obligatorio. Identifica la interacción de backchannel asociada con el contacto principal.
    CXone Connection Un objeto de conexión preconfigurado en AI Agents (Cognigy) que contiene las credenciales de autenticación de NiCE CXone. Creado y configurado por Servicios Profesionales de NiCE CXone. Obligatorio. Si la conexión falta o está mal configurada, se rechazan todas las solicitudes de la API de Señalar y la API de TMS.

  5. Haga clic en Guardar Nodo.

  6. Repita esta configuración para cada ruta de salida en el Flujo que finaliza o escala la interacción. Si tiene tanto una ruta Escalate to Agent como una ruta End Conversation, agregue un nodo Exit Interaction independiente a cada ruta y configure el campo Acción de Entregar según corresponda.