# Portal escolar (documentación completa)

> Portal interno del instituto. El equipo del instituto atiende a las familias y aspirantes por WhatsApp con un agente de inteligencia artificial, da seguimiento a las admisiones y mantiene la ficha de cada prospecto.

## Qué hace el portal

El portal es la herramienta de trabajo del equipo del instituto. No es un sitio para familias.

1. Una familia o un aspirante escribe al WhatsApp del instituto.
2. El agente del instituto responde al momento con la información que el instituto le dio: niveles, horarios, requisitos de admisión, eventos y datos de contacto.
3. Cuando la familia necesita a una persona (por ejemplo, para agendar una visita o resolver un tema delicado), el agente pasa la conversación al equipo.
4. Alguien del equipo toma la conversación desde la bandeja y responde desde el portal. La familia sigue en el mismo chat y con el mismo número.
5. La familia queda registrada en Prospectos, con su historial, para el siguiente contacto.

## Secciones del portal

- Inicio: resumen del día (conversaciones abiertas, prospectos registrados, actividad del equipo).
- Prospectos: una ficha por familia o aspirante, con contacto, conversaciones, datos fiscales, consentimientos, etiquetas y notas internas.
- Chat con el agente: probar al agente como si fueras una familia.
- Consola del agente: configuración, conocimiento (archivos Markdown o páginas web) y aprendizaje (preguntas que el agente no supo contestar, para que una persona apruebe la respuesta).
- Canales: el número de WhatsApp del instituto, conectado por Evolution (código QR) o por la API oficial de Meta.
- Conversaciones: la bandeja de WhatsApp, con filtros, asignación, notas internas, etiquetas y devolución al agente.
- Admin: datos del instituto, marca, equipo y roles, API keys, notificaciones y seguridad.
- Ayuda y Soporte.

## El agente del instituto

- Responde texto, notas de voz (las transcribe), fotos y, según el modelo, videos.
- Responde solo con el conocimiento que el instituto aprobó. Si no sabe algo, lo dice y pasa la conversación a una persona.
- Pasa la conversación a una persona cuando la familia lo pide, se queja, escribe una palabra configurada (por ejemplo "asesor") o el agente no puede resolver algo.
- Nada se agrega solo a su conocimiento: cada sugerencia de aprendizaje espera la aprobación de una persona.

## Equipo y seguridad

- Cada persona entra con su propia cuenta y un rol (Propietario, Administrador, Vendedor, Finanzas, Catálogo, Soporte o Lectura) que define qué ve y qué puede hacer.
- Se recomienda activar la verificación en dos pasos (MFA) en Admin → Seguridad.
- Nunca se piden contraseñas ni API keys por correo.

## Integraciones

Las API keys permiten que otros sistemas del instituto consulten o actualicen información del portal. Cada key tiene permisos específicos, el secreto se muestra una sola vez y se puede rotar o revocar desde Admin → API keys.

## Soporte

Escribe al administrador de tu instituto con la URL, el navegador, la hora y los pasos para reproducir el problema.