Docs
← Al sitio
Empezar · Introducción

Documentación de Eforia

Eforia es la capa de inteligencia que reúne lo que las personas dicen por los canales que ya usan, lo clasifica con IA y lo convierte en decisiones. Esta guía explica, en detalle, qué es el motor, de qué está hecho y cómo funciona por dentro.

Qué es Eforia

Las organizaciones reciben información valiosa todo el día —reclamos, consultas, reportes, solicitudes— repartida en conversaciones que nadie lee como un todo. Eforia se para sobre esos canales, entiende cada mensaje con inteligencia artificial, lo deriva a quien corresponde y devuelve un estado a quien escribió. Encima corre una capa de análisis para decidir con evidencia.

Es una plataforma horizontal: el motor es el mismo para todos los rubros y solo cambia el vocabulario. Se construye una vez y se enchufa por vertical con una plantilla que define categorías, responsables y prioridades.

Esta documentación describe cómo funciona el motor hoy. Lo que aún no existe (API pública, integraciones con terceros) no aparece hasta que esté construido y probado.

Sonar, Kapta y Pulso

El motor se expresa en tres productos que comparten la misma base:

  • Sonarcapta y clasifica cada mensaje, devuelve el folio y lo deriva al responsable.
  • Kaptaubica cada caso en el mapa y estructura el territorio.
  • Pulsoconvierte lo captado en temas recurrentes, tendencias y radiografías para decidir.

Cómo leer esta guía

Si quieres el panorama, sigue «La plataforma» y «El ciclo del motor». Si te interesa un paso puntual, salta a «Captación», «Clasificación con IA» o «Gestión y derivación». Los «Conceptos» te dejan leer cualquier respuesta del motor.

Empezar · La plataforma

La plataforma

Eforia no es un chatbot ni una bandeja de mensajes. Es un sistema completo que recibe, entiende, resuelve y aprende. Estos son sus componentes.

Los componentes

  • Captación omnicanal. Recibe mensajes por los canales que la gente ya usa. Hoy: WhatsApp.
  • Clasificador con IA. Lee cada mensaje y lo estructura: tipo, urgencia, ubicación y un resumen limpio.
  • Mapa territorial (Kapta). Ubica cada caso y muestra dónde se concentra lo que la gente reporta.
  • Panel de gestión. Cambia estados, asigna responsables, fija plazos y deriva por WhatsApp.
  • Folios y seguimiento. Devuelve un folio a quien reportó y le permite consultar el estado sin cuenta.
  • Inteligencia (Pulso). Sobre los datos ya levantados: temas recurrentes, tendencias y radiografías.

Cómo encajan

Un mensaje entra por la captación, el clasificador lo estructura, Kapta lo ubica, el panel lo deriva y devuelve un folio, y todo lo captado alimenta a Pulso. Es un flujo, no módulos sueltos: cada pieza usa lo que produjo la anterior.

flujo
WhatsApp ─▶ Clasificador IA ─▶ Kapta (mapa) ─▶ Panel ─▶ Folio + estado
                                                    │
                                                    ▼
                                              Pulso (inteligencia)
Empezar · El ciclo del motor

El ciclo del motor

Cada mensaje que entra recorre el mismo ciclo, sin importar el rubro. Esto es lo que hace de Eforia una plataforma y no un proyecto a medida.

Recibir → Clasificar → Mapear → Derivar → Estado

  • Recibir. El motor escucha los canales que tu gente ya usa (WhatsApp primero) y capta cada mensaje, con texto, ubicación, imagen o nota de voz.
  • Clasificar. La IA lee, estructura y etiqueta por tipo, urgencia y ubicación, y guarda un resumen limpio.
  • Mapear. Cuando aplica, ubica el caso en el territorio para ver dónde se concentra.
  • Derivar. Envía el caso al responsable correcto, con su prioridad y su plazo.
  • Devolver estado. Entrega un folio a quien reportó y actualiza su estado hasta la resolución.

Las dos capas

El ciclo entrega dos niveles de valor:

  • Capa 1 · Captación + Resolución. El core: que nada importante se pierda y que se resuelva rápido.
  • Capa 2 · Inteligencia. Sobre los datos ya levantados: temas recurrentes, tendencias y radiografías con datos abiertos.

Primero se engancha con lo operativo (Capa 1) y, cuando el cliente ya acumuló datos, se suma la inteligencia (Capa 2). Se cobran por separado.

Cómo funciona · Captación por canales

Captación por canales

La regla es simple: recibir la información donde la gente ya está, sin pedirle que aprenda una app nueva ni que cree una cuenta.

WhatsApp, primero

Hoy el canal principal es WhatsApp, sobre la API oficial de Meta (WhatsApp Cloud API). La persona escribe a un número y el motor recibe el mensaje al instante, responde con un folio y sigue la conversación con memoria de contexto.

Qué tipos de mensaje entiende

  • Texto. El caso típico: la persona describe lo que pasa en lenguaje natural.
  • Ubicación. El pin de WhatsApp se usa para geolocalizar el caso en el mapa.
  • Imagen. Una foto del problema (o de un documento) que la IA también puede leer.
  • Nota de voz. Se transcribe automáticamente y se procesa como texto.

Más canales

El motor está pensado para sumar canales sin rehacerse: email y formularios web son directos; Instagram u otros llegan después. Lo que cambia es la puerta de entrada, no el resto del ciclo.

Cómo funciona · Clasificación con IA

Clasificación con IA

Es el corazón del motor: convertir un mensaje en lenguaje natural en un caso estructurado y accionable, en segundos.

Qué extrae

  • Tipo. La categoría dentro de tu taxonomía (por ejemplo «alumbrado público» o «reclamo de despacho»).
  • Urgencia. Un nivel de prioridad para ordenar la cola.
  • Ubicación. Dirección o coordenadas cuando el mensaje las insinúa.
  • Resumen. Una versión corta y limpia para el panel.
  • Señales extra. Detecta varios problemas en un mismo mensaje y marca situaciones sensibles o de vulnerabilidad.
caso estructurado
{
  "folio": "PUC-2048",
  "canal": "whatsapp",
  "tipo": "alumbrado_publico",
  "urgencia": "media",
  "resumen": "Luminaria apagada frente a la plaza",
  "ubicacion": { "lat": -39.28, "lng": -71.97 },
  "estado": "derivado"
}

Tu taxonomía

Defines las categorías una vez y el motor clasifica dentro de ellas. Puedes empezar con la plantilla base de tu rubro y afinarla con casos reales; es más fácil ajustar sobre lo que llega que adivinarlo al inicio.

taxonomia.json
{
  "categorias": [ "alumbrado_publico", "areas_verdes", "basura_y_aseo", "seguridad" ],
  "urgencias": [ "baja", "media", "alta" ]
}

Memoria de conversación

El motor recuerda el hilo con cada persona: si faltan datos, pregunta; si la persona vuelve, retoma su caso. No trata cada mensaje como si empezara de cero.

Los datos personales (teléfono, ubicación exacta) se resguardan; la inteligencia agregada trabaja siempre sobre datos anonimizados.

Cómo funciona · Gestión y derivación

Gestión, mapa y derivación

Clasificar no basta: hay que resolver. Aquí es donde el equipo de la organización toma el caso y lo lleva hasta el cierre.

El panel

Cada caso aparece en un panel con su tipo, urgencia, ubicación y resumen. Desde ahí el equipo cambia el estado, asigna un responsable, fija un plazo y deja notas. Es la bandeja de trabajo de la organización.

El mapa (Kapta)

Cuando el caso tiene ubicación, aparece en un mapa en tiempo real (Leaflet sobre OpenStreetMap, sin costo de API de mapas). Se ve dónde se concentran los casos, se filtran por tipo o prioridad y se leen zonas críticas de un vistazo.

La derivación

Cada caso llega a quien debe resolverlo. Se define por sectores y responsables: el motor envía el caso —con su resumen— por WhatsApp al encargado del sector, sin traspaso manual ni cadenas de correos. La prioridad y el plazo ordenan la cola.

  • recibidoderivadoen_procesoresuelto

Cada rubro puede renombrar los estados a su lenguaje (por ejemplo «en terreno» o «en cocina») sin cambiar el motor.

Conceptos · Reporte, folio y estado

Reporte, folio y estado

Tres conceptos ordenan todo lo que hace el motor. Entenderlos te deja leer cualquier respuesta del sistema.

Reporte

Un reporte es cada mensaje entrante que el motor convierte en un caso estructurado. Guarda el canal, el texto original, la clasificación de la IA y, si aplica, la ubicación.

Folio

El folio es el identificador legible que se devuelve a quien reportó (por ejemplo PUC-2048). Le permite consultar su estado en cualquier momento, sin crear una cuenta.

Estado

El estado refleja dónde va el caso en el ciclo. Los estados base son:

  • recibidoel motor lo captó y clasificó.
  • derivadoestá en manos del responsable.
  • en_procesose está trabajando.
  • resueltose cerró y se avisó a quien reportó.

Quien reportó puede consultar su folio en cualquier momento y ver el estado, sin cuenta y sin llamar a nadie.

Conceptos · Inteligencia y datos

Inteligencia y cuidado del dato

Todo lo que el motor capta se acumula. Sobre esos datos se construye la capa de inteligencia — con reglas claras de cuidado.

Qué entrega hoy

  • Temas recurrentes. Qué se repite y dónde, para atacar la causa y no solo el síntoma.
  • Tendencias. Cómo evoluciona el volumen por tipo, zona y periodo.
  • Radiografías. Cruces con datos abiertos para dar contexto a lo que llega.

Hoy la inteligencia es descriptiva (mide y ordena lo que ya pasó). La predicción y los mapas de calor son parte del roadmap, no del producto actual.

Cuidado del dato

El dato personal de las personas (teléfono, ubicación exacta) se resguarda y no se usa para la analítica. La inteligencia trabaja siempre sobre datos agregados y anonimizados.

En el uso cívico, además, el dato sensible se resguarda y solo se trabaja inteligencia agregada: nunca se expone el dato personal de quien reportó. Cuidar el dato es parte del producto, no un extra.

Conceptos · Adaptación por rubro

Adaptación por rubro

El mismo motor sirve a rubros muy distintos. Lo que cambia es la plantilla, no la tecnología.

Qué se mantiene y qué cambia

  • Igual para todos: captación, clasificación con IA, mapa, derivación, folio y panel.
  • Cambia por rubro: la taxonomía (categorías), a quién se deriva, los plazos y el lenguaje del «estado».

Tres ejemplos

  • Municipio. Reportes ciudadanos (alumbrado, áreas verdes, basura) que se mapean y derivan a las cuadrillas.
  • Inmobiliaria. Consultas de propiedades y postventa a propietarios; el mensaje se vuelve ficha y se agenda la visita.
  • Atención al cliente. Reclamos y consultas que se clasifican, se derivan al área correcta y se resuelven con folio.

Por eso Eforia se construye una vez y se enchufa por rubro: el costo de un cliente nuevo es afinar una plantilla, no reescribir el motor.