WhatsApp AgentKit

Construir bot de WhatsApp con IA solía requerir 2-4 semanas de trabajo: API de Meta, hosting, webhooks, mantenimiento. WhatsApp AgentKit baja eso a 30 minutos. Vos respondés preguntas sobre tu negocio. Claude Code escribe todo el código por vos. Al final tenés agente conectado a WhatsApp Business respondiendo solo.

Esta nota cubre el setup, los 5 patterns de bot más útiles para negocios, y los gotchas de WhatsApp Business API que la mayoría descubre tarde.

Qué es WhatsApp AgentKit

Es framework open-source que combina:

• Conexión a WhatsApp Business API (via Meta Cloud API o Twilio).
• Claude por dentro para razonar respuestas.
• Templates de bots comunes (atención cliente, agendamiento, lead capture).
• Wizard interactivo que te entrevista y genera código.

El resultado: en 30 minutos pasás de "no tengo nada" a "bot funcionando".

Setup en 30 minutos

Minuto 0-5: requisitos previos

Necesitás:

• Cuenta Meta Business + WhatsApp Business API activa, o cuenta Twilio.
• Número de teléfono dedicado para el bot.
• Tu plan de Claude (Pro o superior).
• Node.js instalado.

Si no tenés WhatsApp Business API:

• Meta Cloud API: gratis para inicio, $0.005-0.03 por mensaje según país.
• Twilio: $0.005 por mensaje + $1/mes por número. Más simple para empezar.

Minuto 5-10: clonar y arrancar

git clone https://github.com/community/whatsapp-agentkit
cd whatsapp-agentkit
npm install
npx agentkit wizard

Minuto 10-25: el wizard te entrevista

Claude Code (via el wizard) te hace preguntas:

1. ¿Qué hace tu negocio?
2. ¿Quién es tu cliente típico?
3. ¿Qué consultas frecuentes recibís hoy?
4. ¿Qué horario atendés humano y cuándo el bot tiene que tomar?
5. ¿En qué casos el bot debe escalar a humano?
6. ¿Tenés FAQ o doc para entrenarlo?
7. ¿Qué tono querés (formal, casual, humorístico)?
8. ¿Hay tareas que el bot puede ejecutar (agendar, enviar info, calcular precio)?
9. ¿Manejás múltiples idiomas?
10. ¿Cómo se conecta a tu CRM/sistema actual?

Cuanto más detalladas tus respuestas, mejor el bot que sale.

Minuto 25-30: deploy

Una vez completado el wizard:

npx agentkit deploy

Genera todo el código, lo deploya (Vercel, Railway o Fly según preferencia), configura webhook con WhatsApp.

Probás mandándote un mensaje al número. El bot responde.

Los 5 patterns de bot más útiles

Pattern 1: atención al cliente con escalamiento

Caso típico: e-commerce, SaaS, servicios.

• Bot responde FAQ comunes 24/7.
• Si la consulta es compleja o pide vendedor, marca como "escalar".
• Humano recibe notificación y toma desde donde el bot dejó.

Configuración:

bot:
  faq_source: ./docs/faq.md
  handoff_triggers:
    - "quiero hablar con alguien"
    - "vendedor"
    - "queja"
  handoff_destination:
    type: whatsapp_human
    number: "+541112345678"

Pattern 2: agendamiento automático

Caso típico: consultorios, peluquerías, servicios profesionales.

• Cliente: "quiero turno para mañana".
• Bot: consulta calendar disponible, propone 3 opciones.
• Cliente elige.
• Bot reserva, manda confirmación.

Stack:

• WhatsApp AgentKit.
• Google Calendar MCP.
• Logic para reservar y bloquear slots.

Pattern 3: lead capture y qualification

Caso típico: B2B con leads inbound.

• Lead llega desde Meta Ads / web.
• Bot hace 5-8 preguntas (rubro, tamaño, problema, urgencia, presupuesto).
• Genera score.
• Leads calientes → notificación inmediata a vendedor.
• Leads tibios → secuencia de nurturing.

Pattern 4: información sobre productos

Caso típico: retail, vehículos, propiedades.

• Cliente: "tienen el modelo X disponible?"
• Bot: consulta stock en sistema, responde con disponibilidad + precio.
• Si interesa: bot envía link de compra o agenda visita.

Conexiones requeridas: WhatsApp + Shopify/inventory system.

Pattern 5: recepcionista de llamadas (alternativa)

Caso típico: negocios donde no quieren llamadas pero sí WhatsApp.

• Llaman al teléfono del negocio.
• Saluda IVR: "Para chat con asistente, mandanos WhatsApp al mismo número".
• Conversación sigue por WhatsApp.

Reduce 80% del volumen de llamadas, mantiene calidad de atención.

Setup específico: e-commerce con Shopify

Ejemplo concreto end-to-end:

Configuración del bot

Wizard answers:
- Negocio: tienda de zapatillas online (Shopify).
- Cliente típico: jóvenes 18-35, compran online.
- Consultas frecuentes: stock, talles, envío, devoluciones.
- Horarios: 24/7 bot, escalamiento si pide humano.
- FAQ: docs/faq.md (que tenés escrita).
- Tono: casual, joven, usa pocos emojis.
- Tareas: consultar stock, generar link de compra, dar tracking de envío.
- Idiomas: español argentino primario.
- Integración: Shopify API + base de FAQs.

Lo que el bot puede hacer

Cliente: "tenés Nike Air Max en talle 42?"

Bot:
1. Llama Shopify API: consulta stock de "Nike Air Max" talle 42.
2. Responde: "Sí! Tenemos 3 unidades en color blanco y 1 en negro. 
   ¿Querés que te mande el link para comprar?"
3. Si dice sí: genera link directo al producto.

Cliente: "cuándo llega si compro ahora?"

Bot:
1. Pide código postal.
2. Calcula con tabla de envíos.
3. Responde: "Llega entre el 18 y 20 de mayo. ¿Procedés?".

Setup técnico

Conexiones:
- WhatsApp Business API (Meta Cloud).
- Shopify Admin API (read products, read inventory).
- Tu FAQ markdown.

Hosting: Vercel functions (serverless).
Estimated cost: $5-30/mes según volumen.

Costos detallados

Mensajes WhatsApp

Meta cobra por "conversation" (24h ventana):

• Iniciada por usuario: gratis las primeras 1000/mes, después $0.005-0.05.
• Iniciada por business: $0.01-0.07 según país.

Para Argentina, conversation user-initiated es ~$0.005 (medio centavo).

Hosting

• Vercel functions: free tier alcanza para 50-200k mensajes.
• Railway: $5/mes inicial.

Tu Claude

Cada conversación llama a Claude (a través de tu plan). Para 500 conversations/día con respuestas razonables, gastás 100-300k tokens/día.

Con plan Pro ($20), te alcanza para 30-60k conversations/mes.

Total

Para negocio mediano con 5000 conversations/mes:

• WhatsApp: $25.
• Hosting: $5.
• Claude: $20.
• Total: ~$50/mes.

Sin bot, contratar persona para atender vía WhatsApp 24/7 cuesta varios miles. Diferencia abismal.

Gotchas

Gotcha 1: ventana de 24 horas

WhatsApp tiene regla: si un usuario inicia conversación, podés responder gratis dentro de 24h. Después tenés que mandar template aprobado (template messages cuestan más y requieren aprobación previa de Meta).

Implicancia: si tu bot recibe consulta y vas a tardar 30+ horas en responder, vas a tener que mandar template.

Gotcha 2: templates necesitan aprobación

Para mensajes "business-initiated" (vos arrancando conversación, ej: notificación de pedido), Meta requiere templates pre-aprobados. Aprobación tarda 1-3 días business.

Solución: aprobar templates comunes (welcome, order confirmation, shipping update, etc.) desde el día 1.

Gotcha 3: Meta puede pausar tu número

Si los usuarios reportan tu número como spam, Meta lo pausa (temporal o permanente). Implicancia:

• No envíes mensajes proactivos a quien no opt-in.
• Configurá opción de "no recibir más" en cada conversación.
• Mantené calidad alta de mensajes.

Gotcha 4: el bot puede ofender

Sin guardrails, Claude puede responder cosas inapropiadas si el usuario lo provoca. Configurá guardrails:

guardrails:
  blocked_topics: [politica, religion, contenido_adulto]
  fallback_response: "No puedo ayudarte con eso. ¿Hay algo sobre nuestros productos?"

Gotcha 5: hay tareas que NO conviene automatizar

• Quejas serias: mejor humano.
• Negociaciones de precio: mejor humano.
• Devoluciones complejas: humano.
• Bug reports técnicos: humano para escalación.

Bot maneja el 80% rutinario. El 20% que requiere criterio, humano.

Mantenimiento

Después del setup inicial, mantener un bot toma 1-2 horas/semana:

• Reviewar conversaciones y detectar fallos.
• Actualizar FAQ cuando aparecen preguntas nuevas.
• Ajustar tonos según feedback de clientes.
• Aprobar templates nuevos en Meta cuando hace falta.

Mucho menos que tener equipo de atención humano.

Conclusión

WhatsApp AgentKit es lo más cerca de "tu propio empleado virtual de atención" sin contratar nadie. Para negocios con volumen moderado a alto de consultas via WhatsApp, paga el setup en 1-2 meses.

Si todavía atendés WhatsApp manualmente y tu volumen pasa de 50 mensajes diarios, este es tu próximo proyecto del fin de semana. 30 minutos de setup, ROI sostenido por meses.

Tags: whatsapp, agente, claude-code, automatización, negocio, deploy