¿Cómo configuro los pasos Acción de integración y Llamada a herramienta?

¿Para qué sirven?

Ambos pasos hacen trabajo en un sistema externo en un punto del agente; los visitantes no ven ninguno de los dos.

• «Acción de integración» ejecuta una acción lista de una integración conectada (por ejemplo, crear una tarjeta de Trello o avisar en Slack o Teams).
• «Llamada a herramienta» llama a una herramienta que definiste para tu propio sistema en la página «Herramientas» (por ejemplo, consultar el estado de un pedido).

Ambos tienen las salidas «Al terminar» y «Si falla», y «Reintentar si falla» funciona igual en los dos.

Acción de integración

Los visitantes no ven este paso: el flujo ejecuta aquí una acción de una integración conectada (por ejemplo, crear una tarjeta de Trello o avisar en Slack o Teams) y continúa.

1. Abre la categoría «Integraciones» en la paleta «Añadir paso», haz clic en la integración y luego en la acción; el paso se añade al lienzo.
2. En el panel del paso, revisa la «Acción» y rellena sus campos. Elige valores de una lista («Elegir de la lista») o escríbelos («Lo escribiré»); usa {variable} para respuestas anteriores.
3. Para usar el resultado en pasos posteriores, dale un nombre de variable en «Guardar en variables». Las variables viven en el navegador del visitante, así que no elijas valores que deban ser privados.

El paso tiene dos salidas: «Al terminar» y «Si falla». Si la integración no está conectada o el proveedor devuelve un error, el flujo toma «Si falla». Si «Si falla» está vacía, la conversación se cierra con un mensaje de que algo salió mal. Si quieres que el agente siga también tras un fallo, conecta «Si falla» al mismo paso que «Al terminar». Si un campo obligatorio está vacío, no se llama al proveedor y el paso toma «Si falla». La «Nota del paso» es solo para ti; los visitantes no la ven.

Una acción que cambia datos no se vuelve a ejecutar cuando el visitante pulsa atrás o reenvía un mensaje. Si la conversación vuelve a pasar por este paso (por ejemplo, regresando por un menú), se ejecuta de nuevo.

Mientras el paso se ejecuta, el visitante ve lo que está pasando en lugar de «Pensando»: un texto adecuado («Procesando tu solicitud…», «Comprobando los detalles…»); para trabajo interno como avisar a tu equipo, solo «Un momento…». Puedes escribir tu propio texto en «Texto mostrado durante la espera» (por ejemplo, «Creando tu cita…»); se traduce a tus otros idiomas.

Las acciones que eliminan o cancelan algo de forma permanente no se ejecutan hasta que marques «Entiendo que este paso hace algo que no se puede deshacer»; las que envían desde tu cuenta necesitan «Entiendo que este paso envía desde mi cuenta». Las eliminaciones se ejecutan como máximo 20 veces y los envíos como máximo 100 veces por hora y espacio de trabajo. El registro que se elimina no puede venir de una respuesta del visitante.

Llamada a herramienta

Llama a una herramienta definida en la página «Herramientas» exactamente en este punto del agente, sin usar IA. Los visitantes no ven este paso; su texto es solo tu nota.

1. Añade un paso Llamada a herramienta y elige la herramienta de la lista.
2. Da valor a los campos de la herramienta: un valor fijo, una variable de una respuesta anterior (por ejemplo, {order_no}) o la ruta a un campo de una respuesta anterior (por ejemplo, {order.no}).
3. En «Guardar en variables», guarda la respuesta completa o el código de error en una variable; puedes usarla en pasos posteriores como {variable}.
4. Conecta las ramas «Al terminar» y «Si falla». Si la herramienta no responde o devuelve un error, el flujo toma la rama «Si falla». Si está vacía, la conversación se cierra con un mensaje de que algo salió mal. Si quieres que el agente siga también tras un fallo, conecta «Si falla» al mismo paso que «Al terminar».

Mientras la herramienta se ejecuta, el visitante ve un texto como «Comprobando los detalles…» o «Procesando tu solicitud…» (en las herramientas de tienda, el trabajo en sí, como «Buscando productos…»). Puedes escribir tu propio texto en «Texto mostrado durante la espera».

Los subcampos de los campos Objeto de una herramienta se rellenan en cuadros separados. Para una lista cuyos elementos son Objetos, introduce primero una variable de lista en «Origen de la lista» (por ejemplo, la lista de una acción o el resultado de un paso Editar lista) y luego asigna los campos del elemento en «Campos de cada elemento», como {item.sku}. Cada elemento del origen se convierte en una fila de la lista; si dejas la asignación vacía, los elementos se envían tal cual.

Una herramienta que cambia datos no se vuelve a ejecutar cuando el visitante pulsa atrás o reenvía un mensaje. Si la conversación vuelve a pasar por este paso (por ejemplo, regresando por un menú), se ejecuta de nuevo. Una herramienta que lee datos se llama cada vez que el visitante llega al paso.

Si un campo obligatorio está vacío o un valor no coincide con el tipo de su campo, no se llama a la herramienta y el paso toma «Si falla». El editor muestra como aviso en el paso un valor fijo que no coincide con su tipo. Las llamadas aparecen en la página «Herramientas» › «Estadísticas de llamadas».

Reintentar si falla

Si activas «Reintentar si falla» en un paso Acción de integración o Llamada a herramienta, el paso se ejecuta de nuevo ante un error temporal. Cuando se agotan los intentos, el flujo sigue por «Si falla»; si esa rama está vacía, la conversación se cierra con un mensaje de que algo salió mal.

• «Intentos máximos»: de 2 a 5; 3 por defecto.
• «Espera entre intentos (s)»: de 0 a 5 segundos; 1 por defecto.

Todos los intentos duran como máximo 18 segundos; si se acaba el tiempo, se omiten los restantes.

Solo se reintentan los errores temporales: tiempos de espera agotados, errores de conexión, caídas del proveedor y límites de frecuencia. Ante errores como un permiso que falta o un campo vacío, el paso va directamente a «Si falla».

Úsalo con cuidado en pasos que crean un registro o envían un mensaje: si se agota el tiempo, la petición puede haber llegado al proveedor, y el mismo registro o mensaje puede crearse dos veces.