Cómo crear un bot de WhatsApp inteligente en hebreo · La guía visual completa.

Piensen en su negocio dentro de una semana. Un cliente potencial envía un mensaje por WhatsApp a las 2 de la madrugada, recibe respuesta en segundos y agenda una reunión de Zoom en su calendario sin que ustedes estuvieran despiertos. Esto no es un sueño, es un proceso de 30 minutos. Todo con la ayuda de 5 herramientas gratuitas hasta generosas que son el nuevo estándar para construir agentes: Kapso (número de WhatsApp aprobado por Meta), Maton (conexión al calendario y Zoom), Google AI Studio (cerebro Gemini), Claude Code (el programador que arma todo) y Vercel (despliegue en la nube). En la sesión 3 del taller de Claude Code creamos un bot así en vivo, desde cero. Esta guía es una congelación de todo lo que hicimos, con 34 capturas de pantalla ordenadas. Sigan paso a paso, y al final tendrán un bot de WhatsApp profesional que trabaja para ustedes 24/7.

Qué tendrán al final de la guía

• Un número de WhatsApp comercial aprobado por Meta · Sin comprar una SIM, sin conectar su número personal
• Un bot que responde a los clientes en hebreo con su voz, 24/7
• Integración automática con Google Calendar · Cada reunión que el bot cierra entra al calendario
• Integración con Zoom · Se crea un enlace de reunión y se envía al cliente automáticamente
• Despliegue en la nube Vercel · El bot funciona incluso cuando su ordenador está apagado
• Control total: es posible actualizar el comportamiento, añadir capacidades, cambiar de modelo en cualquier momento

Qué se necesita antes de empezar

Si aún no tienen Claude Code, hay instrucciones de instalación completas + permisos + CLAUDE.md personal en la página del taller: ai-masterclub.com/claude-workshop

Paso 1 · Registro en Kapso y creación de un número de WhatsApp

✅ Terminaron el paso 1. Tienen un número de WhatsApp comercial aprobado. Hasta ahora han invertido entre 5 y 10 minutos.

Paso 2 · Maton · Conecta el bot al calendario y a Zoom

Paso 3 · Recopilación de todas las API keys

3a · API key de Kapso

3b · API key de Google AI Studio (Gemini)

💳 El uso de Gemini es muy barato, por unos pocos céntimos. Pero cuanto más funcione el bot, mayor será el coste. Conviene configurar un límite de gasto mensual en la cuenta de Google Cloud para no llevarse sorpresas.

✅ Ahora tenemos 3 claves guardadas a un lado · Kapso, Maton (ya guardada en el paso 18) y Gemini. Además · el número de Kapso que creamos en el paso 1 y nuestro número personal (para verificación de propiedad). Todo esto va para Claude en el siguiente paso.

Paso 4 · Entrar a Claude Code · Crear una nueva carpeta

El club AI Master les abre la puerta: una sesión en vivo cada semana, grabaciones y comunidad. 47 NIS al mes, cancelación en cualquier momento.

Paso 5 · El skill del sitio del taller · La magia

Pegar el skill en Claude · Junto con las 3 claves

El prompt completo para pegar en Claude · Después de que el skill haya sido instalado

Construye para mí un agente de WhatsApp. Ya creé un número en Kapso, conecté herramientas en Maton y creé una API key en Google AI Studio. Aquí están las claves: • KAPSO_API_KEY: [Pegar la clave de Kapso del paso 22] • MATON_API_KEY: [Pegar la clave de Maton del paso 18] • GEMINI_API_KEY: [Pegar la clave de Gemini del paso 29] • Número de Kapso: [El número estadounidense que crearon en el paso 1] • Mi número personal: [Su número, solo para verificación de propiedad] Usa el skill whatsapp-agent que ya instalé. Trabaja en Plan Mode primero, muéstrame el plan, y después de que lo apruebe procede a la construcción y despliegue en Vercel.

💡 Claude reconoce automáticamente el skill que instalaron y carga las instrucciones. Tomará las 3 claves, creará un proyecto Next.js, conectará los webhooks, desplegará en Vercel y conectará la URL del webhook de vuelta a Kapso · todo por sí solo. Ustedes solo aprueban el plan cuando él lo presenta.

🎉 Terminaron. Tienen un bot de WhatsApp inteligente, vivo y funcionando 24/7. Envien un mensaje al número de Kapso que crearon · el agente responderá en hebreo, agendará reuniones de Zoom y creará eventos en el calendario de Google. Es posible dar el número a sus clientes.

Qué hacer después de que el bot esté vivo

5 cosas que hacer en la primera semana

• **Enviar un primer mensaje a ustedes mismos** · y comprobar que responde como desean. Si el tono no es el correcto, decirle a Claude 'refina el system prompt en el archivo X. Quiero un tono más/menos _____'
• **Definir a quién no responder** · en el system prompt decirle al bot 'si el número X o Y envía un mensaje, no respondas'. Así no recibirán mensajes automáticos su esposa o amigos
• **Limitar las horas de actividad** · es posible decirle al bot 'entre las 22:00 y las 08:00 responde solo con un mensaje automático: responderé por la mañana' si desean que quede claro que es un bot
• **Añadir capacidades** · si hay una tarea repetitiva que el bot no hace (envío de presupuestos, seguimiento a 72 horas), decirle a Claude 'añade al bot esta capacidad', y él actualiza el código y despliega de nuevo
• **Monitorear las conversaciones** · en Maton es posible ver un registro de todas las conversaciones que gestionó el bot. Vale la pena revisarlas una vez a la semana para ver dónde se equivoca

💡 Ahorro de tokens: un agente que trabaja 24/7 puede consumir muchos créditos. Para ahorrar · 1) usar Gemini Flash en lugar de Pro para la mayoría de consultas (5 veces más barato), 2) poner memoria en Supabase para que el bot no repita preguntas, 3) configurar un máximo de 1500 tokens por respuesta.

Problemas comunes + soluciones

Solución rápida para los 3 problemas más frecuentes

• **El Webhook no recibe mensajes** · verificar en Kapso que la URL del Webhook sea correcta (es la URL de Vercel + /api/webhook). Decirle a Claude 'revisa el webhook en Kapso y arrglalo si es necesario'
• **Gemini responde en inglés sin haberlo pedido** · en el system prompt del archivo del proyecto, añadir 'responde siempre en hebreo, incluso si el usuario escribe en inglés o mezcla idiomas'
• **El calendario de Google no recibe eventos** · comprobar en Maton que los permisos del calendario sigan activos (a veces Google cancela los permisos después de 7 días si hay algún problema). Abrir Maton, volver a conectar y aprobar de nuevo todos los permisos

🚀 **¿Desean acompañamiento durante el camino?** En el club AI Master hay un grupo de WhatsApp activo de personas que construyen bots exactamente como el suyo. Cualquier problema con el que se topan, alguien ya lo resolvió. Únanse, compartan el agente que construyeron y obtengan ideas para agentes adicionales que se pueden crear para su negocio.

¿Cuál es el siguiente paso?

Preguntas frecuentes

Kapso · número estadounidense gratuito, y también un plan básico para 1000 mensajes al mes gratis. Maton · hasta 100 acciones al mes gratis (Zoom, calendario, correo). Gemini · después de conectar una tarjeta de crédito, el pago es por uso real. En la práctica, miles de mensajes al mes cuestan unos pocos séquels. Vercel · totalmente gratuito para proyectos personales. En total, si el bot recibe hasta 100 mensajes al día, pagarán menos de 50 séquels al mes.

Sí. En Kapso, en lugar de elegir Digital Numbers, se elige Bring your own number. Se necesita una SIM física (se puede comprar una prepago por 30 NIS) y se realiza el mismo proceso de aprobación ante Meta. El bot funcionará exactamente igual, solo que con un número israelí. La ventaja · más profesional para negocios israelíes. La desventaja · otro paso de compra de la SIM y su activación.

Sí. Todo lo que hice en esta guía lo pueden hacer ustedes. El secreto es que Claude es el programador. Ustedes solo lo guían · 'constrúyeme un bot de WhatsApp', 'añade la capacidad X', 'corrige el error que vi'. Si algo no funciona, le dicen a Claude 'aquí está el fallo, arrglalo'. No hay necesidad de leer el código ni de entenderlo. Traten a Claude como a un programador senior que trabaja para ustedes.

Exactamente el mismo proceso. La diferencia está solo en el prompt que le dan a Claude en el paso 4. En lugar de pedir 'un bot que coordine reuniones', pedirán 'un bot que responda preguntas frecuentes sobre mis productos', o 'un bot que genere presupuestos según la plantilla X'. Todo lo demás es idéntico · Kapso, Maton, Gemini, Vercel. Los agentes son diferentes en Claude, no en la infraestructura.

Sí, con total facilidad. Le dicen a Claude 'cambia el modelo de Gemini a Claude', y él actualiza el código, solicita la nueva API key (de Anthropic o OpenAI) y vuelve a desplegar. Más aún · es incluso posible ejecutar el agente con 2 modelos en paralelo y elegir cuál funciona mejor para cada tipo de pregunta. Esa es toda la belleza de trabajar con Claude Code · la estructura es completamente flexible.

💪 ¿Están listos para construir más agentes?

📎 Versión resumida de la guía · Sin imágenes

Piénsenlo: cada cliente potencial que llega a ustedes por WhatsApp a las 2 de la madrugada recibe una respuesta en segundos. No se conforma con una respuesta, sino que realmente coordina con él una reunión de Zoom, crea un evento en su calendario de Google y le envía un enlace para conectarse. Esto no es el futuro. Es el presente. En esta guía les mostraré cómo construir por su cuenta un agente de WhatsApp inteligente en hebreo, sin escribir una sola línea de código. El skill que creé hace todo el trabajo difícil: crea un proyecto Next.js, conecta todas las APIs, despliega en Vercel y configura los webhooks. Ustedes solo proporcionan 3 claves API y presionan Enter.

Qué hace el agente después de estar vivo

• Recibe mensajes de WhatsApp a través de Kapso (WhatsApp Business API)
• Responde en hebreo con tu propia voz, mediante un system prompt que tú controlas
• Coordina reuniones en Zoom y crea un evento en Google Calendar automáticamente
• Envía al cliente un enlace de Zoom listo más la invitación al calendario
• Recuerda todo el historial de la conversación para no repetirse
• Opera 24/7 sin mantenimiento, sobre una infraestructura en Vercel casi totalmente gratuita

La instalación: un solo comando en la terminal

El comando para instalar el skill (para copiar a la terminal)

mkdir -p ~/.claude/skills/whatsapp-agent && curl -sL https://www.ai-masterclub.com/skills/whatsapp-agent.md -o ~/.claude/skills/whatsapp-agent/SKILL.md && echo '✅ El skill se ha instalado. Abre Claude Code y escribe: Constrúyeme un agente de WhatsApp'

Este skill también se publica en GitHub con todos los archivos y plantillas: github.com/amichaiai/whatsapp-agent. La versión en el sitio web es la versión corta (solo SKILL.md); para una instalación completa con Templates y References, se recomienda hacer git clone del repositorio.

Cómo utilizar el skill después de la instalación

Lo que el skill hace por ti (8 pasos automáticos)

• Verifica que tengas instalados node, npm y Vercel CLI
• Crea una carpeta de proyecto con Next.js 15 y TypeScript listo para usar
• Extrae los IDs necesarios de Kapso (phone_number_id y otros)
• Conecta Maton con Zoom y Google Calendar a través de OAuth
• Sube todas las variables de entorno (ENV variables) a Vercel mediante REST API (más rápido que CLI)
• Realiza el primer despliegue a producción
• Crea un webhook en Kapso que apunta a tu nueva URL
• Valida de extremo a extremo con una prueba de estado y una prueba del agente

Es obligatorio desactivar Vercel Deployment Protection en el proyecto (de lo contrario, Kapso recibirá un error 401 y no podrá llamar al webhook). El skill explica dónde desactivarlo en 30 segundos. Es una sola configuración en Settings → Deployment Protection → Disabled.

Quién necesita este agente

Preguntas adicionales

Maton es compatible con todo Google Workspace, Slack, HubSpot, Salesforce, Notion, Linear y más. El skill agrega las herramientas básicas automáticamente, y añadir más es sencillo: le escribes a Claude Code 'agrega al agente la capacidad de enviar correos', y actualizará el código.

Gemini admite más de 50 idiomas. El idioma predeterminado en el skill es el hebreo, pero puedes actualizar el system prompt (en lib/prompts.ts) para que responda según el idioma del cliente. Es una actualización de 3 líneas.

En el club AI Master se realiza una sesión semanal en vivo para revisar este tipo de casos en conjunto. Además, hay una comunidad activa de dueños de negocios que ya han construido agentes y comparten qué funciona y qué no. Puedes hacer preguntas en el grupo silencioso de WhatsApp.

Esta guía no es teórica. Construí este agente para mí mismo, está funcionando y respondiendo a los clientes, y eso es lo que me libera para trabajar en cosas más importantes. Cuando lo construyes para ti, te liberas a ti mismo.