Bot Para Whatsapp Github
Bastian Illezca
Fundador & CEO, Solo Leads
# Bot WhatsApp con GitHub: el stack honesto para 2026
**TL;DR: en 2026 un bot WhatsApp serio se monta sobre la Cloud API oficial de Meta + un modelo de lenguaje (GPT-4o o Claude 4.5) + base de conocimiento RAG + memoria + tool use.** El stack open-source con webhooks + GitHub Actions sirve para prototipos; producción seria exige BSP, plantillas pre-aprobadas y compliance Meta. Esta página explica la arquitectura completa, las trampas técnicas que ya pisamos y cómo lo resolvemos en Solo Leads con [Nara](/whatsapp-ia).
**Gerente comercial de Importadora Patagonia, un distribuidor B2B de insumos industriales.** Cinco vendedores manejan WhatsApp con compradores que piden cotizaciones con stock, plazos de despacho y orden de compra. Hilos cruzados, mismo cliente respondido por dos personas distintas, cotizaciones armadas a mano en planilla. El gerente buscaba ordenar el embudo, no reemplazar al equipo. El problema no era la falta de leads — era el caos en el embudo: cotizaciones armadas tres veces, hilos cruzados, vendedores pisándose. Solo Leads existe para resolver ese gap con marketing que se mide, no plantillas genéricas.
Qué pide hoy un bot WhatsApp técnico GitHub Actions / open source serio (no el de 2023)
Un bot WhatsApp con estándar 2026 se compone de cuatro capas trabajando juntas. Sácale cualquiera y el resultado se cae:
- **LLM (modelo de lenguaje)** como cerebro: GPT-4o, Claude 4.5 Sonnet, Gemini 2.0 o equivalentes open-source. Entiende frases mal escritas, contexto y emoción sin reglas codificadas. - **RAG (retrieval-augmented generation)**: base de conocimiento de tu negocio indexada como vectores. Cuando el cliente pregunta, el bot recupera fragmentos relevantes y responde con tus datos reales, no con generalidades. - **Memoria conversacional**: el bot recuerda lo que el cliente dijo hace 15 minutos o en la conversación anterior. Sabe que el comprador ya pidió cotización por 12 puestos y quedó esperando confirmación de stock. - **Tool use (function calling)**: el bot ejecuta acciones reales — agenda hora, genera link de pago, crea ticket en el CRM, consulta inventario, actualiza stock. Deja de ser un chatbot que solo conversa y se vuelve un agente que opera.
Stack técnico recomendado en 2026
- **WhatsApp Business Cloud API** (gratis hasta 1.000 conversaciones service-initiated al mes desde julio 2025, costo variable según país y categoría de plantilla). - **Webhooks** con verificación HMAC (Meta envía firma SHA-256 que debes validar con tu app secret). - **BSP (Business Solution Provider)** o conexión directa: para volúmenes pequeños conviene directo; sobre 5.000 conversaciones/mes un BSP serio (360dialog, Twilio, Infobip) baja el costo unitario y simplifica compliance. - **Plantillas pre-aprobadas por Meta** para mensajes service-initiated o marketing fuera de la ventana de 24 horas. - **Opt-in documentado** del cliente: requisito Meta + Ley 19.628 chilena.
Nara: nuestra IA conversacional entrenada con tu negocio
[Nara](/whatsapp-ia) es la operadora de IA que desplegamos en La Audición, el segundo Acto del Estudio de Solo Leads: el momento en que cada conversación entrante se atiende y se filtra. No es un wrapper sobre ChatGPT — es una capa con cuatro piezas integradas:
- **LLM como cerebro** (GPT-4o o Claude 4.5 Sonnet según latencia vs razonamiento). - **Conocimiento propio (RAG)**: tu catálogo, precios, políticas, scripts de objeción y casos resueltos indexados como vectores. - **Memoria conversacional**: recuerda lo que el cliente dijo hace 15 minutos o hace varias semanas en la conversación anterior. - **Tool use real**: agenda en Google Calendar, genera links de pago Khipu/Webpay/Mercado Pago, crea tickets, consulta inventario y deriva al humano correcto con resumen ya redactado.
Nara queda hablando como hablaría tu mejor vendedor, no como bot genérico. Marketing que se mide hasta el último mensaje.
Qué NO hace un bot bien hecho (anti-hype)
- **No reemplaza a un vendedor experimentado** en negociaciones complejas. En B2B sobre $5M la decisión sigue siendo humana; el bot prepara terreno. - **No aprende solo**. Necesita revisión semanal de conversaciones falladas y reentrenamiento del conocimiento base. Sin esa rutina, degrada en 8 a 12 semanas. - **No es plug-and-play**. Implementar bien las cuatro capas (LLM + RAG + memoria + tool use) toma entre 4 y 8 semanas según complejidad. - **No se justifica con volúmenes bajos**. Si recibes menos de 80 chats al mes, primero conviene resolver tráfico con [Meta Ads](/meta-ads) o [Lead Generation](/lead-generation). - **No reemplaza un CRM**. Es la capa conversacional encima de un [CRM bien estructurado](/crm-ia).
Cuánto cuesta hacerlo bien en 2026 (la respuesta honesta)
El costo real de un bot WhatsApp serio no está en la licencia de una herramienta — está en las cuatro capas bien implementadas. Lo que mueve la aguja: el costo por conversación de la Cloud API (varía por país y categoría de plantilla), la inferencia del LLM (cada mensaje procesado consume tokens), las semanas de entrenamiento del RAG con tu conocimiento real, y la mantención semanal que evita que el bot degrade. Si alguien te ofrece "WhatsApp con IA" por $99.000/mes, te está vendiendo una plantilla ManyChat con sticker de IA.
En el Estudio de Solo Leads no vendemos el bot como producto suelto ni publicamos menú de precios: Nara es una pieza de La Audición, un Acto dentro de un sistema comercial completo que parte en la captación y termina en el reporte mensual. Hacerlo serio cuesta lo que cuesta hacerlo serio — y por eso preferimos mostrarte el sistema completo antes que venderte una pieza aislada.
Preguntas frecuentes
¿Cuánto demora implementar esto bien? Entre 4 y 8 semanas según complejidad. Primera versión beta en 5 a 7 días hábiles tras el levantamiento inicial del negocio. Resultados sin humo: los primeros 30 días son entrenamiento y ajuste, no magia inmediata.
¿Necesito WhatsApp Business API o me sirve la app del celular? La app del celular sirve hasta 80-100 chats al mes y un solo usuario. Para multiagente, bot con IA o integración con CRM necesitas WhatsApp Business Cloud API. Es paso obligado y lo gestionamos como parte del setup.
¿Qué pasa si el bot responde mal a un cliente? Configuramos palabras gatillo (reclamo, demanda, urgencia, alto ticket) que escalan automáticamente a humano con resumen de los últimos 10 mensajes. En las primeras 12 semanas revisamos conversaciones semana a semana y ajustamos.
¿Cómo medimos resultados reales? Dashboard live con tiempo de primera respuesta, tasa de resolución sin humano, tasa de derivación al humano, lead score promedio, conversión mensaje a venta y costo por venta (no CPL). Marketing que se mide, no estadística de adorno.
¿Qué pasa con la privacidad y los datos de mis clientes? Cumplimos la Ley 19.628 de Protección de Datos y la nueva Ley 21.719 (vigente diciembre 2026). Los datos viven en infraestructura encriptada, no se usan para entrenar modelos públicos, y el cliente final es dueño de la información. Transparencia total en el contrato.
¿Y si ya pago ManyChat, Chatfuel o HighLevel? Antes de proponer nada auditamos qué tienes y si vale la pena migrar. A veces conviene mantener lo actual para broadcast y sumar Nara solo para conversación 1-a-1. Decisión basada en tus números reales, no en venderte algo nuevo.
¿Sirve para servicios profesionales (clínicas, spas, B2B) o solo retail? Sirve para ambos. Las distribuidoras B2B industriales del portafolio y otros perfiles usan la misma base entrenada distinto según el contexto. Cualquier negocio con WhatsApp como canal de ventas se beneficia.
¿Listo para tener WhatsApp como sistema, no como app suelta?
Un bot bien hecho es exactamente lo que ocurre en **La Audición**, el segundo Acto del Estudio de Solo Leads: cada lead que entra pasa una audición — Nara lo atiende en segundos, lo filtra y le dice "pasa al siguiente" solo a los que valen la pena, para que tu equipo hable con compradores y no con curiosos. Y no trabaja sola: La Producción trae el tráfico, La Postproducción ordena el seguimiento y El Director's Cut te muestra los números reales a fin de mes.
El Estudio abre sus primeras cuentas en unas 12 semanas y trabaja con cupos acotados: 8 cuentas máximo, un onboarding cada 14 días. Hoy puedes reservar tu lugar con número correlativo y condiciones congeladas. [Reserva tu lugar en el Estudio](/reserva). Si estás listo... corre cámara, acción.