comunidadbóvedaWhatsApp Closer AgentKit
repo blueprint · 6 pasos · 10 comandos · 3 proveedores · MIT

El que contesta a las once de la noche y agenda la reunión.

Alguien te escribe a las once de la noche preguntando cuánto sale. Le contestas a las nueve de la mañana y ya compró en otro lado. Este kit construye el agente que atiende esos chats: califica, contesta la objeción con tu playbook, ofrece horarios que existen de verdad en tu agenda, agenda, y deja la etapa y el próximo paso escritos en el CRM. Y no es una app que instalas: clonas una carpeta donde el agente todavía no existe, abres Claude Code adentro, y Claude lee el plano por fases y escribe el código en tu máquina, contra tus versiones y tu sistema operativo.

Las doce paradas · de un vistazo

Guía comunidad · verificada a agosto de 2026

Los tres pasos que escriben afuera no hacen nada sin tu permiso, y eso es el default.

Mandarle un mensaje a una persona, crear un evento en tu calendario y tocar una fila de tu base son las tres cosas que no se deshacen con otro clic. Por eso los tres empiezan en modo borrador: redactan, te muestran exactamente lo que harían, y esperan que digas que sí. Pasarlo a automático lo decides tú, de a un paso por vez, y el agente nunca se lo cambia solo. Aquí está todo lo demás: las doce preguntas de la entrevista que lo arman, los tres caminos para conectar el número —la API oficial de Meta, la pasarela, y un modo demo con el que pruebas todo sin una sola credencial—, lo que ya tienes que tener antes de empezar, los días que no dependen de ti porque los decide Meta, el chequeo de 23 verificaciones que bloquea publicar cuando algo no corrió, los costos reales con la fecha en la que se midieron, y el ritual del primer mes, que es el que te termina el playbook con las objeciones que ni sabías que te estaban haciendo.

proyecto propio · MITPythonrepo blueprint, no app6 pasos por conversación10 comandos12 preguntas de entrevistameta · zernio · demomodo borrador por defectocompuerta de 23 chequeosRailway o localcostos con fechano afiliado a Anthropic ni a Meta

el problema

Los mensajes que llegan a las once de la noche

el costo real

No es que contestes mal. Es que contestas tarde.

Alguien te escribe a las once de la noche preguntando cuánto sale. Le contestas a las nueve de la mañana y ya compró en otro lado. Esa venta no se perdió por precio ni por producto: se perdió por diez horas de silencio.

Y hay una segunda forma de perderla, más lenta. Contestas bien, cierras la reunión, y tres días después nadie sabe en qué quedaron: no hay etapa, no hay resumen, no hay próximo paso escrito en ningún lado. Cuando el volumen sube, las dos cosas pasan el mismo día.

Este kit construye el agente que atiende esos chats. No es un bot de preguntas frecuentes que responde con un menú: es un setter y un closer. Califica a quien escribió, contesta la objeción con las palabras que tú le diste, ofrece horarios que existen de verdad en tu agenda, agenda la reunión, deja la etapa y el próximo paso escritos en tu base, y le pasa el chat a una persona cuando aparece enojo, un precio fuera de rango o una palabra que tú marcaste como señal de que ahí ya no debe seguir.

un chat, con el agente atendiendo

23:04  Cliente   Hola, cuánto sale el plan completo?
23:04  Agente    Hola! El plan completo son $1,200 al mes e incluye
                 las tres cuentas y el soporte. ¿Para cuántas
                 personas lo estás viendo?
23:06  Cliente   Somos 4. La verdad se me hace caro
23:06  Agente    Te entiendo. Para 4 personas sale a $300 por
                 cabeza, y ahí adentro va el onboarding que
                 normalmente se cobra aparte. ¿Te muestro cómo
                 queda en 15 minutos?
23:07  Cliente   Va
23:07  Agente    Tengo mañana 10:00, mañana 16:30 o el jueves
                 11:00. ¿Cuál te sirve?
23:08  Cliente   Mañana 16:30

                 → evento creado · recordatorio programado
                 → lead actualizado: etapa «reunión agendada»

Los precios de ese chat no se los inventó el agente: salen del catálogo que le pasaste. La respuesta a «se me hace caro» tampoco: es la que tú escribiste en tu playbook. Y los tres horarios existen en tu calendario, porque los leyó de ahí antes de ofrecerlos.

Vas a clonar una carpeta donde el agente no existe

Esto es lo primero que hay que decir, porque si no parece que la descarga vino rota: adentro del repo no hay una aplicación. No hay una carpeta con el agente, no hay un servidor, no hay nada que arrancar. Compruébalo tú mismo apenas lo clones:

recién clonado, en tu terminal

$ ls agente
ls: agente: No such file or directory

Lo que se descarga son instrucciones. Abres Claude Code adentro de esa carpeta, escribes un comando, y Claude lee el plano fase por fase y escribe el código en tu máquina, contra tu versión de las cosas y tu sistema operativo. El agente no viene hecho: se construye ahí, la primera vez que lo corres.

elige bien

Hay dos kits parecidos y no son para lo mismo

En la bóveda vive otro kit del mismo autor, WhatsApp AgentKit, y en la búsqueda los dos se ven casi iguales. La diferencia es corta: aquél contesta. Éste vende.

Si lo que necesitas es un agente que responda por WhatsApp y ya —dudas, horarios de atención, información del producto— el hermano es más corto y llegas antes. Éste es para cuando la venta se cierra por chat: calificar a quien escribe, contestar la objeción con tu playbook, ofrecer horarios reales, agendar, y dejar la etapa escrita en el CRM. A cambio, pide más: un catálogo con precios, un playbook de objeciones, una agenda conectada, y el trámite de un número oficial.

Si después de leer esto te queda claro que el tuyo es el corto, la guía del hermano está aquí y no hay ningún problema en empezar por ahí.

la ficha

WhatsApp Closer AgentKit

qué es
Un repo blueprint: instrucciones por fases, no una aplicación.
quién lo construye
Claude Code, en tu máquina, leyendo el plano fase por fase.
qué queda corriendo
Un servicio con tu número de WhatsApp conectado y una bandeja que revisas.
lenguaje
Python. No necesitas escribirlo: lo escribe Claude.
licencia
MIT — úsalo, fórkealo, cámbialo.
lo que sí necesitas
Una clave de la API de Anthropic. Lo demás lo pide el plano cuando toca.

por qué cierra

Un setter que no se cansa

Un bot de preguntas frecuentes contesta. Un setter califica y agenda. La diferencia no está en la calidad de la redacción: está en qué pasa después de que el cliente escribió algo que no estaba en el guion.

un bot de preguntas frecuentes

Contesta y ahí se queda

  • Responde lo que está en su lista y para lo demás manda un «un asesor te contactará».
  • No sabe si quien escribió tiene presupuesto, urgencia o si siquiera es tu cliente.
  • Si el cliente dice «está caro», repite el precio o se calla.
  • No conoce tu agenda, así que no puede ofrecer una hora que exista.
  • Cuando la conversación termina, no queda nada escrito en ningún lado.

un setter y closer

Califica, objeta, agenda y anota

  • Puntúa presupuesto, urgencia y encaje, y sabe cuándo alguien no es tu cliente.
  • Contesta la objeción con la respuesta que tú escribiste, no con la que se le ocurra.
  • Si la objeción no está en tu playbook, la nombra y te la deja a ti en vez de improvisar.
  • Lee tu calendario y ofrece horarios que existen de verdad.
  • Deja la etapa, el resumen y el próximo paso escritos en la fila del contacto.
  • Corta y llama a una persona cuando aparece enojo, un monto fuera de rango o una palabra que marcaste.

La ventana de 24 horas es un hecho económico, no un detalle

WhatsApp tiene una regla que decide buena parte de esta cuenta: cuando un cliente te escribe, se abre una ventana de 24 horas. Dentro de esa ventana puedes contestarle libremente. Fuera de ella, ya no puedes escribir lo que quieras — solo puedes mandarle una plantilla aprobada de antemano, y esa sí se cobra.

O sea que contestar tarde no solo te cuesta la venta. Te cuesta también el derecho a contestar gratis. Un agente que responde dentro de la ventana está aprovechando la única parte barata del canal, y es justo la parte que un humano dormido no puede cubrir.

la cuenta, en una línea

Entre 30 y 50 centavos de dólar por conversación completa

Una conversación de diez idas y vueltas —desde el «cuánto sale» hasta la reunión agendada— cuesta entre 0.30 y 0.50 dólares en el modelo que redacta las respuestas. Con la caché encendida, cerca de la mitad. Dentro de la ventana de 24 horas, hoy, el mensaje de WhatsApp en sí no se cobra.

Pon ese número al lado de tu ticket. Si lo que vendes cuesta cien dólares, cada conversación completa te sale menos del uno por ciento de una venta. Si cuesta mil, es ruido. Ése es todo el argumento; el desglose completo con su fecha está en la sección de los números.

Y hay un beneficio que no se ve el primer día. Durante las primeras semanas el agente redacta y tú apruebas, y en ese ida y vuelta el kit va anotando qué objeciones aparecieron que tu playbook no cubría, con la respuesta que escribiste tú. Al mes no tienes solo un agente andando: tienes escrito lo que hasta ahora vivía en tu cabeza.

el contrato

Seis pasos, y tres piden permiso

Cada mensaje que entra pasa por los mismos seis pasos, siempre en el mismo orden. No es una sugerencia de diseño: es el contrato del kit, y está escrito en el repo para que ni Claude ni el agente lo improvisen.

1

Recibe el mensaje y trae el contexto

Levanta lo que llegó y recupera la conversación anterior con esa persona. Si mandaron una nota de voz, la baja y la transcribe. Si mandaron una foto, la lee el mismo modelo que ya está configurado — no hay una credencial extra de visión que conseguir.

2

Detecta la intención y califica

Puntúa presupuesto, urgencia y encaje. De aquí sale si esta persona es un cliente posible o alguien que se equivocó de número.

3

Responde con tu tono y ofrece horarios

Redacta la respuesta con el tratamiento y el playbook que le diste, y si toca, propone horas que leyó de tu agenda. Este paso le escribe a una persona.

4

Agenda y confirma

Crea el evento en el calendario con la hora elegida y manda la confirmación. Este paso escribe en tu agenda.

5

Escribe en el CRM

Actualiza la fila de ese contacto: etapa, resumen corto y próximo paso. Agrega y actualiza; nunca borra ni reordena nada de lo que ya estaba. Este paso escribe en tu base.

6

Pasa el chat a una persona

Corta cuando aparece enojo, un monto fuera del rango que definiste o una palabra de escalación, y avisa por el canal interno que elegiste. Después de escalar no vuelve a contestar, ni para despedirse.

La respuesta del agente siempre trae las seis casillas, aunque cinco queden vacías. Es a propósito: así se ve de un vistazo en cuál paso se cortó el ciclo, en vez de tener que adivinarlo.

Los tres que escriben afuera empiezan pidiendo permiso

Mira otra vez los pasos 3, 4 y 5. Mandarle un mensaje a una persona, crear un evento en tu calendario y tocar una fila de tu base son las tres cosas de esta lista que no se deshacen con otro clic. Un mensaje mal mandado ya lo leyó alguien. Una reunión mal agendada ya le llegó al cliente.

Por eso el modo por defecto del kit se llama borrador, y funciona así: los tres pasos redactan, te muestran exactamente lo que harían, y se quedan esperando que digas que sí. Nada sale hasta que lo apruebas.

un borrador esperando tu visto bueno

Borrador · paso 3 · contacto +52 55 ▪▪▪▪ 4471

  Le voy a responder:

    Te entiendo. Para 4 personas sale a $300 por cabeza,
    y ahí adentro va el onboarding que normalmente se
    cobra aparte. ¿Te muestro cómo queda en 15 minutos?

  Objeción detectada   «está caro»  · sí está en tu playbook
  Horarios a ofrecer   mañana 10:00 · mañana 16:30 · jueves 11:00

  va · no · corregí · saltar

borrador · el default

Redacta y espera

  • Los pasos 3, 4 y 5 preparan lo que harían y se detienen.
  • Ves el texto exacto, la hora exacta y la fila exacta antes de que salga.
  • Apruebas de a uno desde la bandeja, con cuatro respuestas posibles.
  • Sirve además para afinar el tono sin arriesgar una conversación real.

automático · lo decides tú

Sale sin preguntarte

  • Se activa de a un paso por vez, nunca los tres de golpe.
  • La recomendación del kit es soltar solo el paso 3 al principio.
  • Agendar y escribir en la base te siguen preguntando, porque deshacerlos cuesta más.
  • El agente nunca se lo cambia solo: siempre es una decisión tuya.

cómo se sabe que no se lo salta

Hay pruebas que exigen que no pase nada

Que un kit prometa esperar tu confirmación es fácil. El repo lo verifica al revés: tiene pruebas que llaman a los pasos que escriben afuera sin confirmar, y exigen que no ocurra absolutamente nada. Mandar el mensaje sin permiso cuenta como fallo aunque el texto haya quedado perfecto.

Es la diferencia entre «se supone que espera» y «si algún día deja de esperar, la construcción se cae antes de que llegue a tu número».

la entrevista

Doce preguntas y se arma solo

Aquí es donde el kit se gana el «se arma solo». No configuras nada a mano: Claude te hace doce preguntas, en cuatro tandas, y con tus respuestas escribe la configuración del agente. Ninguna es técnica — la más difícil es acordarte de cuánto cuesta lo que vendes.

Las tandas no son un capricho de orden: cada una la hace un comando distinto, así que puedes contestar las primeras hoy y las últimas cuando tengas las llaves.

BloqueQué te preguntaCuándo
Tu negocioDe qué negocio habla, con qué nombre firma el agente, y si le habla a tus clientes de tú, de vos o de usted.Al arrancar la construcción
Tu forma de venderEl playbook: qué objeciones te hacen y qué contestas tú a cada una. Es la pregunta más pesada de las doce.Justo después, y editable cualquier día
Tu catálogo y tus límitesQué vendes y a qué precio, entre qué montos puede moverse, qué horarios tienes libres de verdad, qué palabras disparan una escalación, y a dónde te avisa cuando escala.Cuando ya sabes qué vende el agente
Tus llavesPor dónde entran y salen los mensajes, las credenciales de ese proveedor, y qué servicios más vas a conectar.Al final, y se puede rotar después

Cada respuesta queda en un archivo de configuración que puedes abrir y editar después. Cambiar un precio o agregar un horario no obliga a repetir la entrevista ni a reconstruir nada.

la pregunta que decide todo

El playbook: qué contesta y qué te deja a ti

El agente solo contesta objeciones que estén en tu playbook. Si alguien dice algo que no está ahí, no improvisa una respuesta bonita: nombra la objeción y te la deja a ti. Suena a limitación y es lo contrario — es lo que evita que tu agente prometa un descuento que no existe o una garantía que no das.

Por eso esta pregunta pesa más que las otras once juntas. El kit te da tres caminos: partir de un playbook base de ocho objeciones comunes y ajustarlo, pasarle material que ya tengas escrito para que lo extraiga, o contestar seis preguntas y armarlo desde cero. Y si no lo terminas hoy, el primer mes de uso lo termina por ti — eso es la sección de la bandeja.

Las que casi siempre aparecen

  • «Está caro» — la más común, y la que peor contesta un bot genérico.
  • «¿Lo puedo pagar en cuotas?» — si la respuesta es sí, dila tú; si es no, dilo también.
  • «¿Y si no me sirve, me devuelven?» — aquí es donde se inventan garantías que no existen.
  • «Déjame consultarlo y te escribo» — la despedida que en realidad es una objeción.
  • «¿Me atiende alguien de acá?» — la que suele terminar en escalación, y está bien que así sea.

Los horarios tienen que existir de verdad

La otra pregunta que decide si el agente sirve es la de disponibilidad. No se trata de escribir «de 9 a 6»: se trata de que las horas que el agente ofrece salgan de tu calendario real, y de que si alguien te apartó ese hueco entre que se ofreció y el cliente eligió, el agente lo note, lo diga con esas palabras y vuelva a ofrecer.

Un agente que agenda encima de una reunión que ya tenías no te ahorró trabajo: te lo duplicó.

el número

Meta, Zernio o demo

Un agente de WhatsApp necesita un número por donde entren y salgan los mensajes. Hay tres formas de dárselo, y la que elijas cambia el trámite, el costo y qué tan frágil queda todo. El kit las soporta a las tres con la misma configuración: cambias una línea y el resto sigue igual.

CaminoQué necesitasQué cuestaQué tan frágil es
metaCuenta de Meta Business verificada, un número que no esté en WhatsApp personal ni en la app Business, y un trámite de días.Dentro de la ventana de 24 horas, hoy no se cobra. Las plantillas sí, por mensaje entregado y por país.Es el camino oficial. Mientras cumplas las reglas, el número es tuyo y nadie te lo tumba.
zernioUna cuenta en la pasarela. Se apoya en Meta por debajo, así que el trámite de fondo sigue existiendo.Cobra por cuenta conectada, no por mensaje: las dos primeras gratis. Encima pagas igual las plantillas de Meta.Igual de oficial que meta, con una capa más en medio y una factura más.
demoNada. Ni una credencial de WhatsApp.Cero. Solo pagas el modelo que redacta las respuestas.No sirve para atender clientes: sirve para probar todo antes de tener número.

El modo demo no es una maqueta

Vale la pena detenerse aquí, porque es lo que te deja ver el agente funcionando antes de darle una llave a nadie. El modo demo no simula mensajes con datos inventados: reproduce entregas reales que quedaron grabadas, con los mismos bytes y la misma firma con la que llegaron. Para el agente es indistinguible de un mensaje de verdad.

Eso significa que puedes armar el agente entero, ajustar el tono, corregir el playbook y verlo redactar respuestas completas el mismo día que clonas el repo, sin haber empezado siquiera el trámite con Meta. Lo único que el demo no se ahorra es la clave del modelo que escribe.

Por qué el kit no deja que ningún mensaje salga por otro lado

Cada mensaje que llega viene firmado, y el agente verifica esa firma antes de leerlo: es lo que impide que cualquiera que descubra tu dirección te mande mensajes falsos. Y en el otro sentido, todo lo que sale a un cliente pasa por una sola puerta, con tres candados puestos ahí: que estés dentro de la ventana de 24 horas, que ese contacto no esté bloqueado, y que nunca se le escriba primero a alguien que no escribió.

El repo explica por qué esos candados no están repartidos por el código sino concentrados en un solo archivo: lo que se pierde cuando una de esas guardas falta no es una respuesta, es el número de WhatsApp del negocio, y recuperarlo son semanas.

el otro camino

Contra la ruta del QR: hoy contra mañana

Existe otra forma de conectar un número, más rápida y sin trámite: levantar tu propio servidor y vincularlo escaneando un QR, como cuando abres WhatsApp en la computadora. Funciona hoy, no te cobra por mensaje, y lo tienes andando en una tarde.

El costo está en la otra columna. Esa vía no es oficial, así que el número puede caer sin aviso el día que WhatsApp lo decida, y si eso pasa te quedas sin el canal por el que te escriben tus clientes. Este kit va por el camino largo a propósito: trámite lento, cobro por mensaje, y un número que nadie te puede tumbar por usarlo.

Si tu caso pide velocidad más que permanencia —una prueba, un proyecto corto, un número que no es el del negocio—, la guía del camino del QR está aquí, con el riesgo de baneo explicado a fondo.

Cuál te toca

  • Empiezas por demo, siempre. No es un consejo: es el orden que el kit asume.
  • Vas a meta si el número es el de tu negocio y quieres que siga siendo tuyo dentro de un año.
  • Vas a zernio si ya lo usas o si manejas varios números de varios clientes y prefieres una sola factura.
  • La elección la haces tú al armar, no el agente, y cambiarla después es rotar una credencial, no reconstruir.

antes de empezar

Lo que ya tienes que tener, y los días que no dependen de ti

Casi todo lo que rompe un proyecto así no es el código: es descubrir en el día tres que te falta una cuenta, un número o un papel. Esta sección existe para que eso lo sepas ahora.

Lo que necesitas antes de escribir un solo comando

  • Claude Code instalado, y una suscripción o una clave de la API de Anthropic. Es lo único que hace falta siempre, incluso para el modo demo: lo que el demo te ahorra son las credenciales de WhatsApp, no el modelo que redacta.
  • Un número de teléfono que NO esté usándose en WhatsApp personal ni en la app de WhatsApp Business. Si el número que quieres usar ya tiene chats, tienes que sacarlo de ahí primero, y eso borra el historial de ese teléfono.
  • Una cuenta de Meta Business con los papeles del negocio a nombre del negocio: acta, comprobante de domicilio, sitio web activo. Aquí es donde se atoran casi todos.
  • Una tarjeta cargada en Anthropic si vas por API, y otra en Meta para cuando empieces a mandar plantillas.
  • Un catálogo con precios y un playbook de objeciones. No hace falta que estén escritos hoy — el kit te los saca en la entrevista — pero sí que existan en tu cabeza.
  • Opcionales, según hasta dónde quieras llegar: un calendario de Google para el paso 4, una base para el CRM del paso 5, y un canal interno donde recibir los avisos de escalación.

Aquí no dice «en menos de 30 minutos», y es a propósito

El repo se niega expresamente a prometer esa frase, y tiene razón: el despliegue sí son minutos, pero el trámite del negocio son días, y quien te promete media hora te está midiendo solo la parte que él controla.

EtapaCuánto tardaDe quién depende
Armar el agente y probarlo en demoUna tarde. Puedes hacerlo hoy mismo, sin credenciales de WhatsApp.De ti y de tu máquina.
DesplegarloMinutos.De ti.
Cargar variables y registrar el webhookAlrededor de 30 minutos, si las credenciales ya existen.De ti.
Verificación del negocio en MetaDe 1 a 5 días hábiles con los papeles en orden. Hasta 30 si falta algo o rechazan el primer intento.De Meta. No hay forma de apurarlo.
Aprobación de plantillasNormalmente horas. Se rechazan sin mucha explicación y hay que reescribirlas.De Meta.

el cuello de botella real

Sin verificación, tu número solo le habla a quien tú agregues

Mientras Meta no verifique el negocio, el número queda en modo prueba. No es que no funcione: funciona perfecto, pero solo con los teléfonos que hayas agregado a mano a una lista corta. Le puedes escribir a tu socio y a tu propio celular; a un cliente que llegó de un anuncio, no.

La consecuencia práctica es de calendario: si vas a montar esto, empieza el trámite de verificación el primer día y arma el agente mientras esperas. Al revés —construir todo y descubrir al final que faltan quince días— es lo que hace que la gente abandone con el proyecto terminado.

número en modo prueba, antes de la verificación

Estado del número       modo de prueba
Puede escribirle a       5 teléfonos que agregaste a mano
Puede recibir de         esos mismos 5
Un cliente nuevo         no le llega el mensaje, y no hay error visible

Se levanta cuando        Meta verifica el negocio (1-5 días hábiles)

Estos plazos son los que el repo midió y publica con fecha: 13 de agosto de 2026. Los de Meta se mueven, así que si vas a prometerle una fecha a alguien, míralos en la documentación oficial antes.

día uno

Del clon a un vendedor que ya contesta, sin una sola credencial

Todo lo de esta sección se hace sin haber pedido un número, sin haber empezado el trámite con Meta y sin conectar tu calendario. Lo único que necesitas es Claude Code y tu clave de Anthropic. Al final vas a tener el agente armado y contestando en un simulador, con tu catálogo y tus objeciones.

Los diez comandos, y cuándo te toca cada uno

El kit trae diez comandos, pero no son diez decisiones: son tres etapas. Cuatro los usas armando, tres publicando, y dos los vas a usar cada mañana durante el primer mes.

ComandoEtapaPara qué
/armar-cerradorarmarConstruye el agente entero, fase por fase. Es la primera corrida.
/seguirarmarRetoma una construcción a medias sin pisar lo que ya quedó hecho.
/configurararmarEl catálogo con precios, el rango, la disponibilidad, las palabras de escalación y el canal interno.
/playbookarmarEscribe o cambia el playbook de objeciones y el tono, sin tocar nada más.
/probararmarAbre un simulador de chat en la terminal y corre el caso contra demo, sin credenciales.
/conectarpublicarAgrega, cambia o rota una credencial, incluido pasar de un proveedor a otro.
/revisarpublicarCorre el chequeo y te dice qué falta antes de publicar.
/publicarpublicarDespliega —local o Railway— y da de alta el webhook contra tu proveedor.
/bandejaoperarLos borradores de a uno, con todo para decidir: va, no, corregí o saltar.
/soltaroperarPasa un paso de borrador a automático, después de mostrarte los números.

Clonar y abrir

Se clona, no se instala. El repo trae un archivo que lo hace visible en el catálogo de plugins, pero instalarlo como plugin rompe las rutas: los comandos leen archivos del clon, y desde otro proyecto apuntan a otro lado. Clónalo y trabaja adentro de la carpeta.

1 · Trae el repo a tu máquina

git clone https://github.com/Hainrixz/whatsapp-closer-agentkit

2 · Entra a la carpeta y abre Claude Code adentro

cd whatsapp-closer-agentkit && claude

3 · Arranca la construcción

/armar-cerrador

Qué pasa cuando escribes ese comando

Claude abre el plano y lo sigue por fases, una a la vez. Cada paso viene en cuatro tiempos: qué se va a lograr, qué tienes que hacer, qué tienes que ver en pantalla cuando salió bien, y qué hacer si eso no aparece. Ese cuarto tiempo es la diferencia entre un tutorial y algo que sobrevive a que tu computadora no sea igual a la de quien lo escribió.

En el camino te va a hacer las preguntas de la entrevista, y va a escribir el código del agente en tu carpeta. No te pide que escribas ni una línea; te pide que contestes sobre tu negocio y que confirmes lo que ves.

lo más probable que te pase

Nadie termina esto de una sentada

Vas a levantarte de la silla a mitad de la construcción, y eso está previsto. El kit va anotando en qué fase quedó y con qué archivos, así que cuando vuelvas usas /seguir en vez de empezar de nuevo.

Y hace algo que conviene saber: antes de escribir, compara lo anotado contra lo que hay en el disco. Si un archivo cambió desde la última vez, no lo pisa en silencio — te dice qué cambió, qué se perdería, y espera que decidas archivo por archivo.

/configurararmar

Las preguntas del negocio: qué vendes y a cuánto, entre qué montos puede moverse el agente, qué horarios tienes libres de verdad, qué palabras disparan una escalación y a dónde te avisa cuando escala.

sin argumentos · se puede repetir cualquier día para cambiar precios u horarios

/playbookarmar

Escribe o cambia el playbook de objeciones y el tono, sin tocar nada más de la configuración. Tres caminos: partir del base de ocho objeciones, extraerlo de material que ya tengas, o armarlo contestando seis preguntas.

sin argumentos · vuelve solo a quien lo llamó, no reconstruye nada

/probararmar

Abre un simulador de chat en tu terminal y hace correr al agente completo contra el modo demo. Escribes como si fueras el cliente y ves qué contesta, con qué objeción detectó y qué horarios habría ofrecido.

sin credenciales de WhatsApp · corre los seis pasos en modo borrador

Y aquí es donde lo ves trabajando

Éste es el momento que vuelve todo lo anterior real. Sin haber conectado un número, sin haber hablado con Meta y sin haber pagado un peso de WhatsApp, escribes /probar y te encuentras a tu vendedor del otro lado de la terminal.

/probar · simulador contra demo

Simulador · proveedor demo · modo borrador
Escribe como si fueras el cliente. Ctrl-C para salir.

tú>  hola, cuánto cuesta el plan de 4 personas?

  paso 1  contexto      contacto nuevo · sin historial
  paso 2  calificación  score 72 · presupuesto ok · urgencia media
  paso 3  respuesta     BORRADOR, no se envió

      Hola! Para 4 personas el plan completo sale $1,200
      al mes, o sea $300 por cabeza, con el onboarding
      incluido. ¿Te muestro cómo queda en 15 minutos?

  paso 4  agenda        salteado · falta que elija horario
  paso 5  CRM           salteado · sin credencial
  paso 6  escalación    no aplica

Si el tono no te gusta, corres /playbook, lo cambias y vuelves a probar. Es un ciclo de un minuto, y lo puedes repetir todas las veces que quieras antes de que exista un número de verdad.

en vivo

Conectar, pasar el chequeo, publicar

A partir de aquí todo pide llaves. Son tres comandos en orden, y el del medio existe para que el tercero no te explote en la cara.

/conectar1 · las llaves

Elige el proveedor y guarda sus credenciales, más la clave del modelo y las de lo que quieras enchufar: calendario, base, canal interno. Ningún valor pasa por el chat — los escribes tú en el archivo de secretos, que está excluido del control de versiones desde el primer commit.

también sirve para rotar una clave o cambiar de proveedor sin reconstruir

/revisar2 · el chequeo

Corre las 23 verificaciones y te dice qué falta antes de publicar. No abre un solo socket ni lee un secreto, así que se puede correr con mala conexión y sin miedo a que se lleve algo tuyo.

tres veredictos posibles: aprueba, falla, o parcial

/publicar3 · a producción

Pregunta dónde va —tu máquina o Railway—, despliega, y da de alta el webhook contra tu proveedor. La elección del destino la haces tú: el agente no la decide, porque dos instancias contra la misma base le contestan dos veces a la misma persona.

se despliega con el chequeo en verde y con nada más

Qué mira el chequeo, y por qué no puede tocar la red

Son 23 verificaciones mecánicas: cada una sale bien o mal por sí sola, ninguna dice «revisa el código a ojo». Mira que las piezas copiadas no se hayan alterado, que las versiones sean las fijadas, que no haya quedado ninguna credencial dentro del proyecto, que las firmas den contra dos entregas grabadas, que ninguna dirección de envío viva fuera del único archivo que puede mandar mensajes, y que todas las rutas privadas estén detrás de su token.

Y hay una condición que explica por qué está diseñado así: no abre conexiones. Un chequeo que intentara alcanzar a Meta con mala conexión se quedaría esperando y no habría reporte. Prefirieron un chequeo que siempre responde a uno que a veces se cuelga.

/revisar · el chequeo pasando

$ python scripts/auditar.py
auditar: PASS · 0 errores · 1 aviso · 11 salteados
  un salteado no es un aprobado: leé el motivo de cada uno.

el veredicto que hay que entender

«Parcial» no quiere decir «casi»

Los veredictos son tres, y el del medio es el que confunde. Que apruebe es obvio y que falle también. Parcial significa otra cosa: no encontró nada malo, pero una verificación que en este proyecto tenía que correr no corrió — faltaba una dependencia, faltaba el entorno, faltaba algo.

Y eso no es un aprobado con asterisco. Un chequeo que no corrió no distingue entre «revisé y está bien» y «no revisé nada», así que parcial bloquea el despliegue igual que un fallo. Es una decisión de diseño que se agradece el día que te salva.

La verificación que mira a las pruebas y no al código

Hay una de las 23 que vale la pena contar porque casi nadie la hace. En vez de revisar el agente, revisa las pruebas: corre la suite una y otra vez, cambiando a propósito un solo valor cada vez por otro que sigue siendo válido, y pregunta si alguna prueba se pone roja.

El motivo es que una prueba que solo comprueba que el documento tiene la forma correcta no está afirmando nada. Si puedes cambiarle el contenido y ninguna prueba se queja, esa prueba estaba de adorno. Es el equivalente a probar la alarma antes de irte, en vez de suponer que suena.

Dónde va a correr

DestinoCuándo convieneQué te va a doler
Tu laptopPara la primera entrega y nada más, cuando quieres ver un mensaje real llegar.Cierras la tapa, el proceso se duerme, el túnel se cae, y los mensajes de esas horas no llegan.
Un Mac MiniCuando ya está prendido, cuando la base con los chats no puede salir de la oficina, o cuando el volumen es alto y no quieres pagar por uso.Sin dominio propio, sin nadie que lo reinicie un domingo, y el corte de luz de la oficina es tu garantía de servicio.
RailwayEs el default del kit. Reinicio automático si algo se cae y chequeo de salud incluidos.Pagas por uso, y con base de datos vives cerca del límite del plan más barato.

las dos rarezas de este proyecto

Lo único de Railway que no vas a encontrar en otra guía

El kit trae la configuración de despliegue lista y no hay que completarla: se sube tal cual viene. Las dos cosas que sí te van a morder son propias de este proyecto.

La primera: cuenta la base de datos como un segundo servicio encendido las veinticuatro horas. En el plan más barato eso te deja viviendo alrededor del límite, no muy por debajo, y conviene saberlo antes de la primera factura.

La segunda: la dirección de conexión que te da Railway trae un parámetro de seguridad al final que el conector de este proyecto no entiende, y hay que sacarlo de la cadena. Con base local nunca se nota, así que revienta justo en el primer despliegue y con un error que no menciona a nadie.

Todo lo demás del despliegue —dominios, variables de entorno, previews, rollback— es territorio de la guía de All Deploy, y no tiene sentido repetirlo aquí.

Lo último: decirle a WhatsApp a dónde avisar

El paso final es el alta del webhook, que es el trámite de darle a tu proveedor la dirección a la que debe avisar cuando entra un mensaje. Con Meta, la verificación de esa dirección es un intercambio de una sola vez que el servicio ya sabe contestar. Con Zernio, lo que importa es que tu servicio conteste en menos de cinco segundos, o el mensaje se reintenta hasta siete veces.

Cuando eso queda, el circuito está cerrado: alguien te escribe, el mensaje entra, los seis pasos corren, y del otro lado aparece un borrador esperando que lo apruebes.

los números

Lo que cuesta de verdad, con fecha

Estos números se mueven, así que van con el día en que se midieron. Míralos en las páginas oficiales antes de prometerle un costo a un cliente — y sobre todo los de Meta, que son los que están por cambiar.

ConceptoCuántoMedido el
RailwayPlan Hobby: 5 USD al mes que incluyen 5 USD de uso. Debajo de eso pagas 5; arriba, pagas el uso. Cuenta la base de datos como un segundo servicio prendido las 24 horas.13 ago 2026
Anthropic · por mensajeUn ciclo completo —un mensaje, los seis pasos, una respuesta— mueve entre 6 y 8 mil tokens de entrada y unos cientos de salida: 3 a 5 centavos de dólar.13 ago 2026
Anthropic · por conversaciónDiez idas y vueltas hasta la reunión agendada: 0.30 a 0.50 dólares. Con la caché de prompt encendida, cerca de la mitad.13 ago 2026
Anthropic · la tarifaEl modelo que redacta cobra 5 dólares por millón de tokens de entrada y 25 por millón de salida.14 ago 2026
WhatsApp con MetaSi el cliente escribió primero y contestas dentro de las 24 horas, hoy el mensaje no se cobra. Las plantillas sí: por mensaje entregado y por país, del orden de 0.01 USD en India a 0.025 en Estados Unidos.13 ago 2026
WhatsApp con ZernioCobra por cuenta conectada y no por mensaje: las dos primeras gratis, de la tercera a la décima 6 USD al mes cada una. Encima pagas igual las plantillas de Meta.13 ago 2026

ponlo en el calendario

El 1 de octubre de 2026 la línea de WhatsApp cambia

Hoy un agente que solo contesta dentro de la ventana de 24 horas casi no paga WhatsApp. A partir del 1 de octubre de 2026, Meta pasa a cobrar por mensaje de negocio, y eso incluye las respuestas de servicio y las de utilidad que hoy son gratis por caer dentro de la ventana.

No cambia si esto te conviene o no —el costo por mensaje sigue siendo chico al lado de una venta— pero sí cambia la aritmética que hagas hoy para el año que viene. Si estás armando un presupuesto a doce meses, cuenta esa línea desde octubre.

Las tres cosas que mueven la cuenta y nadie te avisa

  • El gasto del modelo crece con la cantidad de chats, no con la cantidad de clientes. Cien personas preguntando y no comprando cuestan lo mismo que cien comprando.
  • El mensaje número diez de una conversación cuesta más que el primero, porque arrastra todo el historial anterior. Una conversación larga no es diez veces una corta: es más.
  • El modelo viene con su razonamiento encendido por defecto, y eso se factura como texto de salida — que es la parte cara. Está incluido en las cifras de arriba, pero es lo que hace que la cuenta no dé si la calculas solo con el largo de la respuesta visible.
  • Las plantillas aparecen recién cuando empiezas a mandar recordatorios de cita, no el primer día. Es la línea que se descubre en la segunda factura.

un mes de ejemplo

Un negocio con unas 200 conversaciones al mes, hoy

Railway + base
5 a 10 USD, según cuánto uso te coma la base de datos.
Anthropic
60 a 100 USD sin caché; cerca de la mitad con ella encendida.
WhatsApp, dentro de la ventana
0 USD hoy. Desde el 1 de octubre de 2026, ya no.
Recordatorios de cita
Unos pocos dólares: son plantillas, y casi siempre caen fuera de la ventana.
Total aproximado
Entre 70 y 115 dólares al mes con esos volúmenes.
Con qué compararlo
Con lo que te cuesta una sola venta perdida por contestar a las nueve de la mañana.

el primer mes

La bandeja que te termina el playbook

Con el agente publicado y en modo borrador, tu rutina es una sola cosa: abrir la bandeja con el café y resolver lo que se acumuló. Cada borrador viene con todo lo necesario para decidir en cinco segundos, y tienes cuatro respuestas.

/bandeja · un borrador por pantalla

Bandeja · 3 pendientes

  1 de 3 · paso 3 · +52 55 ▪▪▪▪ 4471 · hace 20 min

    «Me interesa pero necesito verlo con mi socio»

  Va a responder:
    Claro. ¿Te late que lo veamos los tres juntos? Así tu
    socio pregunta directo y no queda nada en el teléfono.
    Tengo jueves 11:00 o viernes 09:30.

  Objeción   «lo tengo que consultar» · sí está en tu playbook
  Score      68 · presupuesto ok · urgencia baja

  va   no   corregí   saltar

Las cuatro respuestas

  • va — sale tal cual está redactado.
  • no — no sale, y queda anotado que lo frenaste.
  • corregí — lo reescribes, sale tu versión, y el kit guarda el par viejo y nuevo para saber en qué se equivoca.
  • saltar — lo dejas para después sin decidir.

Y a las dos semanas, esto

Aquí está el riesgo real del modo borrador, y el kit lo sabe: para el día cuatro ya aprobaste veinte, todos estaban bien, y sientes que estás haciendo el trabajo del agente. Ahí es cuando la gente suelta sin leer o abandona. La respuesta del kit a eso es un comando.

/bandeja resumen · lo que te devuelve la espera

Bandeja · 9 días · 31 borradores

  Salieron tal cual     22   71 %
  Los corregiste         7
  Los frenaste           2   «eso no lo damos en agosto»
  Salteados              0

Lo que más corregiste
  1. Los horarios: 5 de 7 veces cambiaste el orden o sacaste
     el de las 09:00. Eso se arregla en la configuración de
     agenda, no borrador por borrador.
  2. El cierre: 3 de 7 veces le sacaste la pregunta final.

Objeciones que aparecieron y NO están en tu playbook
  · «¿Lo puedo pagar en cuotas?»        4 veces
    Contestaste: «Sí, en tres pagos sin interés, te paso el enlace.»
  · «¿Y si no me sirve, me devuelven?»  2 veces
    Contestaste: «Tenés 15 días para pedir la devolución.»
  · «¿Me atiende alguien de acá?»       1 vez
    Sin responder: lo pasaste a una persona.

Con /playbook las sumo con tus palabras. Dos minutos, y son
siete borradores menos por semana.

el producto real de la espera

Las objeciones que ni sabías que te estaban haciendo

Mira el último bloque de ese resumen, porque es lo que justifica todo lo anterior. No es una estadística de uso: es la lista de las objeciones que tus clientes te hicieron de verdad, que tu playbook no cubría, junto a la respuesta que escribiste tú en el momento.

Nadie tiene eso escrito. Vive en la cabeza de quien vende, y sale a la luz solo cuando alguien se sienta a mirarlo. Aquí sale solo, porque el modo borrador te obligó a contestar cada una a mano y el kit las fue anotando.

Ése es el giro de esta sección: las dos semanas de aprobar de a uno dejan de ser un costo y se convierten en la etapa donde tu playbook se termina. Cuando llegas a la sección siguiente y decides soltarlo, no estás soltando el agente del día uno — estás soltando uno que ya aprendió lo que tú sabías y no habías escrito.

soltarlo

Cinco pisos que te informan y no te bloquean

En algún momento vas a querer que el agente conteste sin preguntarte. La pregunta no es si soltarlo, es cuándo — y el kit no te lo responde con una opinión, te lo responde con cinco números tuyos.

Qué midePisoPor qué está ahí
Días con la bandeja abierta7Menos de una semana no alcanza para ver la variedad de cosas que te preguntan.
Borradores revisados20Con menos de veinte no tienes muestra para saber si el agente escribe bien o tuviste suerte.
De los últimos 20, cuántos salieron sin corregir16Es el número que de verdad importa: si todavía corriges uno de cada cuatro, soltarlo es mandar uno de cada cuatro mensajes mal.
Precios fuera del catálogo0Cualquier precio inventado descalifica. No hay margen de tolerancia aquí.
Horarios fuera de tu agenda0Igual: si ofreció una hora que no existía, todavía no está listo.

/soltar · los cinco números, con los tuyos al lado

Soltar · alcance recomendado: paso-3

  ok     Días con la bandeja abierta         9   piso 7
  ok     Borradores revisados               31   piso 20
  falta  De los últimos 20, sin corregir    14   piso 16
  ok     Precios fuera del catálogo          0   piso 0
  ok     Horarios fuera de la agenda         0   piso 0

  (informativo, no es piso: 3 objeciones aparecieron fuera
   del playbook)

  Falta una. De esas seis correcciones, dos fueron por «¿lo
  puedo pagar en cuotas?», que no está en tu playbook: si la
  sumás con /playbook, ese número sube solo.

  soltar igual    lo cambio ahora, con 14 de 20. Es tu negocio.

Suelta el paso 3 y nada más, al principio

El comando te deja soltar los tres pasos de golpe, y el propio kit te recomienda que no. Suelta solo el paso 3: el agente contesta solo, pero agendar y escribir en la base te siguen preguntando.

El razonamiento es de reversibilidad. Un mensaje mal mandado se corrige con otro mensaje. Una reunión mal agendada le llegó al cliente y hay que deshacerla; una fila mal escrita en la base te ensucia el pipeline y no te enteras hasta el reporte del mes. Los pasos 4 y 5 se sueltan después, de a uno, con la misma medición.

1

Paso 3 · que conteste solo

Lo primero y lo más seguro. A partir de aquí el agente le escribe a una persona sin preguntarte, y ése es el cambio que de verdad te devuelve tiempo.

2

Paso 4 · que agende solo

Cuando lleves semanas viendo que las horas que propone son las correctas. Deshacer una reunión cuesta una llamada incómoda.

3

Paso 5 · que escriba en la base solo

El último. Es el que menos urgencia tiene y el que más silenciosamente te puede ensuciar los datos.

la decisión de diseño

Si no cumples los pisos, te deja soltarlo igual

Mira otra vez la última línea de esa pantalla. El kit no cumple una de las cinco condiciones y aun así te ofrece «soltar igual», sin discutirlo de nuevo. Anota con qué números decidiste y sigue.

El motivo está escrito en el repo con estas palabras: bloquear a alguien en su propio proyecto es lo que hace que borren el repo. Una herramienta que te trata como si no supieras lo que haces termina desinstalada, y una que te muestra los números y te deja decidir termina usada.

Y si te arrepientes, se vuelve atrás con un comando. No hay puerta de un solo sentido en esta parte.

la letra chica

Lo que no hace, lo que todavía no anda, y cuándo no es para ti

Esta sección existe porque el repo la escribe primero. Tiene dos archivos dedicados a decir qué no funciona y qué se decidió por ti, y eso es más raro de lo que debería ser. Aquí va lo que conviene saber antes de clonar.

no lo hace, a propósito

Límites que son la función

  • No inventa precios ni promociones. Lo que no está en el catálogo que le pasaste, no existe.
  • No contesta objeciones fuera de tu playbook. Las nombra y te las deja.
  • No escribe primero. Contesta a quien le escribió, y nada más.
  • No negocia un precio fuera del rango que definiste. Eso escala, siempre.
  • No sigue contestando después de una escalación, ni para despedirse.
  • No borra ni reordena nada del CRM. Agrega y actualiza la fila del contacto.

todavía no anda

Lo que el propio repo confiesa

  • El recordatorio 24 horas antes de la cita no funciona con base de datos en la nube. Con base local anda entero.
  • El chequeo en verde no significa que funcione contra Meta: hay nueve cosas que no puede probar sin salir a la red.
  • Que tu clave sea la permanente y no la de 24 horas, que tu plantilla esté aprobada, que la tabla deje escribir — nada de eso lo verifica nadie hasta el primer mensaje real.
  • Doce decisiones las tomó el kit por ti porque la ficha no las cerraba, y cada una dice dónde se corrige.

el que te va a tocar

El default del kit y su límite chocan entre sí

Junta dos cosas que están en secciones distintas y verás por qué esto importa: el destino recomendado es Railway, y Railway trae base de datos en la nube. Y el recordatorio de 24 horas antes de la cita no funciona con base en la nube.

O sea que si sigues el camino recomendado tal cual, la cita se agenda bien y la confirmación sale bien, pero el recordatorio de la noche anterior no va a salir. El kit lo dice al momento de agendar en vez de dejarte descubrirlo la mañana de la reunión, y trae escrito cuáles archivos hay que mover juntos para arreglarlo.

Si el recordatorio es crítico para tu negocio, es la conversación que hay que tener antes de desplegar, no después.

«No escribe primero» no es una carencia

Es el límite que más se malinterpreta. La gente lee «no escribe primero» y entiende «entonces no me consigue clientes». Lo que en realidad dice es: este agente no manda mensajes en frío, y no los manda porque abrir conversaciones con gente que no te escribió es exactamente lo que hace que Meta te baje el número.

Perder el número no es perder una herramienta: es perder el canal por el que te escriben todos tus clientes, y recuperarlo son semanas. El kit prefiere no tocar esa puerta.

Llenar la parte de arriba del embudo —encontrar a quién escribirle, con permiso y sin quemar la cuenta— es otro trabajo y tiene su propia guía: cómo conseguir clientes sin mandar mensajes en frío. Este agente empieza donde ésa termina.

Un límite que no pone el kit sino la plataforma

Fuera de la ventana de 24 horas desde el último mensaje del cliente, WhatsApp solo deja mandar plantillas aprobadas de antemano. El recordatorio de la cita cae casi siempre fuera de esa ventana, así que necesita una plantilla dada de alta con tiempo — y las plantillas se aprueban aparte, normalmente en horas, y se rechazan sin mucha explicación.

Cuándo esto no es para ti

  • Si no tienes catálogo ni precios cerrados. El agente no puede decir lo que tú no decidiste.
  • Si tu venta no se cierra por chat sino por llamada larga, visita o licitación. Aquí el agente agenda, y si agendar no es tu cuello de botella, no te está resolviendo el problema que tienes.
  • Si lo que necesitas es prospección: mandar mensajes a gente que no te escribió. Este kit no hace eso y no lo va a hacer.
  • Si el número que quieres usar es tu WhatsApp personal y no estás dispuesto a sacarlo de ahí.
  • Si necesitas estar en vivo esta semana. El trámite de Meta no lo apuras con nada.

el detalle que compra credibilidad

Treinta versiones clavadas, y dos confesadas

El kit fija las treinta dependencias en una versión exacta, nunca «de ésta para arriba». El motivo es que un piso no es un candado: dice «ésta o cualquiera que venga después», y a las que vienen después no las probó nadie. Es la clase de fallo que no revienta al instalar, revienta después, raro, y con un error que no menciona a ninguno de los dos culpables.

Y hay una regla más: no se fija una versión que salió hace menos de setenta y dos horas, porque no tuvo reposo. Lo notable es que el repo escribe, en su propio archivo de versiones, que dos de sus pines rompen esa regla hoy, con el nombre de cada uno y el motivo por el que no se bajaron todavía.

Eso es lo que hay que mirar al evaluar una herramienta de alguien más: no si tiene defectos, sino si te los cuenta antes de que los descubras.

Guía de la comunidad

Esta guía es parte de la bóveda abierta de tododeia.

Las fuentes · de dónde salió cada dato

Los conteos de esta página —seis pasos, diez comandos, doce preguntas, veintitrés chequeos, tres proveedores— están contados sobre los archivos del repo, no estimados. Los costos y los plazos son los que el propio repo midió y publica con fecha, y los precios del modelo se contrastaron aparte contra la documentación de Anthropic: coinciden. Lo de Meta —tarifas, ventana de 24 horas, plazos de verificación— cámbialo por lo que diga Meta el día que lo leas: son los números que más se mueven de toda la página, y el 1 de octubre de 2026 ya hay un cambio anunciado.

Sigue por aquí

El kit es gratis y open source

Licencia MIT: úsalo, fórkealo, cámbiale lo que quieras. Si te sirvió, una estrella en el repo es la forma más barata de que le llegue a alguien más. Proyecto de la comunidad, no afiliado a Anthropic ni a Meta.