Por Avi
Publicado el 20 nov 2026
Nodo API de WhatsApp Chatbot: cómo llamar a tu backend, CRM o motor de IA durante una conversación
Un chatbot que solo envía mensajes predefinidos se queda corto rápidamente. El nodo API permite que tu bot de WhatsApp llame a tu backend, CRM, pasarela de pago o motor de IA durante una conversación, guarde la respuesta y tome una ruta según haya éxito o error. Aprende a configurarlo, probarlo y conocer sus casos de uso y prácticas recomendadas.
En resumen
- El nodo API permite que tu chatbot de WhatsApp llame a un sistema externo (tu backend, CRM, pasarela de pago o motor de IA) mientras el cliente sigue chateando.
- El bot envía una solicitud, espera la respuesta y luego decide qué hacer.
- En Chakra Chat, configuras la API, guardas la respuesta en una variable, seleccionas el valor mediante una ruta JSON y diriges las respuestas 2xx a la ruta de éxito y las que no son 2xx a la ruta de error.
- Úsalo cuando la respuesta necesite datos en tiempo real, no un mensaje predefinido.
- Tú creas un pequeño endpoint. Chakra se encarga de WhatsApp.
Un cliente escribe a tu número de WhatsApp: "¿Dónde está mi pedido?"
Un chatbot básico solo puede decir: "Comparte el número de tu pedido y nuestro equipo se pondrá en contacto contigo". Después, una persona inicia sesión en un panel, busca el pedido y escribe una respuesta.
Funciona cuando recibes 20 chats al día. Pero deja de funcionar con 2,000.
La solución no es un guion más inteligente. Es permitir que el bot consulte tus propios sistemas para obtener la respuesta. Para eso sirve el nodo API.
¿Qué es un nodo API en un chatbot?
Un flujo de chatbot es una serie de pasos (nodos): enviar un mensaje, hacer una pregunta, asignar la conversación a una persona y demás. El nodo API es el paso que se comunica con el mundo exterior.
En palabras de Chakra, este nodo permite que tu chatbot llame a una API desde el propio chatbot y que la respuesta se use más adelante en el flujo.
Piensa en él como una llamada telefónica que hace tu bot durante la conversación:
- A quién llama: tu backend, un CRM, una pasarela de pago, un motor de IA o cualquier servicio de terceros con una API
- Qué pregunta: "¿Cuál es el estado del pedido 4821?" o "¿El cupón DIWALI20 es válido?"
- Qué hace con la respuesta: se la muestra al cliente, la guarda o elige el siguiente paso
Úsalo siempre que un paso necesite datos externos en tiempo real en lugar de un mensaje predefinido.
¿Cómo funciona?
La idea es sencilla: solicitud, respuesta, decisión.
- El cliente responde. El bot recopila lo que necesita, por ejemplo, un número de pedido, mediante un nodo de pregunta.
- Se activa el nodo API. Envía una solicitud a tu URL con los datos recopilados.
- Tu sistema responde. Devuelve datos (estado del pedido, resultado del cupón o respuesta de IA) y un código de estado.
- El bot decide. Una respuesta 2xx sigue la ruta de éxito . Cualquier otra respuesta sigue la ruta de error .
- El cliente ve el resultado. Un nodo de mensaje muestra el valor guardado o el flujo continúa.
Mensaje del cliente
|
Nodo de pregunta (recopila el número de pedido)
|
Nodo API ---> Tu backend / CRM / motor de IA
| |
|<------ respuesta ---+
|
¿2xx? ---- sí ---> Mensaje: "Tu pedido está {{status}}"
|
no ----------> Respuesta alternativa: "Te comunicaré con nuestro equipo"
La conversación nunca sale de WhatsApp. El cliente simplemente recibe una respuesta rápida y específica.
¿Para qué puedes usarlo?
Para cualquier caso en el que una respuesta dependa de datos almacenados en otro lugar.
| Caso de uso | A qué llama el bot | Qué recibe el cliente |
|---|---|---|
| Estado del pedido | Tu sistema de pedidos | "Tu pedido está en camino y llegará hoy" |
| Verificación de cupón | Tu motor de promociones | "Código válido. Obtienes un 20% de descuento" |
| Consulta de cliente | Tu CRM | Un saludo personalizado y los datos de la cuenta |
| Estado del pago | Pasarela de pago | "Recibimos tu pago. Gracias" |
| Reserva de citas | Tu calendario o sistema de reservas | Horarios disponibles y luego una confirmación |
| Captación de leads | CRM o Google Sheets | Un nuevo lead creado a partir del chat |
| Respuestas de IA | Tu motor de IA o servicio RAG | Una respuesta fundamentada a una pregunta abierta |
| Verificación de identidad o elegibilidad | Servicio interno o de terceros | "Cumples los requisitos. Este es el siguiente paso" |
Ejemplos por industria
- D2C y comercio electrónico: seguimiento de pedidos, devoluciones, consultas de inventario
- Educación: estado de pagos, horarios de clases, consulta de resultados
- Bienes raíces: consulta la disponibilidad de proyectos y unidades en tu CRM
- Salud y clínicas: consulta los horarios disponibles para citas y confirma reservas
- Logística: seguimiento de envíos por número AWB
- Finanzas y seguros: estado de pólizas, fechas de vencimiento de primas
Conecta tu propio motor de IA
Si creaste tu propia capa de IA (un flujo RAG, un modelo ajustado o un copiloto de soporte), el nodo API es el puente.
El flujo:
- Hazle una pregunta al cliente con un nodo Question
- Envía el texto a tu endpoint de IA a través del nodo API
- Guarda la respuesta en una variable
- Muéstrala en un nodo Message
- Si la llamada falla, dirígela a una persona
Algunos consejos:
- Devuelve un campo de respuesta breve y claro. Las respuestas largas son difíciles de leer en WhatsApp.
- Mantén bajo el tiempo de respuesta. El cliente está viendo una ventana de chat.
- Incluye siempre una ruta alternativa, porque los endpoints de IA pueden agotar el tiempo de espera o generar errores.
Chakra también incluye un nodo AI integrado y funciones de IA conversacional. Úsalos cuando quieras incorporar IA sin escribir código. Usa el nodo API cuando quieras integrar tu propio motor, datos o lógica de negocio.
Configúralo en Chakra Chat
Aquí te explicamos en pasos sencillos el flujo de la guía del nodo Call APIde Chakra.
1. Configura la API a la que quieres llamar
- Arrastra el nodo Call API al lienzo, a la derecha del nodo que recopila la información
- Haz clic en Show Editor para abrir la configuración de la API
- Ingresa tu URL y elige el método HTTP
- Elige un tipo de cuerpo: form url encoded o form multipart
- Agrega tus pares clave/valor, por ejemplo, asigna
order_ida la respuesta del cliente - Haz clic en Save API
2. Incluye los datos del chat en la solicitud
Escribe {{ en la carga útil para ver las variables que puedes insertar. Puedes usar el texto del último mensaje del chat y cualquier dato recopilado antes en el chatbot.
Así es como el ID de pedido o el correo electrónico de un cliente se incluyen en tu solicitud.
3. Guarda la respuesta de la API como una variable
En Store response in variable?, ingresa un nombre como api_response.
4. Selecciona el valor exacto con una ruta JSON
En JSON path of value to store?, ingresa la ruta al valor que quieres. La respuesta se lee mediante la clave response.data.
Ejemplo de respuesta de tu servidor:
{
"order": {
"id": "4821",
"status": "Out for delivery",
"eta": "Today, 6 PM"
}
}
Para guardar solo el estado, usa:
response.data.order.status
Usa la ruta para extraer solo el valor que necesitas y mantener tus mensajes claros, en lugar de mostrar una respuesta completa.
5. Crea ramas para los casos de éxito y error
El nodo tiene dos salidas:
- Éxito: una respuesta 2xx
- Error: una respuesta que no sea 2xx
Conecta cada salida al siguiente nodo que quieras.
6. Usa la variable en tu respuesta
Agrega un nodo Message después de la salida de éxito. Escribe @ y elige tu variable, por ejemplo:
¡Buenas noticias! El estado de tu pedido es: @order_status.
Guarda el nodo y luego guarda el chatbot.
Un ejemplo sencillo de endpoint
Tu servidor solo tiene que devolver JSON. Aquí tienes un ejemplo básico en Node.js (el tuyo será diferente):
app.use(express.urlencoded({ extended: true }));
app.post("/order-status", async (req, res) => {
const order = await db.findOrder(req.body.order_id);
if (!order) {
return res.status(404).json({ error: "Order not found" });
}
res.json({
order: { id: order.id, status: order.status, eta: order.eta }
});
});
Un 404 va por la rama de error , así que tu bot puede decir "No pude encontrar ese pedido" en lugar de no mostrar nada.
Prueba antes de publicarlo
Haz pruebas por etapas.
- Prueba tu endpoint por separado. Usa primero una herramienta como cURL o Postman. Confirma que devuelva los códigos de estado y el JSON que esperas.
- Prueba el flujo en el modo de vista previa del creador. El creador de chatbots de Chakra te permite simular una conversación de WhatsApp antes de publicarla.
- Prueba los casos de error. ID de pedido incorrecto, respuesta vacía o tu servidor fuera de servicio.
- Verifica la ruta JSON. Si el mensaje aparece en blanco, normalmente la ruta no coincide con la respuesta.
- Prueba en un teléfono real con un número de prueba antes de activarlo para los clientes.
¿Qué pasa después de la respuesta?
Piensa en la respuesta como una bifurcación en el camino.
Si la respuesta es exitosa (2xx):
- Muestra la respuesta en un nodo de mensaje
- Usa el valor guardado más adelante en el flujo
- Pasa a la siguiente pregunta o cierra el chat amablemente
Si la respuesta falla (no es 2xx):
- Envía un mensaje alternativo cordial
- Ofrece volver a intentarlo
- Deriva el chat a una persona con el nodo Asignar a una persona
Cómo gestionar los errores
Tu API fallará de vez en cuando. Prepárate.
- No dejes nunca al cliente esperando. Todos los nodos de API deben tener una ruta de error.
- Usa mensajes específicos. «No encontramos ese pedido. Verifica el ID» es mejor que «Algo salió mal».
- Ofrece ayuda de una persona. Los errores son precisamente cuando una persona puede aportar valor.
- Devuelve códigos de estado útiles. Un 404 para «no encontrado» y un 500 para «problema del servidor» te permiten gestionar cada caso de forma intencional.
- Haz que la llamada sea rápida. El chat espera la respuesta, así que los endpoints lentos se sienten como respuestas tardías.
- No lo uses para procesos largos. Para cualquier tarea que tarde minutos, iníciala y envía el resultado después en un mensaje aparte.
Ventajas principales
- Respuestas en tiempo real en lugar de respuestas predefinidas. Los clientes reciben datos reales en el chat.
- Menos tickets para tu equipo. Las preguntas repetitivas se resuelven de principio a fin.
- Funciona con los sistemas que ya tienes. No hace falta trasladar tus datos al chatbot.
- Usa tu propia lógica. Las reglas de negocio, los precios, los criterios de elegibilidad y la IA se quedan en tu código.
- Flujos low-code, código solo cuando hace falta. Los equipos de operaciones gestionan la conversación. Los desarrolladores se encargan del endpoint.
- Reutilizable. Un endpoint puede servir para muchos flujos.
¿Por qué no crear todo en tu propio sistema?
Puedes hacerlo. Algunos equipos lo hacen. Esto es lo que implica:
| Tarea | Crearlo por tu cuenta | Usar Chakra con el nodo de API |
|---|---|---|
| Conexión con WhatsApp Business Platform | Tú lo creas y mantienes | Listo para ti |
| Recibir y dirigir webhooks | Tú lo creas | Gestionado en la plataforma |
| Estado de la conversación y lógica del flujo | Tú lo programas y almacenas | Editor visual de flujos |
| Gestión de plantillas | Tú lo creas | Gestión nativa de plantillas |
| Bandeja de entrada del equipo y transferencia a una persona | Tú lo creas | Integrado |
| Lógica de negocio y datos | Tu código | Tu código, llamado a través del nodo de API |
| Cambiar un flujo | Cambiar el código y desplegarlo | Editar en el editor |
La verdadera decisión no es «crear o comprar». Se trata de en qué quieres que tus desarrolladores inviertan su tiempo.
- Dedícalo a tu lógica de negocio: consultas de pedidos, precios, criterios de elegibilidad e IA
- No a la infraestructura: conexiones de WhatsApp, webhooks, bandeja de entrada y herramientas de flujo
¿Cuándo tiene sentido crear tu propio sistema? Si la lógica de tu bot es muy personalizada o tienes que ejecutar todo en tu propia infraestructura. Para la mayoría de los equipos, un enfoque híbrido es más rápido: la plataforma gestiona la conversación y tu sistema proporciona las respuestas.
Prácticas recomendadas
- Protege tu endpoint. Usa HTTPS y un método de autenticación. Nunca dejes abierto un endpoint de datos.
- Devuelve un JSON pequeño y plano. Es más fácil de asignar y menos probable que falle.
- Mantén estables los nombres de los campos. Cambiar la estructura de una respuesta puede hacer que la ruta JSON deje de funcionar sin aviso.
- Usa nombres de variables claros , como
order_status, nodata1. - Valida primero los datos de entrada. Verifica el formato del ID del pedido en el flujo antes de llamar a tu servidor.
- Siempre crea la ruta de error.
- Respeta la privacidad. Devuelve solo lo que el cliente debe ver y verifica su identidad antes de mostrar los detalles de su cuenta.
- Registra las solicitudes de tu lado para que puedas depurar problemas.
Limitaciones que debes conocer
- El chat espera la respuesta, así que los endpoints lentos afectan la experiencia.
- Necesitas un desarrollador para crear y proteger el endpoint.
- Los errores en la ruta JSON aparecerán como valores en blanco.
- Consulta qué plan incluye el nodo Chatbot API en la página de precios. El acceso a Developer API y webhooks está incluido en los planes de pago desde Starter.
Por qué los equipos usan esto en Chakra Chat
Chakra presta servicio a más de 2,500 clientes en más de 65 países, y el creador de chatbots está diseñado para ser sencillo para los equipos de negocio y flexible para los desarrolladores.
- Creador visual con modo de vista previa para probar los flujos antes de publicarlos
- Compatibilidad con coexistencia para que puedas conservar tu número de la aplicación WhatsApp Business. Descubre cómo funciona
- Sin recargos en los mensajes de plantilla
- Ayuda con la configuración y soporte continuo
- Aplicaciones móviles para iOS y Android
- API para desarrolladores en apidocs.chakrahq.com para integraciones más avanzadas
¿Quieres ver el creador? Explora el creador de chatbots de WhatsApp.
Preguntas frecuentes
¿Qué es un nodo API en un chatbot de WhatsApp? Es un paso de tu flujo que envía una solicitud a un sistema externo y usa la respuesta en la conversación.
¿El nodo API puede llamar a mi propio motor de IA? Sí. Envía el mensaje del cliente a tu endpoint de IA, guarda la respuesta en una variable y muéstrala en un nodo de Mensaje.
¿Qué determina el éxito o el error? El código de estado HTTP. Una respuesta 2xx sigue la rama de éxito. Cualquier otra respuesta sigue la rama de error.
¿Cómo selecciono un valor de una respuesta larga? Usa el campo de ruta JSON. La respuesta se lee a través de response.data, así que el campo de estado podría ser response.data.order.status.
¿Puedo enviar los detalles del cliente a mi API? Sí. Escribe {{ en la carga útil para insertar el último mensaje del chat o cualquier variable recopilada anteriormente.
¿Qué pasa si mi servidor no funciona? El flujo sigue la rama de error. Úsala para enviar una respuesta alternativa amable y transferir la conversación a una persona.
¿Necesito programar? No necesitas programar el flujo del chatbot. Sí necesitas un desarrollador que cree el endpoint al que llama el nodo.
¿Qué plan necesito? El acceso a Developer API y webhooks está disponible en los planes de pago desde Starter. Consulta la página de precios para ver qué plan incluye el nodo Chatbot API.
Para terminar
Un chatbot que solo envía mensajes fijos es un menú. Un chatbot que puede consultar tus sistemas para conocer la respuesta es un asistente.
El nodo API es el pequeño paso que marca la diferencia: recopila la información, llama a tu sistema, guarda la respuesta y dirige el flujo según el éxito o el error. Empieza con un caso de uso sencillo, como consultar el estado de un pedido o verificar un cupón, y continúa a partir de ahí.
Referencias
- Ayuda de Chakra: Cómo usar el nodo Call API en un chatbot
- Chakra Chat: Creador de chatbots de WhatsApp
- Chakra Chat: API para desarrolladores
- Documentación de Chakra API
- Precios de Chakra Chat