Cómo crear tu agente de WhatsApp con Claude paso a paso

Crear un agente de WhatsApp con Claude ya no es una idea reservada para equipos grandes. Hoy puedes montar un asistente funcional para ventas, soporte, captación o seguimiento si conectas tres piezas bien resueltas: WhatsApp Business Platform, un backend con webhook y la API de Claude.

En esta guía vas a ver el proceso completo, sin relleno y con enfoque práctico: qué necesitas, cómo diseñar el flujo, cómo conectar WhatsApp con Claude y qué debes revisar antes de poner tu agente en producción.

Qué vas a construir exactamente

El objetivo es simple: cuando un usuario escriba a tu número de WhatsApp, tu sistema recibirá ese mensaje, lo enviará a Claude con el contexto correcto y devolverá una respuesta útil, segura y alineada con tu negocio.

El flujo básico es este:

1. El cliente envía un mensaje por WhatsApp.
2. WhatsApp Business Platform envía el evento a tu webhook.
3. Tu backend valida el mensaje, recupera contexto y reglas del negocio.
4. Envía la consulta a Claude mediante la Messages API.
5. Recibe la respuesta de Claude.
6. La devuelve al usuario por WhatsApp.
7. Guarda el intercambio para mantener continuidad.

Qué necesitas antes de empezar

Si todavía no has trabajado con Claude, te conviene revisar primero nuestra guía sobre Claude Code y sus casos de uso para entender mejor cómo estructurar asistentes realmente útiles.

Paso 1: define el trabajo de tu agente antes de tocar código

El error más común es conectar la API primero y pensar el agente después. Haz lo contrario.

Antes de programar, responde estas preguntas:

• ¿El agente atenderá soporte, ventas, reservas, leads o seguimiento?
• ¿Qué sí puede responder solo?
• ¿Qué casos debe escalar a una persona?
• ¿Qué datos necesita para responder bien?
• ¿Qué mensajes nunca debe inventar?

Un agente de WhatsApp funciona mejor cuando tiene un alcance claro. Por ejemplo:

• Bien definido: responder preguntas frecuentes, calificar leads, tomar datos y derivar.
• Mal definido: atender cualquier cosa, improvisar políticas y cerrar ventas complejas sin contexto.

Paso 2: crea tu acceso a Claude

Anthropic ofrece acceso programático a Claude a través de su API. La pieza principal para este caso es la Messages API, que te permite enviar mensajes estructurados y recibir respuestas del modelo.

Necesitarás:

• una cuenta en Anthropic
• tu API key
• definir el modelo que usarás
• configurar el encabezado anthropic-version

En la práctica, tu backend hará una llamada HTTP al endpoint de mensajes con un system prompt claro y el historial relevante del usuario.

POST /v1/messages
Headers:
- x-api-key: TU_API_KEY
- anthropic-version: 2023-06-01
- content-type: application/json

La recomendación práctica es empezar con un solo caso de uso, medir respuestas y recién después ampliar capacidades.

Paso 3: activa WhatsApp Business Platform

Para usar WhatsApp como canal real necesitas la plataforma oficial de negocio de WhatsApp. Ahí obtendrás:

• tu número conectado
• credenciales de acceso
• Phone Number ID
• Webhook verification token
• eventos entrantes y estados de mensajes

Tu backend debe exponer al menos dos rutas:

• GET /webhook para verificación inicial
• POST /webhook para recibir mensajes entrantes

Si no quieres trabajar directo con la capa técnica de Meta, puedes usar un proveedor como Twilio u otro BSP, pero la lógica del agente será prácticamente la misma: webhook entrante, llamada a Claude y respuesta saliente.

Paso 4: crea un backend simple y estable

Puedes hacerlo con Node.js, Python o el stack que te resulte más cómodo. Lo importante es la estructura, no el lenguaje.

Una versión mínima de tu backend debería tener estos módulos:

• lector del webhook de WhatsApp
• validador de eventos
• gestor de usuarios y sesiones
• cliente de Claude
• constructor del prompt
• módulo para responder por WhatsApp
• registro de logs y errores

La lógica central se parece a esto:

1. Recibir mensaje
2. Identificar usuario
3. Recuperar historial relevante
4. Construir prompt del sistema + contexto
5. Enviar a Claude
6. Procesar respuesta
7. Enviar respuesta por WhatsApp
8. Guardar interacción

Paso 5: diseña bien el prompt del agente

Tu agente no mejora solo por usar Claude. Mejora cuando recibe instrucciones claras.

Un buen prompt del sistema debería incluir:

• rol del agente
• tipo de negocio
• objetivo principal
• tono de respuesta
• límites y exclusiones
• criterios de escalamiento
• estructura ideal de respuesta

Ejemplo práctico:

Eres un agente de WhatsApp para una empresa que vende cursos de IA.
Tu trabajo es responder dudas iniciales, detectar intención de compra,
pedir datos mínimos y recomendar el producto correcto.
Nunca inventes precios, políticas ni fechas.
Si falta información, dilo claramente.
Si el caso requiere revisión humana, indícalo y recoge los datos necesarios.

Esto evita dos problemas frecuentes: respuestas demasiado genéricas y promesas incorrectas.

Paso 6: añade memoria, pero con criterio

No necesitas mandar toda la conversación completa cada vez. Eso encarece el sistema y puede empeorar la calidad.

Lo recomendable es guardar:

• nombre del usuario
• última intención detectada
• estado del flujo
• resumen breve de la conversación
• datos entregados por el usuario

En vez de pasar 50 mensajes, puedes pasar un resumen útil y los últimos turnos recientes. Así reduces costo y mantienes coherencia.

Paso 7: responde por WhatsApp con reglas de negocio reales

No devuelvas a WhatsApp la salida de Claude sin revisar. Antes de enviar la respuesta conviene aplicar reglas simples:

• limitar longitud
• dividir respuestas muy largas
• filtrar contenido no permitido
• detectar si corresponde derivación humana
• adjuntar enlaces o recursos aprobados

Esto es importante porque WhatsApp es un canal rápido. Un mensaje brillante pero demasiado largo, ambiguo o poco accionable rinde peor que una respuesta breve y clara.

Paso 8: prueba escenarios reales antes de publicarlo

Antes de lanzar tu agente, prueba al menos estos casos:

• saludo inicial
• pregunta frecuente
• usuario molesto
• pregunta fuera de alcance
• pedido de precio o condiciones
• derivación a humano
• silencio del usuario y reanudación de contexto

Tu meta no es solo que responda. Tu meta es que responda bien, con consistencia y con límites claros.

Paso 9: ponlo en producción sin improvisar

Cuando ya funcione, revisa este checklist:

• webhook verificado
• logs de errores activados
• timeouts controlados
• reintentos definidos
• mensajes duplicados gestionados
• datos sensibles protegidos
• fallback humano configurado
• métricas de conversaciones, derivaciones y tiempos de respuesta

En producción, la estabilidad vale más que una respuesta espectacular aislada.

Errores comunes al crear un agente de WhatsApp con Claude

• No definir el alcance del agente: termina improvisando.
• No guardar estado: cada mensaje parece una conversación nueva.
• No poner límites al prompt: aumenta el riesgo de respuestas inventadas.
• No validar la salida antes de enviarla: expone errores evitables.
• No diseñar escalamiento humano: rompe la experiencia cuando aparece un caso sensible o complejo.

Arquitectura mínima recomendada

Si quieres empezar simple, esta es una arquitectura razonable:

• Canal: WhatsApp Business Platform
• Backend: Node.js con Express
• IA: Claude vía Messages API
• Memoria: PostgreSQL, Supabase o una base sencilla
• Hosting: Render, Railway, AWS o similar
• Monitorización: logs y alertas básicos

No necesitas montar un sistema enorme para validar el caso. Empieza por un flujo pequeño que ya aporte valor real.

Conclusión

Si te preguntas cómo crear tu agente de WhatsApp con Claude, la respuesta corta es esta: define bien el trabajo del agente, conecta WhatsApp con un webhook estable, usa Claude con un prompt sólido, guarda contexto útil y prueba cada flujo antes de ponerlo frente a clientes.

Lo importante no es solo que Claude responda por WhatsApp. Lo importante es que el sistema completo responda con criterio, continuidad y utilidad para el negocio.

Da el siguiente paso con Claude

Si quieres aprender a usar Claude con más criterio, mejores prompts y aplicaciones reales de trabajo, revisa el Curso completo de Claude. Te ayudará a pasar de usar la herramienta de forma básica a diseñar asistentes y flujos mucho más útiles para negocio, productividad y automatización.