# MergeOn Seller — Documentación Técnica para LLMs
# Generado: 2026-05-03 | Versión: 1.1 | Idioma: es-AR
# Markdown puro: GET /docs/<slug> con header Accept: text/markdown

## SISTEMA
MergeOn Seller es una plataforma de ventas automatizada con agente de IA para WhatsApp e Instagram.
Gestiona flujos automáticos, seguimiento de leads, mensajes masivos y métricas de conversión.

## MÓDULOS

### 1. FLUJOS PERSONALIZADOS (/docs/flows)
Automatizaciones que se activan ante eventos. Se crean desde "Nuevo Flujo".

Tipos de activación (etiqueta en UI → comportamiento):
- "Cuando entra un mensaje" → cualquier mensaje recibido, filtrable por condiciones
- "Primer mensaje del contacto" → solo la primera vez que un contacto escribe
- "Cuando se realiza una venta" → al confirmar pago o pedido
- "Cuando comentan en Instagram" → comentarios en publicaciones propias
- "Chatbot" → menú interactivo con pasos y opciones ramificadas
- "Respuesta a historia" → respuestas a historias de Instagram (botón Historia)

Condiciones disponibles (filtros opcionales):
- "Texto exacto" → mensaje igual al texto configurado (soporta múltiples textos)
- "Palabra clave" → mensaje que contiene la palabra
- "Longitud del mensaje" → mayor, menor o igual a N caracteres

Acciones disponibles:
- "Enviar Mensaje de Texto" → texto libre con variables {{name}}, {{total}}
- "Enviar Template" → plantilla oficial Meta, necesaria fuera de ventana 24h
- "Enviar Imagen" → imagen con caption opcional
- "Responder Comentario" → respuesta a comentario de Instagram

Campo "Continuar con el agente de IA": activado=agente sigue; desactivado=flujo es punto final.

Chatbot: pasos con "Mensaje del paso", "Mensaje si opción no válida", "Máximo de intentos fallidos", opciones con input+destino.
Campos del chatbot: "Texto para iniciar el árbol", "Tiempo de espera", "Mensaje al finalizar el tiempo de espera".

### 2. NURTURING Y REMARKETING (/docs/nurturing)
Seguimiento de leads por estados. Cada contacto tiene una pastilla de color.

Estados (etiqueta en UI → color hex):
- "Lead" → azul #3B82F6 (primer contacto, interés inicial)
- "Warm" → naranja #F97316 (preguntó por precio/disponibilidad)
- "Propuesta" → violeta #8B5CF6 (propuesta enviada, esperando respuesta)
- "Vendido" → verde #10B981 (compra confirmada)
- "Nurturing" → teal #14B8A6 (seguimiento pasivo)
- "Frío" → gris #64748B (sin respuesta prolongada)
- "Descartado" → rojo #EF4444 (fuera del público objetivo)

Cambio de estado: manual desde pastilla en Conversaciones o desde CRM; o automático por el agente.

Configuración en "Agentes IA": cards con pastilla verde "Configurado" o azul "Pendiente".
- Card "Remarketing" → prompt base con 4 secciones: "Instrucción base del agente", "Estado: Lead", "Estado: Warm", "Estado: Vendido" + "Información adicional"
- Cards individuales: "Remarketing Lead", "Remarketing Warm", "Remarketing Vendido", "Remarketing Nurturing", "Remarketing Frío", "Remarketing Propuesta", "Remarketing Descartado"

Mensajes masivos: requieren plantilla oficial Meta. Audiencia por estado, etiqueta o CSV.

### 3. HERRAMIENTAS DEL AGENTE (/docs/tools)
Se configuran en "Agentes IA" → panel "Tools disponibles en tu plan". Checkbox por herramienta. Botón "Guardar tools".

Herramientas (etiqueta en UI):
- "Buscar producto" → busca en catálogo por descripción
- "Crear pedido" → registra pedido (requiere nombre, teléfono, producto, dirección)
- "Crear consulta" → registra reclamo o consulta para seguimiento
- "Escalar a humano" → pausa el agente, alerta al equipo
- "Enviar mensaje libre (24h)" → texto libre solo dentro de ventana activa
- "Enviar plantilla oficial" → plantilla Meta, funciona fuera de 24h
- "Enviar foto de producto" → imagen del catálogo
- "Agendar cita/turno" → crea evento en calendario
- "Ver eventos del calendario" → consulta disponibilidad
- "Verificar disponibilidad" → muestra horarios libres
- "Cancelar cita" → cancela evento agendado

Plan Básico: primeras 4 herramientas. Plan Pro y B2B: todas.

### 4. CONVERSACIONES (/docs/chats)
Bandeja de chats WhatsApp e Instagram. Panel izquierdo (lista) + panel derecho (chat activo).

Lista: 50 conversaciones por carga, scroll infinito, polling automático de nuevos mensajes.
Filtros: buscar por nombre/número, estado del lead, canal (WA/IG).

Tipos de mensaje: texto, imagen, plantilla, audio, archivo, badge "IA" para agente, mensaje de sistema.

Acciones desde barra inferior:
- Mensaje de texto libre (solo en ventana 24h activa)
- Botón de plantilla → seleccionar + completar variables + "Enviar plantilla"
- Botón de producto → buscar + seleccionar imagen
- "Crear pedido" → formulario inline con datos del contacto pre-cargados
- "Ver en CRM" → panel lateral con ficha del contacto editable

Gestión del lead desde el chat:
- Clic en pastilla de color → menú de estados → cambio inmediato
- "Escalar a humano" → agente pausa; "Reactivar agente" → agente retoma

### 5. SUPERVISIÓN Y MÉTRICAS (/docs/supervision)
Tab "Analytics" con métricas de rendimiento.

KPIs principales:
- "Revenue Managed" → valor total pedidos procesados (hero stat, superior izquierdo)
- Pedidos automáticos vs. manuales
- Tiempo de respuesta del agente (objetivo: <30 segundos)
- Estado de CAPI
- Tasa de conversión (Lead → Warm → Vendido)

Indicadores de canal: punto verde = conectado, punto rojo = desconectado. Reconexión desde Integraciones.

Conversaciones escaladas: badge "Requiere atención". Flujo: filtrar → leer motivo → responder manualmente → "Marcar como resuelto" → "Reactivar agente".

Errores en pantalla:
- "Error al ejecutar herramienta" → revisar catálogo/datos
- "Plantilla rechazada" → verificar en Meta Business
- "Canal desconectado" → reconectar en Integraciones
- "Límite de mensajes superado" → esperar y redistribuir
- "Error al crear pedido" → revisar lista de pedidos

Benchmarks saludables: resolución automática >70%, escalado <15%, primera respuesta <30s.

Roles: Administrador (acceso total), Agente (solo conversaciones), Viewer (solo lectura).
Gestión de roles: Admin → Usuarios.

## CÓMO OBTENER MARKDOWN PURO
curl -H "Accept: text/markdown" https://docs.mergeonseller.com/docs/flows
curl -H "Accept: text/markdown" https://docs.mergeonseller.com/docs/nurturing
curl -H "Accept: text/markdown" https://docs.mergeonseller.com/docs/tools
curl -H "Accept: text/markdown" https://docs.mergeonseller.com/docs/chats
curl -H "Accept: text/markdown" https://docs.mergeonseller.com/docs/supervision