WhatsApp Chatbot API — Construya conversaciones inteligentes

Cree chatbots con IA, respondedores basados en reglas y flujos conversacionales en WhatsApp. Conecte su lógica a nuestra API y gestione las conversaciones con sus clientes automáticamente.

Cómo funciona un chatbot de WhatsApp

Un chatbot de WhatsApp tiene tres componentes: la capa de conexión, la capa de procesamiento y la capa de respuesta. Nuestra API se encarga por completo de la capa de conexión. Usted construye las capas de procesamiento y respuesta.

El flujo es sencillo:

1. Un cliente envía un mensaje a su número de WhatsApp
2. Nuestra API recibe el mensaje y lo reenvía a su URL de webhook
3. Su gestor de webhooks procesa el mensaje: aquí reside la lógica de su chatbot
4. Su gestor llama a nuestra API para enviar una respuesta de vuelta al cliente
5. El cliente recibe la respuesta en su chat de WhatsApp

Todo este ciclo suele completarse en menos de 200 milisegundos. El cliente ve la respuesta casi al instante, lo que genera una experiencia conversacional natural.

Patrones de arquitectura de chatbots

Patrón 1: bot simple basado en reglas

El chatbot más simple utiliza coincidencia de palabras clave. Cuando un cliente envía "seguir pedido", el bot responde con el enlace de seguimiento del pedido. Cuando envía "horario", el bot responde con el horario de atención. Este patrón funciona bien para bots tipo FAQ y puede implementarse en menos de 50 líneas de código.

# Python example - simple rule-based bot
def handle_message(message):
    msg = message.lower()
    if 'track' in msg or 'order' in msg:
        return 'Track your order here: https://example.com/track'
    elif 'hours' in msg:
        return 'We are open Mon-Fri, 9AM-6PM.'
    elif 'help' in msg:
        return 'Type: track, hours, or contact for support.'
    else:
        return 'I am not sure how to help. Type "help" for options.'

Patrón 2: bot de conversación con estado

Un bot más sofisticado realiza un seguimiento del estado de la conversación. El cliente avanza por un flujo: seleccionar una opción del menú, proporcionar información, confirmar una acción. Cada paso depende del anterior. Necesita almacenar el estado de la conversación (en una base de datos, Redis o en memoria) y consultarlo al procesar cada mensaje nuevo.

Este patrón es ideal para reservas de citas, realización de pedidos, calificación de leads y cualquier proceso de varios pasos. El bot hace una pregunta, espera la respuesta, hace la siguiente pregunta, y así sucesivamente hasta completar el flujo.

Patrón 3: bot con IA

Conecte nuestro webhook a un modelo de IA (OpenAI, Claude o cualquier LLM) y deje que el bot gestione conversaciones de formato libre. La IA genera respuestas basadas en su prompt de sistema, su base de conocimiento y el historial de la conversación. Esto funciona notablemente bien para soporte al cliente, preguntas sobre productos y consultas generales.

// Node.js example - AI-powered bot
app.post('/webhook', async (req, res) => {
    const { message, from } = req.body.data;

    // Call your AI model
    const aiResponse = await openai.chat.completions.create({
        model: 'gpt-4',
        messages: [
            { role: 'system', content: 'You are a helpful support agent for...' },
            { role: 'user', content: message }
        ]
    });

    // Send the AI response back via WhatsApp
    await fetch('https://api2whats.com/send-text', {
        method: 'POST',
        headers: { 'Authorization': 'Bearer ' + API_KEY },
        body: JSON.stringify({
            to: from,
            message: aiResponse.choices[0].message.content
        })
    });

    res.json({ success: true });
});

Patrón 4: bot híbrido

El enfoque más práctico combina reglas, estado e IA. Las consultas simples reciben respuestas rápidas basadas en reglas. Las consultas complejas activan la IA. Si la IA no puede resolver el problema, la conversación escala a un agente humano. Así obtiene la velocidad de las reglas, la flexibilidad de la IA y la red de seguridad del soporte humano.

Construir un chatbot: paso a paso

Paso 1: configure la conexión con la API

Cree una cuenta, conecte un número de WhatsApp y obtenga su clave de API. Configure su URL de webhook en el panel de control o mediante la API. Compruebe que los mensajes entrantes llegan a su servidor revisando los registros de webhook.

Paso 2: diseñe sus flujos de conversación

Trace los flujos de conversación que su bot debe gestionar. Empiece con las 5-10 consultas de clientes más habituales. Para cada una, defina:

• Qué desencadena el flujo (palabras clave, intenciones o comandos directos)
• Qué preguntas hace el bot
• Qué información necesita el bot del cliente
• Qué respuesta o acción proporciona el bot
• Qué ocurre si el bot no puede ayudar (ruta de escalado)

Paso 3: implemente el gestor de webhooks

Escriba un endpoint de servidor que reciba las solicitudes POST de nuestra API. Analice el mensaje entrante, páselo por su lógica de chatbot y envíe una respuesta utilizando nuestra API. Controle los casos límite: mensajes vacíos, mensajes multimedia, mensajes de números que no reconoce.

Paso 4: pruebe e itere

Conecte su número personal como instancia de prueba. Envíele mensajes desde otro teléfono. Pruebe cada flujo de conversación. Compruebe que el bot maneja con elegancia las entradas inesperadas. Supervise los registros de webhook en busca de errores.

Paso 5: despliegue y monitorice

Despliegue su gestor de webhooks en un servidor de producción. Configure la monitorización de tiempos de respuesta, tasas de error y tasas de finalización de conversaciones. Utilice los webhooks de estado de mensajes para seguir las tasas de entrega y lectura.

Casos de uso de los chatbots de WhatsApp

Soporte al cliente

Gestione automáticamente las consultas de soporte más comunes: estado de pedidos, políticas de devolución, horarios de la tienda, preguntas de cuenta. Reduzca el volumen de tickets entre un 40 y un 60% mientras ofrece respuestas instantáneas 24/7. Escale los problemas complejos a agentes humanos con el contexto completo de la conversación.

E-commerce

Envíe confirmaciones de pedidos, actualizaciones de envío y notificaciones de entrega automáticamente. Permita que los clientes sigan sus pedidos enviando su número de pedido. Recomiende productos basándose en el historial de compras. Gestione devoluciones y cambios mediante flujos conversacionales.

Reserva de citas

Permita que los clientes reserven citas directamente en WhatsApp. Muestre los horarios disponibles, recopile la información necesaria, envíe mensajes de confirmación y gestione los cambios de hora. Integre con su sistema de calendario para evitar dobles reservas.

Generación de leads

Califique leads mediante flujos conversacionales. Pregunte por presupuesto, plazos, requisitos y tamaño de la empresa. Puntúe los leads automáticamente y derive los prospectos cualificados a su equipo de ventas. Envíe mensajes de seguimiento a intervalos programados.

Herramientas internas

Cree chatbots internos para su equipo. Bots de soporte técnico de IT que gestionen restablecimientos de contraseñas y comprobaciones del estado de los sistemas. Bots de RR. HH. que respondan a preguntas sobre políticas. Bots de operaciones que informen sobre la salud del sistema y activen alertas.

Mejores prácticas

• Mantenga las respuestas breves — WhatsApp es una plataforma concebida para el móvil. Los párrafos largos se ignoran. Apunte a 1-3 frases por respuesta.
• Use respuestas rápidas — Cuando sea posible, ofrezca opciones numeradas ("Responda 1 para estado del pedido, 2 para devoluciones") en lugar de preguntas abiertas.
• Ofrezca siempre una salida — Todo flujo de conversación debe tener una forma de llegar a un agente humano. "Escriba 'agente' para hablar con una persona."
• Personalice — Utilice el nombre del cliente y haga referencia a su pedido o cuenta. Los mensajes personalizados consiguen entre 3 y 5 veces más interacción.
• Pruebe con usuarios reales — Su bot será utilizado por personas reales con preguntas reales que no anticipó. Pruebe pronto y con frecuencia.
• Monitorice y mejore — Realice un seguimiento de qué mensajes causan confusión o abandono. Refine sus flujos basándose en datos de uso reales.

Avanzado: soporte multiidioma

Si sus clientes hablan varios idiomas, su chatbot debería gestionarlo. Hay dos enfoques:

Detección de idioma

Analice el mensaje entrante para detectar el idioma y responda en el mismo idioma. Para bots basados en reglas, mantenga conjuntos de palabras clave separados para cada idioma. Para bots con IA, instruya al modelo para que responda en el idioma detectado.

Selección de idioma

Inicie la conversación pidiendo al cliente que seleccione su idioma: "Responda 1 para español, 2 para árabe, 3 para inglés." Es más sencillo de implementar y más fiable que la detección automática.

Nuestra API admite Unicode, por lo que los mensajes en árabe, hebreo, hindi, chino y cualquier otra escritura funcionan perfectamente. El texto de derecha a izquierda lo gestiona el propio cliente de WhatsApp.

Integración con modelos de IA

Los chatbots más potentes utilizan grandes modelos de lenguaje para generar respuestas. Así se integran los modelos de IA más populares:

OpenAI (GPT-4)

Envíe el mensaje entrante de WhatsApp a la API de OpenAI con un prompt de sistema que describa su negocio y cómo debe responder el bot. Pase el historial de la conversación como contexto. Devuelva la respuesta de la IA al cliente mediante nuestra API.

Claude (Anthropic)

Similar a la integración con OpenAI. Claude destaca en conversaciones matizadas y en el seguimiento de instrucciones complejas. Utilice la API de Messages con un prompt de sistema adaptado a su caso de uso.

Modelos locales

Para las empresas que necesitan privacidad de datos, ejecute un LLM local (como Llama o Mistral) en sus propios servidores. El patrón de integración es el mismo: recibir el mensaje, enviarlo a su modelo local y devolver la respuesta.

Consideraciones de coste: los bots con IA cuestan más por conversación que los basados en reglas, pero gestionan un abanico mucho más amplio de consultas. Empiece con reglas para las 20 consultas más frecuentes y añada IA para la cola larga.