Agente Whatsapp Ia — Development skill for Claude Code

Agente de ventas y atención por WhatsApp

Agente de IA que atiende clientes de un comercio por WhatsApp: consulta inventario y pedidos **en vivo**, recuerda a cada cliente, registra solicitudes para que el equipo las confirme y **pasa la conversación a una persona** cuando hace falta.

Es un servicio **independiente** que se conecta al sistema de un negocio en modo solo lectura, y se desconecta sin dejar rastro. Nació para un negocio real de importaciones en Colombia. Este repositorio trae un negocio de **demo con datos ficticios** para correrlo sin base de datos.

**Stack:** Python · LangGraph · Claude API (tool use) · FastAPI · WhatsApp Cloud API · PostgreSQL / SQLite · SQLAlchemy

Arquitectura

flowchart LR
    subgraph Cliente final
      WA[WhatsApp]
    end
    subgraph Servicio del agente
      F[FastAPI
webhook · panel · admin] --> G[Grafo LangGraph]
      G --> AL[(Base propia del agente
memoria · solicitudes ·
escalamientos · métricas)]
    end
    subgraph Sistema del negocio
      C[Conector de solo lectura
usuario sin permisos sobre tablas] --> DB[(Base del negocio)]
    end
    WA <--> F
    G -->|consulta| C
    P[Panel del negocio] --> F

flowchart TD
    I{inicio} -->|servicio apagado o
conversación con una persona| X[no responde]
    I --> A[agente
Claude + reglas + memoria]
    A -->|pide herramientas| H[herramientas
atadas al teléfono que escribe]
    H --> A
    H -->|escaló| E[cierre_escalado
avisa al equipo y pausa el bot]
    H -->|el negocio no responde| FA[falla
no inventa · avisa al desarrollador]
    A -->|demasiados pasos| L[limite_pasos]
    A -->|responde| M[memoria
resumen con modelo rápido]
    E --> M
    L --> M

Pieza	Dónde	Qué hace
Orquestación	app/grafo.py	Grafo de LangGraph con rutas para responder, escalar, fallar y cortar bucles
Herramientas	app/herramientas.py	buscar_productos, consultar_mis_pedidos, `consul