Responde con datos en vivo de tus propios sistemas
Las llamadas a herramientas permiten que el chatbot llame a tu API durante una conversación, lea la respuesta y la use en su réplica. El cliente pregunta por su pedido y el bot da la respuesta real, no una genérica.
El entrenamiento enseña al chatbot cosas que no cambian. Las llamadas a herramientas cubren lo que varía minuto a minuto: el estado de un pedido, un número de seguimiento, una reserva. Es una función avanzada y requiere código personalizado en tu servidor, así que coordínalo con quien gestione tus sistemas.
Paso a paso
Decide dónde debe ir la consulta
Las llamadas a herramientas se usan tanto en Preguntas y respuestas como en Flujos. Ponlas en una Pregunta y respuesta cuando una sola pregunta necesite una respuesta en vivo, y en un flujo cuando la consulta sea un paso dentro de una conversación más larga.
Apúntalo a tu endpoint
En URL, introduce la dirección del endpoint de la API que responderá a la solicitud. En Headers, añade los pares clave:valor que necesite tu endpoint. En Preguntas y respuestas, los headers se separan con comas; en flujos se añaden uno a uno.
Define qué debe darte el cliente
Las propiedades son los valores que el chatbot debe recopilar antes de poder llamarte, por ejemplo una ciudad o un número de seguimiento. Si los valores posibles se conocen de antemano, enuméralos en Valores permitidos para que el bot se ciña a ese conjunto.
Lee la solicitud en tu servidor
Te enviamos a tu servidor esta estructura: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — como cuerpo JSON para POST y como cabecera para GET. Cada clave de argumento es el nombre de la propiedad en kebab case, así que "Order Number" llega como order-number. También puedes colocar un valor directamente en la URL con un campo de fusión, por ejemplo {order-number}.
Devuelve JSON que el chatbot pueda usar
Tu servidor debe responder con un JSON que contenga los valores que quieres que el bot comunique, por ejemplo {"order_status":"Entregado hace 2 horas y 25 minutos","success":true}. Incluye "success": true solo cuando la solicitud realmente haya tenido éxito.
Referencia de ajustes
| Configuración | Qué hace |
|---|---|
| URL | La dirección de tu endpoint API que el chatbot llamará. |
| Headers | Pares clave:valor enviados con la solicitud, separados por comas en Q&A y añadidos uno a uno en flujos. |
| Properties | Los valores que el usuario debe proporcionar antes de que se pueda realizar la llamada, como una ciudad o un número de seguimiento. |
| Allowed values | Restringe una propiedad a un conjunto conocido de opciones en lugar de texto libre. |
Información útil
"success": true es una promesa, no una formalidad
Devuélvelo solo cuando la solicitud realmente haya funcionado. Si el número de pedido no es válido o no se encontró nada, omítelo para que el chatbot no presente un fallo como respuesta.
Los nombres de los argumentos cambian de forma
Los nombres de las propiedades llegan en kebab case, por lo que "Order Number" se convierte en order-number. Respeta esa ortografía en tu código y en cualquier campo de combinación que pongas en la URL.
GET y POST reciben los datos de forma diferente
Para POST, el payload llega como un cuerpo JSON. Para GET, llega como un encabezado. Comprueba qué método usa tu endpoint antes de empezar a leer la solicitud.
Recibes contexto con cada llamada
La solicitud incluye user_id, conversation_id y user_language, para que tu endpoint sepa quién pregunta y en qué idioma.
Esto necesita un desarrollador.
La llamada a herramientas es una función avanzada. La parte del panel es breve, pero algo en tu servidor debe recibir la solicitud y devolver el JSON.
Preguntas frecuentes
¿Dónde puedo usar la llamada a herramientas?
¿Qué envías exactamente a mi servidor?
¿Cómo obtengo el valor del cliente en mi URL?
¿Qué debe devolver mi servidor?
¿Qué pasa si el cliente da un número que no existe?
¿Puedo limitar lo que el cliente puede introducir?
¿Listo para acabar con el caos?
Unifica tus mensajes, automatiza las preguntas repetitivas y convierte las conversaciones en ingresos, desde hoy mismo.
Empezar