Llamar a la acción del conector de bot

Prerrequisitos 
  • Integraciones > Integraciones > Vista permiso

Utilice la acción Call Bot Connector en los flujos de mensajería de Architect. Esta acción le permite integrar el flujo de mensajes con cualquier fuente de bot para su procesamiento antes de que devuelva intenciones y espacios a Architect. Cuando utiliza esta acción, proporciona un "Lista de bots". El arquitecto usa esta lista para completar campos como el nombre del bot, la versión, las intenciones y las variables de sesión, y luego proporciona la información de la llamada al bot del cliente para su procesamiento.

Nota: Asegúrese de trabajar con un ingeniero de software para desarrollar una capa de traducción. Esta capa permite que los bots de terceros se comuniquen con las API de Genesys Cloud.
Nombre Descripción
Campo de nombre Escriba un nombre distintivo para la acción. La etiqueta que ingrese aquí se convierte en el nombre de la acción que se muestra en la secuencia de tareas.
Bot de entrada de texto Ingrese el texto que desea enviar al bot. El texto de entrada predeterminado es Message.Message.Body.
Tiempo de espera de respuesta de seguimiento

El bot puede recuperar información de seguimiento del usuario. Aquí, ingrese la cantidad de tiempo que el bot espera la respuesta del usuario.

El tiempo de espera de respuesta predeterminado es de 12 horas y el valor mínimo permitido es de 0 segundos. El sistema considera un NOT_SET o una duración negativa como inmediata.

Nota: El tiempo de espera de respuesta de seguimiento se aplica a la respuesta de cada cliente. Cada vez que el cliente responde y luego recibe otro mensaje del bot, el tiempo de espera se restablece.

Por ejemplo, si el bot pregunta "¿Cuál es su fecha preferida?", Espera hasta 12 horas la respuesta del cliente. Si el cliente responde con una fecha dentro del marco de tiempo de 12 horas y el bot responde: "Gracias, ¿tiene una opción alternativa?", Entonces el flujo reinicia el tiempo de espera. El flujo espera otras 12 horas por la respuesta sobre una fecha alternativa.

Integración de bots El nombre de la integración del bot que desea usar en el flujo.
Nombre del bot

El nombre del bot al que llamar dentro del flujo de mensajes.

Versión del bot La versión específica del bot que desea utilizar. Esta versión es el alias especificado en la lista de bots proporcionada que apunta a una versión específica de un bot.
Variables de sesión

La información que puede pasar al bot. Ingrese el nombre de la variable y un valor para asignar. Puede agregar varias variables y reordenarlas.

Más comúnmente, use variables de sesión para bots que inicien el conector de bot con la intención completa. Este proceso garantiza que el conector de bot reciba el contexto necesario para realizar sus operaciones.

Intenciones

Las opciones que aparecen en esta sección reflejan la lógica configurada en el bot. Cada intento representa una acción a realizar. Por ejemplo, reserve un hotel (BookHotel) u ordene flores (OrderFlowers). Cada ruta de intención coincide con una ruta de salida para la acción del conector de bot de llamada en el editor de tareas.

Debajo de cada intención, Architect muestra las ranuras de bot configuradas o los datos que el usuario debe proporcionar para cumplir con la intención. Utilizando la intención de BookHotel como ejemplo, los espacios podrían incluir la ubicación, la fecha de entrada, el tipo de habitación y la cantidad de noches. Si el usuario elige la ruta de BookHotel, el bot proporciona los espacios asociados con esa ruta.

Salidas de falla

Seleccione las variables a las que desea asignar los valores de los datos de fallo que devuelve el bot.

Variable

Valor

errorType
  • FeatureNotEnabledError: La acción Call Bot Connector no está disponible para la organización.
  • Error de servidor interno: Se produjo un error inesperado durante el procesamiento de la acción de Call Bot Connector. Normalmente, la respuesta recibida tiene un formato no válido. Contacto Atención al cliente de Genesys Cloud.
  • NoInputError: Se agotó el tiempo de espera de la acción Call Bot Connector sin ninguna entrada del usuario.
  • NoMatchError: La entrada del usuario que recibió el bot no coincidió con ningún elemento gramatical.
  • VersionMismatchError: Se recibió correctamente del bot, pero se produjo una falta de coincidencia. Por ejemplo, la intención devuelta no coincidió con ninguna intención configurada con la acción. Vuelva a cargar el flujo y vuelva a publicarlo.
mensaje de error Un mensaje no localizado. Esta variable de cadena puede estar vacía o NOT_SET.

Nota: Para expandir o contraer la lista de variables, haga clic en la flecha junto a Salidas de falla.

Configurar rutas de éxito y fracaso

Nombre Descripción
Intención de ruta de salida o rutas

Configure una salida coincidente para la intención. Esta ruta indica que la acción se comunicó correctamente con su punto final externo y recibió un resultado. Todas las variables de salida del bot son tipos de cadena.

Arrastre la acción adecuada debajo de la ruta de intención que sigue la ruta que desea que tome la interacción. 

Ruta de salida de falla

Esta ruta indica que se produjo un error al ejecutar la acción o hubo un problema al procesar los resultados.  

Nota: Si la red experimenta problemas de conectividad, la acción toma automáticamente esta ruta de falla.

Arrastre la acción apropiada debajo de la ruta de falla que dirige la ruta que desea que tome la interacción. Por ejemplo, una acción de transferencia para enviar la interacción a un agente en busca de asistencia.