Qué vas a montar

Un agente de Claude con su propio número de WhatsApp que contesta, consulta la agenda y reserva citas solo. Se hace en una tarde y el plan gratis da para probarlo con clientes reales.

Lo que necesitas:

Una cuenta en Kapso, la plataforma que te da acceso a la WhatsApp Cloud API oficial de Meta. El plan gratis vale.
Claude Code instalado en tu ordenador.
Node.js 18 o superior.
Un sitio donde alojar un pequeño servidor para el webhook (Vercel, Railway, Render o tu VPS).

Importante: Kapso es un servicio de terceros, no de Anthropic ni de EDSO. Revisa sus condiciones y las de Meta antes de usarlo con clientes.

1) Consigue el número (2 minutos)

Crea tu cuenta en app.kapso.ai y elige cómo conectar el número. No hace falta esperar la verificación de Meta si usas el número de Kapso.

Opción	Para quién	Qué te da
Número de Kapso (recomendado)	Quieres probar ya	Número de EE. UU. al registrarte, sin SIM ni códigos, activo en unos 2 minutos
Tu propia SIM	Quieres un número local (+34, etc.)	Cualquier número de cualquier país, verificación una sola vez, acceso completo a la API
App WhatsApp Business	Ya atiendes clientes con ese número	Los mensajes se sincronizan, no migras nada

Cuando lo tengas, copia tu API key desde el panel de Kapso. La usarás en el paso 3 como KAPSO_API_KEY.

2) Pásale los docs a Claude

Instala las skills de Kapso en la carpeta de tu proyecto. Así Claude Code conoce la API sin que tú te leas la documentación.

npx skills add gokapso/agent-skills
claude

Se añaden tres skills: integrate-whatsapp (conexión, webhooks, envío de mensajes y plantillas, Flows), automate-whatsapp (flujos, agentes, funciones) y observe-whatsapp (logs, errores de entrega, inspección de webhooks).

Dentro de Claude Code, pega este prompt y cambia lo que va entre corchetes:

Usa las skills de Kapso para montar la integración de WhatsApp de este proyecto:

1. Un endpoint de webhook que reciba los mensajes entrantes y verifique la firma.
2. Cuando llegue un mensaje, pásalo a un agente que responda como asistente de [NOMBRE DEL NEGOCIO].
   El agente puede consultar la disponibilidad en [Google Calendar / mi sistema de reservas] y crear la cita.
3. Responde por WhatsApp con @kapso/whatsapp-cloud-api usando KAPSO_API_KEY del .env.
4. Respeta la ventana de 24 horas: fuera de ella, usa solo plantillas aprobadas.
5. Añade un README con cómo desplegarlo y cómo probarlo en el sandbox de Kapso.

Claude Code escribe el envío, el webhook y el agente. Tú revisas y despliegas.

3) Enviar son 11 líneas

Si prefieres verlo a mano, esto es todo el envío. Por debajo es la Cloud API oficial.

npm install @kapso/whatsapp-cloud-api

import { WhatsAppClient } from '@kapso/whatsapp-cloud-api';

const client = new WhatsAppClient({
  baseUrl: 'https://api.kapso.ai/meta/whatsapp',
  kapsoApiKey: process.env.KAPSO_API_KEY!
});

await client.messages.sendText({
  to: '34600123456',
  body: '¡Hola! ¿En qué te puedo ayudar?',
});

Para recibir, configura en el panel de Kapso la URL de tu webhook. Cada mensaje entrante llega como una petición POST a tu servidor. Ahí se lo pasas a Claude y respondes con sendText.

Extras que marcan la diferencia

Formularios dentro del chat (Flows). Una mini-app en WhatsApp para reservas, catálogos o captación de leads. El cliente no instala nada. Pídele a Claude Code: “crea un Flow de reserva con nombre, servicio y hora”.
Sandbox para probar. Prueba el agente antes de exponerlo a clientes reales.
Registro de cada petición. Tiempos, payload y respuesta de cada envío y cada webhook. Cuando un mensaje no llega, mira aquí primero; es donde fallan casi todos los montajes de WhatsApp.

Antes de lanzarlo

Es la Cloud API oficial a través de un Meta Business Partner, no un bot no oficial.
Se aplica la ventana de 24 horas: puedes responder libremente durante 24 h desde el último mensaje del cliente. Fuera de ella, solo plantillas aprobadas por Meta.
Consigue el opt-in (consentimiento) antes de escribir a nadie por primera vez.
Revisa las tarifas de Meta por conversación. Van aparte y Kapso no les añade margen.

Planes de Kapso (precios):

Plan	Precio	Mensajes al mes	Números incluidos
Free	0 $	2.000	1
Pro	25 $/mes	100.000 (luego 0,002 $/mensaje)	3
Platform	299 $/mes	1.000.000 (luego 0,001 $/mensaje)	50

Con los 2.000 mensajes gratis te sobra para validar la idea con tus primeros clientes.

Claude en WhatsApp: guía paso a paso