Andrea y los leads: el mapa v2 (27-oct) y la historia de octubre

Versión vigente. Se genera desde bot/MAPA-ANDREA-Y-RESCATES.md; lo anterior quedó clasificado en DOCUMENTACION.md.

0. Lo vigente desde la v2 (27-oct)

Sale del manual "Sistema de leads y seguimiento v2" (NONDA, 27-oct), transcrito regla por regla en bot/CRITERIOS-ACEPTACION-V2.md (sección G). Cuando algo de las secciones 1 a 5 choca con esto, manda esto. Lo marcado [Propuesta NONDA] o [por confirmar] sigue así hasta que la clínica lo confirme.

Ninguna tarjeta cambia de etapa por tiempo. Lunes 9:00: Recepción revisa Urgencias, luego los Calientes de Andrea, luego lo demás que dejó Andrea. Andrea informa, califica y deja listo; no agenda, no confirma horas, no envía datos de pago y no opina de casos clínicos. En horario de Recepción, Andrea no responde.

flowchart LR
    N["Nuevo<br/>escribe por primera vez"] --> F["Frío<br/>respondió sus dudas<br/>y no volvió"]
    N --> T["Tibio<br/>pide una cita"]
    N --> C["Caliente<br/>Recepción: fecha y hora<br/>Andrea: nombre, DNI y fecha"]
    N --> A["Atendido por Andrea<br/>antiguo, descuento,<br/>fuera de su lista"]
    N --> U["Urgencias<br/>dolor, emergencia, reclamo"]
    N --> R["Recontactar<br/>pide más adelante<br/>tarea con fecha"]
    F -->|responde| T
    T -->|da sus datos| C
    R --> T & C
    A -->|Recepción decide| T & C & R
    C -->|valida el Yape| AG["Agendado"]
    U -->|termina en cita| AG
    AG --> AT["Atendió"] --> V["Venta"]
    AG --> NS["No Show"]

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

0.1 Cómo se califica: por lo que el lead hace, nunca por impresión; con duda, la temperatura más baja

Un Caliente de Andrea tiene un día posible, sin hora. A primera hora Recepción le ofrece las horas libres de ese día, confirma una y envía los datos del Yape; al validar el pago, la tarjeta pasa a Agendado. Si el último mensaje del lead tiene más de 24 h, llamada; si no contesta, plantilla 2 "Retomar tu consulta" [Propuesta NONDA]. Control de Andrea [Propuesta NONDA]: Recepción revisa a las 9:00, confirma o corrige la etapa y marca Corregido (botón de la pestaña Hoy del panel, campo "Corregido por Jennifer" en GHL). Si en 2 semanas corrige más de 1 de cada 10, revisión con Hernán.

0.2 Hasta dónde responde Andrea

Los mensajes fijos dicen cuándo escribe la asesora según la hora de Lima: de lunes a sábado entre 0:00 y 8:59, "hoy a las 9am"; de lunes a viernes después de las 18:00, "mañana a las 9am"; sábado desde las 15:00 y domingo, "el lunes a las 9am"; feriado, el siguiente día hábil.

0.3 Las etapas, una por una

Los renombres conservan el ID de la etapa: Lead en Prospección pasa a Frío, Lead Caliente (Hoy) a Caliente, Leads Calientes Por Recontactar a Recontactar y Sporte a Urgencias. Tibio y Atendido por Andrea son etapas nuevas.

0.4 Reglas fijas del sistema

0.5 La mañana de Recepción en el panel (pestaña Hoy)

0.6 Cadencia según el origen

0.7 Cómo lo aplica Andrea (código, desde el 29-oct)

El bloque ANDREA V2 de bot/orquestador/crear_sombra.py (nodo Atención), con la etapa en Movimiento, las etiquetas en Etiquetas y los campos en Cerrar turno. Bitácora 137. Corre en n8n y en el servicio en código.

0.8 Los seguimientos v2: el Vigía (desde el 29-oct)

El flujo de n8n JQJYXWOfos92vz6c (código en bot/orquestador/vigia_v2_decidir.js, publicado por crear_sombra.py) corre cada 5 minutos con las reglas v2 de vigia_cadencias y le pasa cada acción al mismo Ejecutor de Andrea. Bitácora 138. Ninguna regla mueve una tarjeta de etapa. El reloj del servicio en código sigue armando la ficha del lead para el panel y ya no actúa.

Para prenderlo en vivo, en este orden: (1) la clínica aprueba los cuatro textos; (2) en GHL se crean las etapas Tibio y Atendido por Andrea; (3) si ya hay plantillas 1 y 1B aprobadas, su nombre en plantilla_seguimiento_1 / _1b y un workflow de GHL por etiqueta que las mande y quite la etiqueta; (4) reloj_modo = vivo en Encendido: con v4_ejecutor_pct = 0 actúa solo con los 4 contactos de prueba; (5) a los pacientes los alcanza cuando Hernán suba v4_ejecutor_pct (lo mismo que prende a Andrea v2). Volver atrás: reloj_modo = sombra.

Desde acá, el mapa de octubre (5-oct), como historia: la arquitectura de Andrea v4, sus guardrails y la ruta de rescates anterior a la v2.

Corte 5-oct-2026, con la versión que Jennifer probó del 22-set al 3-oct (43 casos de prueba en verde). Todo lo que dice este documento está leído del sistema vivo: código de bot/orquestador/crear_sombra.py, tablas del Supabase del bot, flujos de n8n, workflows de GHL y una muestra de 400 conversaciones de septiembre.

1. Cómo se trabaja

Ningún arreglo se hace alargando el prompt. Cada corrección de la clínica termina en una de cinco palancas y queda como caso de prueba que se vuelve a correr antes de publicar.

flowchart LR
    A["Jennifer prueba en el panel<br/>pestaña Probar"] --> B["Marca 👎 y escribe<br/>lo que esperaba"]
    B --> C["Se clasifica la corrección<br/>familia y palanca<br/>orquestador_correcciones"]
    C --> D{"¿Qué palanca?"}
    D -->|"un dato"| E["Fila de tabla<br/>catálogo · promos · datos operativos"]
    D -->|"un texto que la clínica escribió"| F["Respuesta aprobada<br/>bot_respuestas_clinica"]
    D -->|"una regla de negocio"| G["Hecho o regla en código<br/>Atención"]
    D -->|"algo que nunca debe salir"| H["Guarda que bloquea"]
    D -->|"lo leyó mal"| I["Campo del Lector"]
    E & F & G & H & I --> J["Caso nuevo en<br/>casos-resueltos.json"]
    J --> K["Suite completa<br/>43 de 43 en verde"]
    K -->|"rojo"| D
    K -->|"verde"| L["Se publica la sombra<br/>+ bitácora + respaldo + commit"]
    L --> M["Mensaje corto a la clínica<br/>qué se corrigió y cómo re-probarlo"]
    M --> A

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

Reglas del ciclo:

1. La clínica escribe el texto, el sistema lo usa tal cual. Si Jennifer sugiere una respuesta, entra como respuesta aprobada y la guarda exige que salga.
2. Un arreglo, un caso de prueba. Si no se puede probar, no se da por cerrado.
3. Se corre la suite completa antes de publicar, porque un arreglo puede romper otro (pasó con "Lamento" contra "Lamentamos", y con "hija" que mandaba a odontopediatría).
4. Todo cambio cierra con bitácora (bot/estado-actual-andrea.md, secciones 71 a 75 para esta etapa), respaldo (python3 bot/backup_workflows.py) y commit.

2. La arquitectura

flowchart TB
    subgraph CANAL["Canal"]
        WA["WhatsApp +51 946 887 452"] --> GHL["GHL<br/>contactos · tarjetas · tags"]
        IG["Instagram / Messenger"] --> GHL
        PANEL["Panel · Probar<br/>la clínica escribe como paciente"]
    end

    subgraph N8N["n8n"]
        F1["Flujo 1 · bot vivo v3<br/>APAGADO desde el 21-set"]
        ORQ["Orquestador v4"]
        VIG["Vigía · cada hora<br/>decide toques y etapas"]
        DL["Dentalink · 2<br/>cupos reales, solo lee"]
    end

    subgraph V4["Un turno de Andrea v4"]
        direction TB
        CTX["1 · Contexto<br/>tablas + estado de la conversación"] --> LEC["2 · Lector<br/>modelo lee TODO el hilo<br/>y devuelve datos, no texto"]
        LEC --> ATE["3 · Atención · código<br/>elige el carril y arma los hechos"]
        ATE --> AG{"¿Pide o acepta cita?"}
        AG -->|"sí"| CUP["4 · Cupos de Dentalink<br/>sillón 1 · doctora pedida · día pedido"]
        AG -->|"no"| MOV
        CUP --> MOV["5 · Movimiento<br/>etapa y tarea de la tarjeta"]
        MOV --> ETQ["6 · Etiquetas"]
        ETQ --> RED["7 · Redactor · modelo<br/>escribe SOLO con los hechos"]
        RED --> GUA["8 · Guardas<br/>bloquean, no reescriben"]
        GUA -->|"falla"| REP["9 · Reparar<br/>segundo intento con la falla dicha"]
        REP --> GUA2["Guardas 2"]
        GUA2 -->|"vuelve a fallar"| FB["Respaldo<br/>respuesta aprobada o texto fijo"]
        GUA -->|"pasa"| OUT["10 · Cerrar turno<br/>saludo de la clínica · registro"]
        GUA2 -->|"pasa"| OUT
        FB --> OUT
    end

    subgraph DATOS["Supabase · lo que la clínica cambia sin código"]
        T1["bot_catalogo<br/>precios y evaluaciones"]
        T2["promociones<br/>con fecha de fin"]
        T3["orquestador_carriles<br/>qué decir en cada situación"]
        T4["bot_respuestas_clinica<br/>textos aprobados"]
        T5["bot_datos_operativos<br/>horario · voz · frases vetadas · perillas"]
        T6["agenda_doctoras / agenda_ruteo<br/>quién atiende qué"]
    end

    WA -.-> F1 --> ORQ
    PANEL --> ORQ
    ORQ --> CTX
    CUP <--> DL
    DATOS --> CTX
    OUT --> GHL
    VIG --> GHL

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

Lo que importa de este diseño:

• El modelo no decide nada. El Lector solo lee (¿pidió precio?, ¿quiere cita?, ¿para quién?) y el Redactor solo

escribe. Qué se dice, a qué etapa va la tarjeta y si se deriva lo decide código con reglas que se pueden probar.

• Nada se decide por texto literal. La intención sale de la lectura de toda la conversación, con redes de código

para los casos que el Lector falla (fecha de cita, "para mi hija", "pásame con una persona").

• Toda cifra sale de una tabla. Si un precio no está en los hechos del turno, la guarda bloquea el mensaje.

El orden en que se elige qué decir (carriles)

flowchart TD
    S(["Mensaje del paciente"]) --> M{"¿Silencio?<br/>no contactar · en pausa<br/>ya derivado · Recepción escribió"}
    M -->|"sí"| MU["mudo: Andrea no contesta"]
    M -->|"no"| D{"¿Se despide?"}
    D -->|"sí"| DE["despedida: una frase cálida"]
    D -->|"no"| RA{"¿Respuesta aprobada<br/>que deriva?<br/>reclamo · devolución · libro · dolor"}
    RA -->|"sí"| DA["deriva-asesora"]
    RA -->|"no"| G{"¿Garantía o queja<br/>de un trabajo hecho?"}
    G -->|"sí"| GQ["garantía: lamenta y coordina revisión"]
    G -->|"no"| PP{"¿Pide una persona?"}
    PP -->|"sí"| PE["pide-persona: deriva"]
    PP -->|"no"| FA{"¿Algo que no hacemos<br/>o propuesta comercial?"}
    FA -->|"sí"| FX["fuera-de-alcance"]
    FA -->|"no"| PA{"¿Reportó un pago?"}
    PA -->|"sí"| PG["pago: Recepción valida"]
    PA -->|"no"| FL{"¿Está fuera de Lima?"}
    FL -->|"sí"| FV["evaluación virtual"]
    FL -->|"no"| CI{"¿Pide o acepta la cita<br/>con el precio ya dado?"}
    CI -->|"sí"| AGE["agenda: cupos reales<br/>o una asesora confirma"]
    CI -->|"no"| RH{"¿Prótesis, piezas faltantes,<br/>trabajo previo?"}
    RH -->|"sí"| RE["rehabilitación: evaluación<br/>especializada, sin estética"]
    RH -->|"no"| AN{"¿Vino por un anuncio?"}
    AN -->|"botón reservar"| PB["pregunta el tratamiento"]
    AN -->|"promo"| PR["da la promo con su precio"]
    AN -->|"no"| TR{"¿Dijo el tratamiento?"}
    TR -->|"pidió precio"| PC["precio + evaluación"]
    TR -->|"sin pedir precio"| GE["presenta el servicio sin cifras"]
    TR -->|"pregunta concreta"| PD["pregunta-directa"]
    TR -->|"nada aún"| SA["saludo: ¿qué tratamiento buscas?"]

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

3. Los guardrails

Cada uno bloquea el mensaje y obliga a reescribirlo; si el segundo intento falla, sale la respuesta aprobada o el texto fijo del carril. Nunca sale un mensaje que viole uno de estos.

mindmap
  root((Guardas))
    Precios
      Solo cifras de las tablas
      No repetir un precio ya dicho
      No dar precio si no lo pidió
      Promo con su precio regular como antes
      Promo con sus condiciones
      Nada es gratis
      No cobrar aparte la evaluación incluida
    Agenda
      Solo horas de los cupos reales
      Domingo cerrado
      Nunca dice que no hay cupos, se valida
      Sillón 1 para todas las doctoras
      Máximo 4 pacientes por hora
      Solo confirma el cupo elegido
      Día u hora sin cupo se dice
    Derivación
      Paso de mano solo si deriva
      Una sola vez por mensaje
      Una de nuestras asesoras, nunca Jennifer
    Clínico
      Sin estética en rehabilitación
      Servicios que no existen
      Plazos solo de las tablas
      Respuesta aprobada se usa literal
    Tono
      Máximo 420 caracteres
      Sin muletillas ni frases vetadas
      Sin listas de tratamientos
      No habla del sistema
      Saludo de la clínica al inicio
    Negocio
      Propuestas comerciales a Dirección
      Ubicación no se pregunta
      Cerca solo con distrito vecino

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

Lo que quedó establecido con las pruebas de la clínica (22-set al 3-oct)

4. La ruta del lead con sus rescates

4.1 Cómo está diseñada hoy

stateDiagram-v2
    direction LR
    [*] --> NuevoLead: escribe por primera vez
    NuevoLead --> LeadCaliente: pide cita o acepta precio
    NuevoLead --> NuevoLead: toque 1 a las 3 h<br/>30 min si quiso agendar hoy
    NuevoLead --> NuevoLead: toque 2 a las 6 h
    NuevoLead --> Prospeccion: 48 h callado
    LeadCaliente --> Recontactar: 24 h callado
    Recontactar --> Recontactar: plantilla 48 h<br/>día 7 · día 30
    Recontactar --> LeadCaliente: vuelve a escribir
    Prospeccion --> Prospeccion: cola manual para Recepción
    Prospeccion --> NuevoLead: vuelve a escribir
    Prospeccion --> Perdido: 14 días callado
    LeadCaliente --> Agendado: cita creada
    Agendado --> Atendio
    Agendado --> NoShow
    Atendio --> Venta
    Perdido --> [*]: campaña mensual a la base

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

Nueve etapas, siete toques distintos y una cola manual. Es más de lo que la clínica puede seguir, y la auditoría dice que la mitad no rinde.

4.2 Lo que encontró la auditoría

a) Cuánto contesta la gente a cada toque (muestra de 400 leads de septiembre, respuesta dentro de 48 h):

El primer toque y la plantilla a quien ya tenía precio rinden. El segundo toque del mismo día rinde 0 y la cola manual nunca funcionó: se generaba y nadie la abría.

b) Lo que pasa hoy, con el bot apagado desde el 21-set:

• Los leads nuevos no tienen tarjeta. La tarjeta la creaba el flujo 1. La semana del 21-set nacieron 55 tarjetas

y la del 28-set ninguna, contra 375 por semana antes. El tablero ya no refleja la demanda.

• Recepción contesta a mano, tarde. Muestra de 60 leads del 23-set al 1-oct: 49 contestados en el día, 8 después y

2 nunca. Mediana: 11.5 horas desde el primer mensaje. Con el bot eran segundos, y en agosto, cuando Recepción contestaba al derivado en menos de 2 h, cerraba el 59% contra 29% después.

• Los rescates están apagados y el archivo sigue prendido. Los flujos de toques (3, 12, 14, 15) están apagados; el 8

(enfriar) y el 11 (archivar a Perdido) siguen corriendo. Prospección bajó de 676 tarjetas a 185 en dos semanas: unas 490 personas salieron del tablero sin un solo intento de rescate.

4.3 La ruta propuesta: tres rescates y nada más

stateDiagram-v2
    direction LR
    [*] --> Conversando: escribe · Andrea contesta al instante
    Conversando --> QuiereCita: pide cita o acepta precio
    Conversando --> Seguimiento: se queda callado
    state Seguimiento {
        direction LR
        R1: Rescate 1 · a las 3 h<br/>mensaje libre
        R2: Rescate 2 · día 2<br/>plantilla, solo si ya tenía precio
        R3: Rescate 3 · fin de mes<br/>campaña de la promo del mes
        R1 --> R2: sigue callado
        R2 --> R3: sigue callado
    }
    Seguimiento --> Conversando: contesta
    Seguimiento --> Frio: 14 días sin respuesta
    QuiereCita --> Agendado: cupo elegido o Recepción confirma
    Agendado --> Atendio
    Atendio --> Venta
    Frio --> [*]: queda en la base para campañas

Rueda para acercar, arrastra para moverte, doble clic para ajustar.

Se apaga: el toque de 6 h, el segundo toque del mismo día, el día 7, el día 30 y la cola manual de Prospección. Se fusionan Recontactar y Prospección en una sola etapa automática, Seguimiento, que Recepción no tiene que mirar. Recepción solo ve dos columnas: Quiere cita y Agendado.

4.4 Inventario de activos: qué queda y qué se apaga

4.5 Cómo se le explica a la clínica

Andrea contesta al instante a cada persona que escribe. Si la persona se queda callada, la buscamos tres veces: a las 3 horas, al día siguiente si ya le dimos precio, y en la campaña del mes. Recepción solo ve a quien quiere cita. Todo lo demás corre solo.

5. Lo que hay que decidir, en orden

1. Encender la v4 en vivo. Es la palanca más grande: hoy cada lead espera una mediana de 11.5 horas y no tiene tarjeta.
2. Pausar el flujo 11 (archivar a Perdido) mientras los rescates estén apagados: hoy se archivan unas 245 personas por semana sin haberlas buscado.
3. Aprobar la ruta de tres rescates y el tablero de dos columnas para Recepción (cambia el pipeline de GHL).
4. Confirmar la plantilla del rescate 2: la que ya manda el workflow 48h Recontact WhatsApp de GHL.