Configurar la Acción TextBotExchange

La acción TextBotExchange envía los mensajes del contacto a AI Agents (Cognigy) y recibe las respuestas del bot. También proporciona variables de salida y condiciones de bifurcación que su script utiliza para determinar qué sucede a continuación. Configure las propiedades de la acción como se describe en esta tarea.

Permisos requeridos: Vista de script de Studio, Crear/Editar

En el script Studio, haga clic en Actions en el panel derecho.
Ampliar la categoría Web editor URL.
Arrastre la TextBotExchange acción hacia el lienzo del script. Colóquela después de la acción que recopila la entrada del contacto.
Si su script requiere más de un turno, agregue una segunda TextBotExchange acción y conéctela al bucle de la conversación. Se requiere un mínimo de dos TextBotExchange acciones para la mayoría de las implementaciones.
Antes de la primera TextBotExchange acción, agregue una Snippet acción y configúrela con el Bot Session State código de snippet. Este snippet inicializa la variable botSessionState que mantiene el contexto de la conversación a través de los turnos.

Propiedades de entrada

Seleccione la acción TextBotExchange y configure las siguientes propiedades de entrada en el panel Propiedades. Use la siguiente tabla para comprender cada propiedad:

Propiedad	Valor o FORMATO aceptable	Descripción
	Etiqueta breve y descriptiva. Ejemplo: TextBotExchange_CognigyStart	Identifica esta acción específica en el lienzo Studio. El valor predeterminado es "TEXTBOT EXCHANGE". Ingrese un título único cuando su script contenga más de una TextBotExchange acción.
ID de agente virtual	Se completa automáticamente después de asignar el bot en el Virtual Agent Hub. El valor equivale al nombre del Agente virtual (bot) de Virtual Agent Hub.	Identifica la configuración de Virtual Agent Hub que se debe usar. Este campo se completa automáticamente cuando usted asigna el bot a la acción en Virtual Agent Hub. Puede anular este valor utilizando una Variable de Studio, por ejemplo, {virtualAgentId}, si necesita seleccionar dinámicamente la configuración del bot en tiempo de ejecución. Este enfoque se utiliza comúnmente cuando se cambia entre múltiples configuraciones de bot.
Intención automatizada	Cadena estándar: Bienvenido. Se usa solo en el primer turno.	Activa una intención específica en AI Agents (Cognigy) en lugar de enviar la entrada escrita por el contacto. Este campo se puede usar para invocar intenciones predefinidas como Welcome o cualquier otra intención admitida en el bot. Si bien se usa comúnmente en el primer turno para activar un mensaje de bienvenida, también se puede usar en turnos posteriores para invocar otras intenciones de forma dinámica. Deje este campo vacío cuando desee enviar el mensaje real del contacto en su lugar.
Entrada del usuario	Studio Variable que contiene el mensaje escrito por el contacto. Ejemplo: {customerMessage}	El mensaje de texto escrito por el contacto, que se pasa a AI Agents (Cognigy) para el reconocimiento de intenciones y la generación de respuestas. En el primer turno, este campo puede estar vacío si automaticIntent está configurado en Welcome. En cada turno posterior, este campo debe contener el enunciado más reciente del contacto.
Carga útil personalizada	Objeto JSON convertido a cadena. {customPayload.asJSON()}. Opcional.	Pasa datos contextuales personalizados desde el script de Studio a AI Agents (Cognigy). Algunos ejemplos incluyen el nombre del contacto, el id de cuenta o los datos de CRM. Debe definir el objeto de carga útil personalizada en una acción Snippet. No utilice esta propiedad si necesita procesar los datos que devuelve el agente virtual al script. En su lugar, utilice la variable customPayloadVarName (out).
Estado de la sesión del bot	Variable completada por botSessionStateVarName (out) del turno anterior. Ejemplo: {botState}	Mantiene el contexto de la conversación entre turnos al devolver un identificador de sesión a AI Agents (Cognigy) con cada solicitud. AI Agents (Cognigy) crea este identificador en el primer turno. En todos los turnos posteriores, el script debe pasar el valor almacenado en No use esta propiedad si necesita procesar datos que el agente virtual devuelve al script. En su lugar, use la variable customPayloadVarName (out) de vuelta en este campo. Si no configura esto correctamente, AI Agents (Cognigy) crea una nueva sesión en cada turno y pierde el contexto.

Propiedades de salida

Las siguientes propiedades de salida están disponibles después de que se ejecuta la acción TextBotExchange. Consulte estas variables en las acciones subsiguientes de su script.

Propiedad	Valor aceptable o FORMATO
Siguiente nombre de variable (salida)	Contiene la configuración de comportamiento que controla cómo NiCE CXone solicita al contacto en el siguiente turno conversacional. Esta Variable se puede modificar en una acción Snippet antes de la siguiente llamada a TextBotExchange para personalizar el comportamiento por turno.
Nombre de variable de carga útil personalizada (salida)	Devuelve datos JSON personalizados de AI Agents (Cognigy) de vuelta al script de Studio. Use esta propiedad para procesar datos de cumplimiento o instrucciones de enrutamiento enviadas por AI Agents (Cognigy). Los valores comunes incluyen: escalat o cualquier intención que comience con escalat, como "escalate" o "escalation" — Enruta el contacto a un agente en vivo. El script Studio detecta este prefijo para gestionar la derivación de manera confiable en los diferentes nombres de intención de bot. end: finaliza la interacción. El script Studio utiliza este valor para terminar la sesión de contacto de forma correcta. No confunda esto con la propiedad de entrada customPayload.
Nombre de Var de Detalles de Error (out)	Contiene información de error cuando se toma la ramificación OnError. Inspeccione esta variable en la ramificación OnError para registrar o manejar el error. La variable del sistema _ERR también se completa con una descripción condensada del error.
Nombre de variable de información de intención (saliente)	Contiene detalles sobre la intención identificada por AI Agents (Cognigy) para el turno actual. Utilice esta Variable en su script para registrar datos de intención o tomar decisiones de enrutamiento basadas en la intención identificada.
Nombre de variable de estado de Sesión de Bot (salida)	Contiene el identificador de estado de la sesión que devuelve AI Agents (Cognigy) después de cada turno. Debe pasar el valor de esta variable a la propiedad de entrada botSessionState en el siguiente turno para mantener el contexto de la conversación. Esta propiedad es obligatoria para el funcionamiento correcto.