Acciones personalizadas — conecta tu propia API

Una acción personalizada permite que tu chatbot haga algo durante la conversación llamando a tu propia API: ver dónde está un pedido, abrir una solicitud de devolución, leer el plan de un cliente o crear un ticket de soporte. No instalas ninguna app: apuntas el bot a un endpoint HTTPS que tú (o tu desarrollador) ya tienen. Disponible en Growth y planes superiores.

Crear una acción

1. Abre la pestaña Acciones

   Abre tu chatbot, ve a la pestaña Acciones y haz clic en Nueva acción.

2. Ponle nombre y descríbela

   Usa un nombre corto como lookup_order y una descripción que diga cuándo usarla y qué devuelve, por ejemplo: Consulta el estado de un pedido del cliente: estado, transportista, enlace de seguimiento y entrega estimada. La descripción es lo que hace que el bot la use en el momento justo.

3. Agrega los datos

   Indica qué debe pedirle el bot al cliente, como order_number. Marca como obligatorios los imprescindibles.

4. Configura la solicitud

   Elige el método e ingresa la URL, por ejemplo https://api.tutienda.com/orders/{{order_number}}. Agrega las cabeceras que necesite tu API, como Authorization: Bearer .... Para POST, PUT o PATCH puedes escribir una plantilla de cuerpo JSON; sin ella enviamos los datos, el cliente verificado y la conversación.

5. Elige la seguridad

   Activa Solo para clientes verificados para todo lo que trate datos de un cliente, y Pedir confirmación al cliente para todo lo que cambie algo.

6. Envía una prueba

   Guarda y usa Enviar prueba con datos de ejemplo y, si hace falta, un cliente de ejemplo. Revisa el estado y la respuesta, y luego haz una pregunta real en la pestaña Sandbox.

Variables

La URL, las cabeceras y el cuerpo pueden usar variables entre llaves dobles:

En la URL las variables se codifican. En un cuerpo JSON ponlas dentro de strings ("{{order_number}}"); un string que sea exactamente una variable conserva su tipo (un número sigue siendo número). No se pueden usar variables en el nombre del host.

Seguridad

• Solo para clientes verificados: a los visitantes anónimos se les pide iniciar sesión y no se envía nada. En WhatsApp y Telegram el cliente se identifica por su cuenta, así que funciona automáticamente.
• Pedir confirmación al cliente: el bot resume lo que va a hacer y pregunta; ChatbotGen solo envía la solicitud cuando el cliente responde Sí, confirmar (o Yes, confirm) y el bot vuelve a llamar a la acción con exactamente los mismos datos. Lo controla ChatbotGen, no la IA. El widget muestra los botones Sí, confirmar / No, cancelar.

Qué ve el bot

El bot recibe hasta 8.000 caracteres de tu respuesta, como datos. Devuelve solo los campos que debe usar y deja fuera lo que no debe contarle al cliente. Una respuesta que no sea 2xx se le informa como fallo, así que no fingirá que funcionó. Las solicitudes expiran a los 10 segundos.

Registro de actividad

Cada llamada aparece en Actividad, en la pestaña Acciones: cuándo se ejecutó, los datos, el estado y la respuesta (guardada cifrada). Úsalo para ver por qué falló una acción: una URL incorrecta, una cabecera faltante o un visitante anónimo usando una acción solo para verificados.

Ejemplos

• Estado del pedido: GET https://api.tutienda.com/orders/{{order_number}}?email={{user.email}}, solo clientes verificados.
• Solicitud de devolución: POST https://api.tutienda.com/returns con order_number y reason, solo verificados y con confirmación.
• Ticket de soporte: POST a la API de tickets de tu helpdesk (Zendesk, Freshdesk…) con su token en la cabecera Authorization, con confirmación.

Ver también

• Identificar clientes con sesión iniciada
• Servidores MCP
• Webhooks: para enviar eventos en lugar de llamar a tu API durante el chat