Monta un agente de IA en WhatsApp con Claude Code

Lo que necesitas (enlaces)

Un chatbot habla. Un agente actúa: responde con los datos de tu negocio, recuerda la conversación y reserva la cita en tu agenda. Aquí tienes los enlaces y el prompt para montarlo con Claude Code.

Para que no haya sorpresas: en unos 30 minutos tienes una versión de prueba funcionando con el número de prueba de Meta. Para usarlo con clientes reales necesitarás tu propio número, verificar tu empresa en Meta y un servidor. Eso lleva más tiempo, sobre todo por las esperas de Meta.

Paso 1 · El plan (el prompt para empezar)

Crea una carpeta nueva, abre Claude Code dentro y pega esto, cambiando lo que va entre corchetes:

Quiero montar un agente de IA para el WhatsApp de mi negocio. Antes de escribir ninguna línea de código, diseña la arquitectura y espera a que yo la apruebe.

MI NEGOCIO
- A qué me dedico: [ej. clínica dental en Valencia]
- Quiénes son mis clientes: [ej. familias y adultos de la zona]
- Qué tiene que resolver el agente: [ej. dudas de precios y horarios, y reservar citas]
- Qué puede hacer: [ej. consultar mi agenda, ofrecer horas y reservar]
- Qué NO puede hacer: [ej. dar diagnósticos ni descuentos]

REQUISITOS
1. WhatsApp con la Cloud API oficial de Meta: webhook para recibir mensajes y envío de respuestas.
2. El modelo, a través de OpenRouter (una sola API para cualquier modelo).
3. Memoria: guarda el historial reciente de cada número y envíalo al modelo con cada mensaje nuevo.
4. Conocimiento del negocio en un archivo aparte (servicios, precios, horarios, preguntas frecuentes, dirección, cómo se reservan las citas). Si algo no está ahí, el agente dice que lo consulta, no se lo inventa.
5. Herramienta de agenda con Cal.com: ver huecos libres, ofrecer horas, pedir nombre y teléfono y reservar.
6. Las claves (tokens y API keys) en un archivo .env que nunca se sube a GitHub.
7. Preparado para desplegarlo en un VPS.

Dame primero: la arquitectura, la lista de archivos, qué cuentas y claves necesito y en qué orden lo montamos.

Paso 2 · WhatsApp (Meta)

1. Entra en Meta for Developers y crea una app de tipo empresa.
2. Añade el producto WhatsApp. Meta te da un número de prueba y un token temporal.
3. Añade tu móvil como número de prueba para poder escribirle.
4. Configura el webhook: la dirección de tu sistema a la que Meta avisa cada vez que alguien te escribe. Claude Code te dice cuál es y cómo verificarla.

El token temporal caduca a las 24 horas. Para algo estable, crea un usuario del sistema con token permanente. Pídele a Claude Code que te guíe.

Paso 3 · El modelo (OpenRouter)

Crea una cuenta en OpenRouter, saca tu API key y pégala en el .env. Desde ahí puedes usar Claude, GPT, Gemini, Llama, Mistral… y cambiar de modelo sin tocar el código. Pagas por uso.

Paso 4 · Memoria

Sin memoria, cada mensaje empieza de cero. El agente guarda los últimos mensajes de cada cliente y se los manda al modelo con cada mensaje nuevo. Para empezar, con una base de datos sencilla (por ejemplo, SQLite) es suficiente.

Paso 5 · Tu negocio

Rellena el archivo de conocimiento: servicios, precios, horarios, preguntas frecuentes, dirección y cómo se reservan las citas. Cuanto más completo, menos se equivoca.

Paso 6 · Herramientas (Cal.com)

Crea tu cuenta en Cal.com, configura tu tipo de cita y saca la API key. Con eso el agente ve tu agenda, ofrece horas, pide los datos del cliente y reserva la cita. Esa es la diferencia entre un chatbot y un agente.

Paso 7 · Intenta romperlo

Escríbele desde tu móvil:

• preguntas normales de precios y horarios;
• una reserva completa;
• mensajes raros, faltas de ortografía, audios o preguntas que no tienen nada que ver.

Si falla, dile a Claude Code qué ha pasado, corrige el prompt o el código y vuelve a probar.

Paso 8 · Súbelo a un VPS

Tu portátil no es un servidor: si lo apagas, el agente se apaga. Contrata un VPS, pídele a Claude Code los pasos para desplegarlo (con HTTPS, que Meta lo exige para el webhook) y deja el agente funcionando 24/7.

Antes de usarlo con clientes reales

• Número propio y verificación de empresa en Meta: necesarios para salir del modo de prueba.
• Costes de WhatsApp: responder a un cliente dentro de las 24 horas desde su último mensaje es gratis o casi. Los mensajes que inicias tú (plantillas) se pagan. Revisa las tarifas actuales de Meta para tu país.
• Protección de datos: guardas conversaciones de clientes. Avisa en tu política de privacidad y no guardes más de lo necesario.
• Que siempre pueda pasar a una persona: configura una frase como "quiero hablar con alguien" para que te avise a ti.