# cuentas-ailink/crm-whatsapp-ia architecture

> Architecture diagram of the GitHub repository cuentas-ailink/crm-whatsapp-ia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cuentas-ailink/crm-whatsapp-ia
- Repository: https://github.com/cuentas-ailink/crm-whatsapp-ia

## Overview

CRM de WhatsApp con IA: el cliente contacta por WhatsApp o el formulario web; el sistema procesa la solicitud, conversa con Claude, propone y reserva citas, y deriva al negocio cuando hace falta. El panel permite gestionar leads, conversaciones y agenda, y configurar el negocio y sus conexiones. El grafo conserva las etapas y capacidades documentadas; sus relaciones se limitan a las que muestra el README o los archivos indexados como leídos/excerptados.

Main entry points: [`lib/bd.ts`](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/bd.ts) (Datos CRM), [`lib/proceso.ts`](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/proceso.ts) (Proceso conversacional), [`app/webhook/route.ts`](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/webhook/route.ts) (Webhook WhatsApp), [`cliente/panel.tsx`](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/cliente/panel.tsx) (Panel CRM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inbound["Entrada y conversación"]
  node_web["Web y formulario<br/>[page.tsx]"]
  node_lead["Alta de solicitud<br/>[route.ts]"]
  node_webhook["Webhook WhatsApp<br/>[route.ts]"]
  node_conversation["Proceso conversacional<br/>[proceso.ts]"]
  node_assistant["Asistente IA<br/>[asistente.ts]"]
  node_voice["Transcripción de voz<br/>[transcripcion.ts]"]
end

subgraph group_business["Gestión comercial"]
  node_panel["Panel CRM<br/>[panel.tsx]"]
  node_leads["Leads y etapas<br/>[negocio.ts]"]
  node_appointments["Agenda y citas<br/>[agenda.ts]"]
  node_human["Derivación a persona<br/>[route.ts]"]
  node_followup["Retomar conversación<br/>[retomar.ts]"]
end

subgraph group_setup["Configuración y conexiones"]
  node_configui["Ajustes y puesta"]
  node_configapi["API de configuración<br/>[route.ts]"]
  node_configserver["Configuración activa"]
  node_presets["Presets de negocio<br/>[index.ts]"]
  node_meta["Integración Meta<br/>[meta.ts]"]
  node_tunnel["Túnel público<br/>[tunel.ts]"]
end

subgraph group_storage["Persistencia e infraestructura"]
  node_db[("Datos CRM<br/>[bd.ts]")]
  node_events["Eventos de actualización<br/>[eventos.ts]"]
  node_shared["Tipos y contratos<br/>[tipos.ts]"]
  node_rules["Reglas de prueba"]
end

node_customer(("Cliente"))
node_owner(("Negocio"))
node_claude{{"Claude"}}
node_whatsapp{{"WhatsApp Meta"}}

node_customer -->|"inicia solicitud"| node_web
node_web -->|"envía formulario"| node_lead
node_customer -->|"envía mensaje"| node_webhook
node_whatsapp -->|"entrega eventos"| node_webhook
node_webhook -->|"procesa mensaje"| node_conversation
node_lead -.->|"registra solicitud"| node_db
node_webhook -->|"guarda actividad"| node_db
node_webhook -->|"publica cambios"| node_events
node_conversation -.->|"genera respuesta"| node_assistant
node_conversation -.->|"lee y actualiza leads"| node_db
node_assistant -.->|"consulta modelo"| node_claude
node_voice -.->|"aporta transcripción"| node_conversation
node_conversation -->|"consulta huecos"| node_appointments
node_conversation -->|"envía respuesta"| node_whatsapp
node_appointments -.->|"persiste reservas"| node_db
node_panel -->|"presenta trabajo diario"| node_owner
node_panel -->|"gestiona etapas"| node_leads
node_panel -->|"muestra agenda"| node_appointments
node_panel -.->|"lee datos CRM"| node_db
node_owner -->|"toma conversación"| node_human
node_human -.->|"avisa al negocio"| node_whatsapp
node_owner -->|"retoma cliente"| node_followup
node_followup -->|"envía plantilla"| node_meta
node_configui -.->|"guarda ajustes"| node_configapi
node_configapi -->|"actualiza configuración"| node_configserver
node_configserver -->|"lee configuración"| node_db
node_configserver -->|"resuelve preset"| node_presets
node_configui -->|"conecta cuenta"| node_meta
node_tunnel -->|"notifica URL"| node_meta
node_meta -->|"configura webhook"| node_whatsapp
node_db -->|"notifica cambios"| node_events
node_rules -.->|"valida modo prueba"| node_webhook
node_leads -.->|"usa estados tipados"| node_shared
node_appointments -->|"usa tipos de cita"| node_shared

click node_web "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/page.tsx"
click node_lead "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/lead/route.ts"
click node_webhook "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/webhook/route.ts"
click node_conversation "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/proceso.ts"
click node_assistant "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/asistente.ts"
click node_voice "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/transcripcion.ts"
click node_panel "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/cliente/panel.tsx"
click node_leads "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/negocio.ts"
click node_appointments "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/agenda.ts"
click node_human "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/api/pasar-a-persona/route.ts"
click node_followup "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/retomar.ts"
click node_configui "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/cliente/puesta-en-marcha.tsx"
click node_configapi "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/api/configuracion/route.ts"
click node_configserver "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/configuracion-servidor.ts"
click node_presets "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/presets/index.ts"
click node_meta "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/meta.ts"
click node_tunnel "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/tunel.ts"
click node_db "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/bd.ts"
click node_events "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/eventos.ts"
click node_shared "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/tipos.ts"
click node_rules "https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/modo-prueba-reglas.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_lead,node_webhook,node_conversation,node_assistant,node_voice,node_customer toneBlue
class node_panel,node_leads,node_appointments,node_human,node_followup toneAmber
class node_configui,node_configapi,node_configserver,node_presets,node_meta,node_tunnel toneMint
class node_db,node_events,node_shared,node_rules toneRose
class node_owner,node_claude,node_whatsapp toneIndigo
```

## Components

### Entrada y conversación

- [Web y formulario](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/page.tsx): `app/page.tsx`
- [Alta de solicitud](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/lead/route.ts): `app/lead/route.ts`
- [Webhook WhatsApp](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/webhook/route.ts): `app/webhook/route.ts`
- [Proceso conversacional](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/proceso.ts): `lib/proceso.ts`
- [Asistente IA](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/asistente.ts): `lib/asistente.ts`
- [Transcripción de voz](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/transcripcion.ts): `lib/transcripcion.ts`

### Gestión comercial

- [Panel CRM](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/cliente/panel.tsx): `cliente/panel.tsx`
- [Leads y etapas](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/negocio.ts): `lib/negocio.ts`
- [Agenda y citas](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/agenda.ts): `lib/agenda.ts`
- [Derivación a persona](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/api/pasar-a-persona/route.ts): `app/api/pasar-a-persona/route.ts`
- [Retomar conversación](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/retomar.ts): `lib/retomar.ts`

### Configuración y conexiones

- [Ajustes y puesta](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/cliente/puesta-en-marcha.tsx): `cliente/puesta-en-marcha.tsx`
- [API de configuración](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/app/api/configuracion/route.ts): `app/api/configuracion/route.ts`
- [Configuración activa](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/configuracion-servidor.ts): `lib/configuracion-servidor.ts`
- [Presets de negocio](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/presets/index.ts): `lib/presets/index.ts`
- [Integración Meta](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/meta.ts): `lib/meta.ts`
- [Túnel público](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/tunel.ts): `lib/tunel.ts`

### Persistencia e infraestructura

- [Datos CRM](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/bd.ts): `lib/bd.ts`
- [Eventos de actualización](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/eventos.ts): `lib/eventos.ts`
- [Tipos y contratos](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/tipos.ts): `lib/tipos.ts`
- [Reglas de prueba](https://github.com/cuentas-ailink/crm-whatsapp-ia/blob/main/lib/modo-prueba-reglas.ts): `lib/modo-prueba-reglas.ts`

### Other components

- **Cliente**
- **Negocio**
- **Claude**
- **WhatsApp Meta**

## Connections

- Cliente → Web y formulario: inicia solicitud
- Web y formulario → Alta de solicitud: envía formulario
- Cliente → Webhook WhatsApp: envía mensaje
- WhatsApp Meta → Webhook WhatsApp: entrega eventos (evidence: `app/webhook/route.ts`)
- Webhook WhatsApp → Proceso conversacional: procesa mensaje (evidence: `app/webhook/route.ts`)
- Alta de solicitud → Datos CRM: registra solicitud
- Webhook WhatsApp → Datos CRM: guarda actividad (evidence: `app/webhook/route.ts`)
- Webhook WhatsApp → Eventos de actualización: publica cambios (evidence: `app/webhook/route.ts`)
- Proceso conversacional → Asistente IA: genera respuesta
- Proceso conversacional → Datos CRM: lee y actualiza leads
- Asistente IA → Claude: consulta modelo
- Transcripción de voz → Proceso conversacional: aporta transcripción
- Proceso conversacional → Agenda y citas: consulta huecos
- Proceso conversacional → WhatsApp Meta: envía respuesta
- Agenda y citas → Datos CRM: persiste reservas
- Panel CRM → Negocio: presenta trabajo diario
- Panel CRM → Leads y etapas: gestiona etapas
- Panel CRM → Agenda y citas: muestra agenda
- Panel CRM → Datos CRM: lee datos CRM
- Negocio → Derivación a persona: toma conversación
- Derivación a persona → WhatsApp Meta: avisa al negocio
- Negocio → Retomar conversación: retoma cliente
- Retomar conversación → Integración Meta: envía plantilla (evidence: `app/api/retomar/route.ts`)
- Ajustes y puesta → API de configuración: guarda ajustes
- API de configuración → Configuración activa: actualiza configuración (evidence: `app/api/configuracion/route.ts`)
- Configuración activa → Datos CRM: lee configuración (evidence: `lib/configuracion-servidor.ts`)
- Configuración activa → Presets de negocio: resuelve preset (evidence: `lib/configuracion-servidor.ts`)
- Ajustes y puesta → Integración Meta: conecta cuenta
- Túnel público → Integración Meta: notifica URL (evidence: `lib/tunel.ts`)
- Integración Meta → WhatsApp Meta: configura webhook
- Datos CRM → Eventos de actualización: notifica cambios (evidence: `lib/bd.ts`)
- Reglas de prueba → Webhook WhatsApp: valida modo prueba (evidence: `app/webhook/route.ts`)
- Leads y etapas → Tipos y contratos: usa estados tipados (evidence: `lib/negocio.ts`)
- Agenda y citas → Tipos y contratos: usa tipos de cita (evidence: `lib/agenda.ts`)
