SYS.STATUS ── PRODUCTION-GRADE SALES AGENT
WHATSAPP CLOUD API · WORKERS · CRM

From message to revenue infrastructure.

Un agente de WhatsApp no es “un bot”. Es una capa operativa: captura demanda, califica intención, protege el tono comercial y escala a humanos cuando importa.

Input 01

Mensaje real del cliente, persistido y asociado a customer/thread.

Core 03

Intención, policy engine y guardrails antes de escribir.

Output 05

Respuesta, CRM, seguimiento y delivery por WhatsApp Cloud API.

479 tests passing 29 guard patterns 12H handoff window 17,873 real messages distilled 12 TurnPlan variants

Less diagram.
More system.

Un agente de venta no se entiende con un diagrama apretado. Se entiende viendo cómo decide: capa por capa, con cada guard, cada handoff y cada retry en su lugar y con su razón. Por eso lo mostramos como un sistema, no como una caja negra.

01

Five layers. One operating loop.

La arquitectura se lee como una cadena de responsabilidad: entrada confiable, contexto, decisión, respuesta y delivery. Cada capa reduce una clase distinta de falla.

Inbound

Capture without losing evidence.

Webhook, firma Meta, persistencia inbound y asociación al thread antes de cualquier inteligencia.

Routing

Respect human ownership.

Si hay handoff activo, el agente se silencia. El sistema no pelea con el operador.

Decisioning

Policy before prose.

El planner decide intención, ruta y permisos antes de dejar que el LLM redacte.

Delivery

Send, observe, recover.

Outbound queued, Cloud API, status sent, retry/sweeper y alerta ops si falla.

(02) — Interactive architecture

System flow.

WhatsApp AI Sales Agent Flow

Elegí una ruta para seguir el mensaje de punta a punta
5 LAYERS · 3 ROUTES
01 Inbound
1
Cliente escribe
por WhatsApp Mensaje real del cliente
2
Webhook
Worker Cloudflare Worker · Hono
3
Verificar firma
Meta HMAC Rechazo si inválida
4
Persistir
inbound UNIQUE dedup
5
Buscar/crear
customer·thread upsert Supabase
6
Dispatch async waitUntil
02 Routing
7
Handoff
activo? ventana 12h
Sí → handoff
7A
Silenciar
agente Humano respondió <12h
No → continúa
7B
Cargar memoria,
lead e historial contexto completo
03 Decisioning
8
Detectar intención
y señales turn-signals.ts
9
Policy Engine /
Planner 12 TurnPlan variants
10
Tipo de
intención Estándar · Open · Handoff
Handoff
14
Handoff /
pending op. compra · pago · sensible
15
Notificar
humano aviso a ops · Telegram
16
Marcar
in_handoff · silencio 12h window activa
04 Response
Estándar
11
Resolver dato
canónico precio/stock/envío de DB
12
Composer
determinístico precio/media nunca LLM
Open
13
LLM redacta
respuesta acotada máx 5 tool-calls
Guard
17
Output Guard 29 regex · meta-leak
18
Respuesta
válida? Sí → CRM · No → fallback
19
Actualizar
CRM / lead lead scoring actualizado
No → fallback
18B
Fallback honesto vuelve a CRM
05 Delivery
20
Agendar
seguimiento +1/3/7d · 10hs AR
21
Outbound
queued estado = queued
22
Enviar
WhatsApp Cloud API Meta Cloud API v18+
23
Envío OK? Sí → sent · No → retry
24
Status sent ✓ actualiza outbound → sent
No → retry
24B
Retry / sweeper /
alerta ops recovery loop
Flujo principal
Ruta condicional
Acción asíncrona / externa
Architecture Diagram · 5 layers · 3 routes
⏱ Gate 12h activado — próximos mensajes
los recibe Fede, no el agente

(01) — Safe silence

Handoff activo no es un edge case.

Es una regla de soberanía humana. Si el thread está en manos de una persona, el agente no improvisa, no responde encima y no compite por el control.

(02) — Deterministic where possible

Lo estándar no debería depender de inspiración.

Precio, medidas, stock, métodos de pago y respuestas canónicas se resuelven por fuente controlada y composer determinístico. El LLM entra solo donde suma.

(03) — Honest fallback

Fallar bien también vende.

Si la respuesta no pasa guardia, el sistema no alucina. Degrada con honestidad, actualiza CRM y deja trazabilidad para seguimiento.

(04) — Recovery loop

Delivery no termina en “send”.

Outbound queued, status sent, retry, sweeper y alerta ops hacen que el sistema sea operable, no solo “inteligente”.

What stakeholders should leave understanding.

Cada respuesta sale de una ruta explicable: estándar, abierta o handoff.

El agente alimenta lead state, seguimiento y operación desde el flujo mismo.

Compra, pago y casos sensibles priorizan handoff o pending operation.

La arquitectura contempla retries, sweepers y alertas, no solo respuestas lindas.

No hay métricas de conversión porque no hay producción todavía. Lo que hay es arquitectura sólida, 479 tests en verde y la doctrina correcta. Si eso te genera dudas, es exactamente el rigor que debería exigirle a quien te lo construya.