Documentación de Egret
Cada conversación importante, guiada, medida y registrada.
Egret acompaña a las personas que tienen conversaciones que siguen un protocolo: una visita médica, una venta de seguros, una entrevista de investigación, una entrevista migratoria. Mientras conversan, el teléfono les muestra el guion. Al terminar, el mismo teléfono transcribe la conversación y la evalúa contra el protocolo. La organización recibe los resultados, con la trazabilidad completa de cómo se obtuvo cada uno, y su sistema de calidad deja registro de lo que merece atención y de lo que merece reconocimiento.
El recorrido de una conversación
Una conversación pasa por cinco momentos. Los tres del centro ocurren en el teléfono del agente.
- Protocolo. El administrador escribe el guion: las etapas de la conversación, lo que el agente debe decir y evitar, los datos que hay que capturar, las objeciones con su respuesta y las señales críticas. Al publicarlo, llega a todos los teléfonos.
- Guía. El agente elige con quién habla, lee el aviso de privacidad y graba. Durante la conversación el guion aparece en pantalla, etapa por etapa, como la letra de una canción.
- Transcripción. Al terminar, el modelo de voz del teléfono convierte el audio en texto.
- Evaluación. El modelo de lenguaje del teléfono responde cada punto del protocolo. Cada «sí» lleva la cita de la conversación que lo respalda, y Egret verifica que la cita exista en la transcripción.
- Resultados. El teléfono envía las respuestas, el cumplimiento y la trazabilidad. El panel los convierte en análisis y en registros de calidad.
Dónde vive cada dato
El audio y la transcripción se procesan en el teléfono. Al servidor llegan los resultados, listos para analizar. Cada protocolo decide si la transcripción también se conserva en el servidor, con los identificadores enmascarados.
Teléfonos, correos, CURP, RFC, domicilios, códigos postales y números de cuenta o tarjeta se enmascaran en el teléfono antes de enviar y otra vez al llegar al servidor. Los nombres y el resto de lo dicho se conservan tal como se dijeron.
Industrias
Egret sirve a cualquier organización cuyas conversaciones siguen un protocolo. Cada organización elige su industria y la app usa sus palabras en todas las pantallas, incluidos los nombres de las pestañas: la pestaña «Visita» se llama «Cita» en seguros y «Entrevista» en migración. Cada palabra se puede ajustar en Administración → Empresa.
| Industria | Conversación | Agente | Persona | Protocolo | Una señal crítica típica |
|---|---|---|---|---|---|
| Ventas (la opción inicial) | Visita | Vendedor | Cliente | Guion | Solicitud de baja |
| Farmacéutica | Visita | Representante | Médico | Guion | Evento adverso |
| Seguros | Cita | Asesor | Cliente | Guion | Queja formal |
| Telecomunicaciones y servicios digitales | Visita | Ejecutivo | Cliente | Guion | Solicitud de cancelación |
| Entrevistas de investigación | Entrevista | Entrevistador | Entrevistado | Protocolo | Solicitud de abogado |
| Migración | Entrevista | Oficial | Solicitante | Protocolo | Indicio de vulnerabilidad |
En esta documentación usamos las palabras generales: agente, conversación, persona y protocolo. Las pantallas se nombran como en la industria inicial (Visita, Mis visitas); en tu app llevan las palabras de tu organización.
Para agentes
Tu teléfono
Egret hace todo el trabajo en tu teléfono, así que necesita un teléfono reciente:
- Un navegador con WebGPU: Safari en iOS 26 o posterior, o Chrome en Android 12 o posterior.
- Al menos 6 GB de memoria.
Teléfonos recomendados: iPhone 13 Pro, iPhone 14 o más recientes con iOS 26; Samsung Galaxy S23 o más recientes; Google Pixel 7 o más recientes; Motorola Edge 40 o más recientes. Egret revisa que tu navegador tenga WebGPU y te lo dice en la pantalla Visita; la memoria depende del modelo de teléfono, así que conviene uno de la lista.
Entrar por primera vez
- Abre el correo de invitación en tu teléfono, toca el enlace y elige tu contraseña.
- Con Egret abierto en app.egrethq.com, instálala: en iPhone, Safari → Compartir → Agregar a inicio; en Android, Chrome → menú ⋮ → Instalar app.
- Abre Egret desde el ícono de inicio y entra con tu correo y tu contraseña. Instalada se abre como cualquier app y trabaja sin conexión.
La primera vez que analizas una conversación, el teléfono descarga los modelos de voz y de lenguaje (entre 1 y 2 GB). Conviene hacerlo con Wi-Fi.
Tu día
Hoy muestra tu ruta: las conversaciones planeadas en orden, unidas por una línea, con la siguiente marcada en amarillo. Al llegar al lugar, Egret lo reconoce por GPS y te abre la preparación: lo que quedó la última vez y la guía de la conversación.
Una conversación, paso a paso
La pantalla Visita te lleva por cuatro pasos. Cada pantalla te pide una sola cosa, y una línea arriba te dice en qué paso vas.
- Persona. Elige con quién vas a conversar y toca Continuar.
- Aviso. Lee en voz alta el aviso que aparece en pantalla. Si la persona está de acuerdo, toca «Sin objeción» (o «Dijo que sí», cuando el protocolo pide consentimiento verbal); si no, «Dijo que no» y la conversación queda registrada sin grabación. Si la persona pidió no ser grabada, Egret te lo muestra en el primer paso.
- Grabación. Toca Grabar. El guion ocupa la pantalla: la etapa actual en grande, marcada «Ahora», las anteriores atenuadas y las siguientes a la vista. Avanza con Siguiente o tocando una etapa. Las respuestas a objeciones están a un toque.
- Resultado. Toca Detener. El teléfono transcribe y evalúa la conversación, y el resultado se abre solo.
1. Apertura
Ahora 2. Exploración
«¿Cómo trata hoy a sus pacientes con hipertensión?»
3. Presentación · Control de 24 horas · Una toma al día
Tu resultado
En Mis visitas ves tus conversaciones por día, cada una con su cumplimiento. Al abrir una ves el cumplimiento en grande, cada etapa con lo que dijiste (✓) y lo que faltó (✗), las objeciones que surgieron y las respuestas a cada pregunta del protocolo. Si surgió una señal crítica, la verás arriba con lo que debes hacer.
75% cumplimiento del guion
Apertura
✓ Aviso de privacidad
Presentación
✓ Control de 24 horas ✓ Una toma al día
Cierre
✗ Entrega de muestras
Sin conexión
Egret trabaja sin señal. Tu agenda, el protocolo y las fichas de tus clientes se guardan en el teléfono; las conversaciones se graban y se evalúan ahí mismo, y los resultados esperan en el teléfono hasta que vuelve la conexión. En Ajustes → Envío ves cuántas faltan por enviar.
Tus datos
En Ajustes → Mis datos puedes pedir a tu organización ver, corregir, borrar o dejar de usar tus datos como agente. Ahí mismo sigues el estado de tu solicitud y lees la respuesta. La ubicación se registra según la política de tu organización: al iniciar cada visita, también durante la jornada laboral, o nunca. Cuando se registra tu recorrido de la jornada, tu pantalla Hoy te muestra el horario.
Para administradores
Primeros pasos
El panel está en app.egrethq.com/panel. Inicio muestra el estado de tu operación en cuatro partes conectadas. La parte que necesita tu atención lleva la marca amarilla Siguiente paso y un solo botón.
- Guion: crea el protocolo desde un ejemplo y publícalo.
- Equipo: invita a tus agentes por correo.
- Campo: graba una conversación de prueba con tu teléfono.
- Análisis: revisa el resultado y el recorrido de la conversación.
Debajo, Actividad reciente muestra lo último que pasó en tu organización, tomado del registro de auditoría.
El protocolo
El protocolo se escribe como el documento que es: las etapas de la conversación de arriba abajo. En cada etapa agregas lo que el agente debe decir, lo que debe evitar y lo que hay que capturar. Al tocar cualquier punto se abre a la derecha para editarlo.
| Elemento | Para qué sirve | Ejemplo |
|---|---|---|
| Etapa | Una parte de la conversación, con su objetivo. | Apertura: presentarse y obtener permiso para grabar. |
| Decir | Algo que el agente debe transmitir. El texto «Qué decir» aparece en el guion del teléfono; «Cómo detectarlo» guía al modelo. | Control de 24 horas. |
| Evitar | Algo que el agente no debe afirmar. Con «advertir» se señala en la conversación; con «bloquear», además cuenta como infracción en los resultados y en las reglas de calidad. | Prometer curación. |
| Capturar | Un dato que se registra de cada conversación: sí o no, texto, una opción, una lista. | Interés del médico: alto, medio, bajo. |
| Objeción | Algo que la persona puede plantear, con la respuesta recomendada. | «Ya receto otro producto». |
| Señal crítica | Lo que nunca debe pasar desapercibido, con lo que el agente debe hacer cuando surge. Se revisa en cada conversación. | Evento adverso: repórtalo hoy a farmacovigilancia. |
Publicar
Al tocar Publicar, Egret revisa el protocolo y, si todo está en orden, crea una nueva versión que llega a los teléfonos la próxima vez que se abren. Cada conversación queda ligada a la versión con la que se evaluó, así que un resultado siempre se lee contra el protocolo exacto que lo produjo.
Ajustes del protocolo
- Modo de consentimiento: aviso (el agente lo lee y la persona no se opone) o verbal (la persona dice que sí).
- Días que el teléfono conserva el audio y la transcripción y días que el servidor conserva los resultados.
- Dónde se guarda la transcripción: solo en el teléfono, o también en el servidor con los identificadores enmascarados. La segunda opción sirve a los protocolos que conservan el registro completo, como las entrevistas; los gerentes la leen en el detalle de cada conversación.
El equipo
En Administración → Personas invitas a alguien con su nombre, correo y rol. Recibe un enlace de un solo uso, válido por 7 días, para elegir su contraseña.
| Rol | Qué hace |
|---|---|
| Agente | Usa la app de campo: su agenda, sus conversaciones y sus resultados. |
| Gerente | Ve los resultados, el equipo y los reportes; atiende y cierra hallazgos. |
| Oficial de privacidad | Atiende las solicitudes de privacidad. |
| Administrador | Todo lo anterior, más el protocolo, las reglas de calidad y la administración. |
En la misma pantalla ves cada dispositivo conectado y si puede grabar. Desactivar a una persona desconecta todos sus dispositivos al instante.
Calidad y hallazgos
Una regla de calidad dice qué se espera de cada agente, en una frase: «cumplimiento del guion menos de 70% en 14 días, con al menos 5 conversaciones». Egret revisa las reglas después de cada conversación y cada hora, agente por agente.
Cuando un agente cruza una regla, Egret abre un hallazgo: un registro numerado (H‑0001) con la regla, el periodo, el valor medido y las conversaciones que lo respaldan como evidencia. Una regla también puede ser de reconocimiento, para dejar registro del buen trabajo.
Un gerente o administrador toma el hallazgo, con un responsable y una acción (por ejemplo, acompañamiento en campo), y lo cierra con la resolución. Los hallazgos se conservan siempre, con su historia en el registro de auditoría. Las reglas se pueden pausar; sus hallazgos siguen ahí.
Las reglas sugeridas cubren los casos más comunes: cumplimiento bajo, infracciones repetidas, señal crítica, conversaciones fuera de sitio, poca actividad y cumplimiento ejemplar. Cada una avisa por correo a administradores y gerentes si así lo eliges.
Análisis
Resultados resume el periodo en una franja de cifras y dibuja el recorrido de la conversación: las etapas del protocolo de izquierda a derecha, cada una con su cumplimiento y el de cada uno de sus pasos. La etapa más débil aparece marcada en rojo, para ver de un vistazo dónde se rompe la conversación.
Visitas y Equipo son listas que se abren en el panel lateral: tocas una conversación o un agente y ves su detalle sin perder la lista. La búsqueda de arriba (o la tecla /) encuentra cuentas, contactos, personas y oportunidades.
Trazabilidad
Cada resultado lleva el registro de cómo se obtuvo. Al abrir una conversación en el panel, la sección Trazabilidad muestra el camino completo de la decisión:
- Origen · grabación en el teléfono · app 2.0.0
- Transcripción ·
whisper-small· WebGPU · 12 min de audio en 3 bloques · 1 min 20 s - Análisis ·
Qwen3.5-2B· 2 pasadas · 2 min 5 s- Condensación · 18,400 → 2,900 caracteres · instrucciones
4f1a… - Respuestas · 2,900 → 640 caracteres · instrucciones
9c2e…
- Condensación · 18,400 → 2,900 caracteres · instrucciones
- Respuestas y evidencia
- Control de 24 horas: Sí · cita encontrada en la transcripción
- Entrega de muestras: No
- Transcripción · se quedó en el teléfono, como indica el protocolo
- Modelos exactos: el modelo de voz y el de lenguaje, con su variante y cómo corrieron.
- Instrucciones completas: el texto exacto que recibió el modelo en cada pasada, con su huella. Las instrucciones vienen del protocolo publicado.
- Cada pasada: su tipo, los caracteres que entraron y salieron, el tiempo y si hubo reintento.
- Cada «sí»: con el veredicto de su evidencia, es decir, si la cita que lo respalda está en la transcripción.
Así, cada cifra del panel se puede seguir hasta la conversación, el modelo y las instrucciones que la produjeron.
Prospectos y formularios web
Conecta tu sitio web a tu CRM en Prospectos → Formularios web: le das un nombre, los sitios que pueden enviar, el país de su aviso de privacidad y a quién avisar. Egret te da el código para pegar en tu página.
- La persona escribe en tu sitio y marca la casilla de consentimiento, con el texto que Egret registró para ese formulario.
- Llega como prospecto a Prospectos, y las personas que elegiste reciben el mensaje completo por correo.
- Su consentimiento queda registrado en Privacidad → Consentimientos: el texto exacto con su huella digital, cuándo, desde qué dirección y navegador.
- Lo trabajas: le asignas responsable, lo marcas como contactado o calificado y lo conviertes en oportunidad, o lo descartas.
Los prospectos también tienen derechos: tu oficial de privacidad los encuentra por su correo, entrega sus datos o los elimina; la constancia del consentimiento se conserva sin la dirección ni el navegador.
Reportes e integraciones
Reportes trae reportes listos (cumplimiento por agente y por semana, pasos que más se omiten, objeciones, señales críticas, cobertura, agenda, embudo) y permite escribir los tuyos en SQL sobre vistas pensadas para eso. Cada reporte se descarga en CSV.
- API: en Administración → Integraciones creas tokens con los permisos justos para tu CRM o tu herramienta de análisis.
- Webhooks: Egret avisa a tus sistemas cuando llega una conversación, se abre un hallazgo o se publica un protocolo. Cada envío va firmado.
- Agentes de IA (MCP): un asistente compatible, como Claude, puede consultar el esquema, ejecutar reportes y guardar nuevos, con un token que tenga los permisos de reportes y de lectura de visitas.
Países y consentimiento
Cada protocolo dice en qué países se usa. Cada país trae su ley de protección de datos, y Egret la aplica sola: el aviso que escucha la persona, el consentimiento que se pide, sus derechos y el plazo para responderle.
| País | Ley | Consentimiento | Con datos sensibles | Plazo para responder |
|---|---|---|---|---|
| México | Ley Federal de Protección de Datos Personales en Posesión de los Particulares (2025) | Aviso, sin objeción | Firma en el teléfono | 20 días hábiles |
| Ecuador | Ley Orgánica de Protección de Datos Personales (2021) y su Reglamento | Sí expreso | Firma en el teléfono | 15 días |
| Estados Unidos | Leyes estatales de privacidad y de grabación | Sí expreso, que cumple también en los estados que piden el acuerdo de todos | Firma en el teléfono | 45 días |
- Al publicar, Egret escribe el aviso de privacidad de cada país con los datos del responsable (Administración → Empresa), las finalidades y lo que captura el protocolo, y lo guarda con su huella digital.
- En la conversación, el agente elige el país si el protocolo tiene varios, lee el aviso breve y muestra el enlace al aviso completo. La pantalla pide el consentimiento que corresponde: sin objeción, un sí, o la firma de la persona con su nombre.
- Cada consentimiento queda registrado en Privacidad → Consentimientos: el aviso exacto que escuchó la persona, cómo aceptó, cuándo y quién lo registró. También queda registrado cuando no acepta.
- Los derechos de cada país llegan al formulario público y a Privacidad → Solicitudes, con su plazo. Una revocación marca cada consentimiento como revocado; una cancelación borra la firma y conserva la constancia.
Los avisos se generan a partir de los textos de cada ley. Revísalos con tu abogado antes de usarlos.
Privacidad
Las personas pueden ejercer sus derechos de acceso, rectificación, cancelación y oposición. Los médicos, clientes o solicitantes usan el formulario público que enlazas desde tu aviso de privacidad; los agentes lo piden desde su app. En Privacidad identificas a la persona y eliges la decisión. Egret entrega los datos, corrige la ficha, borra los registros o anota la oposición, y redacta la respuesta para que la revises y la envíes por correo. Cuando quien pide es un agente, el borrado incluye sus visitas y su registro de ubicación; para sus correcciones y oposiciones, la respuesta deja espacio para que describas lo que hiciste.
Cuando una persona se opone, la app de campo lo muestra al elegirla, también al abrir su visita desde Hoy, y sus conversaciones ya no se graban.
Administración
- Personas: invitaciones, roles, cambio de contraseña, dispositivos.
- Empresa: industria y palabras, zona horaria, política de ubicación, etapas del embudo.
- Inicio de sesión: entrada con la cuenta de la empresa (Okta, Microsoft Entra ID, Google Workspace y cualquier proveedor OpenID Connect), con autenticación multifactor de tu proveedor, y aprovisionamiento automático con SCIM.
- Integraciones: tokens de API y webhooks.
- Auditoría: cada cambio a personas, dispositivos, protocolos, reglas, hallazgos, planes, oportunidades, privacidad y ajustes, con quién y cuándo, encadenado criptográficamente; un botón verifica la integridad de la cadena.
- Datos: exportación de tu organización en un archivo: personas, protocolos, conversaciones, planes, oportunidades, reglas, hallazgos y auditoría.
Referencia
Arquitectura
Egret tiene tres partes: la app de campo en el teléfono, el panel en el navegador y el servicio en Cloudflare, que da a cada organización su propia base de datos.
- Una base de datos por organización. Cada organización vive en su propia base de datos, separada de las demás. Al crearla se puede ubicar en la Unión Europea o en Estados Unidos, y sus respaldos se quedan en esa misma región.
- Todo desde un solo origen. La app, sus bibliotecas y los modelos se sirven desde el dominio de Egret, con versiones fijas y sumas de verificación.
- Respaldos. Cada noche, una copia completa, cifrada con una llave propia de tu organización y guardada en su región; además, recuperación a cualquier momento de los últimos 30 días.
Seguridad
- Cada dispositivo firma cada solicitud con una llave propia que vive en el teléfono; cada solicitud firmada se acepta una sola vez.
- Contraseñas guardadas con PBKDF2 y sal propia; bloqueo temporal tras intentos fallidos; enlaces de un solo uso para invitaciones y cambios de contraseña.
- Permisos por rol en cada operación, verificados en el servidor.
- Auditoría encadenada: cada registro guarda la huella del anterior, así que un cambio en cualquier registro existente se detecta.
- Modelos solo para dispositivos conectados: la descarga de modelos requiere un pase firmado de tu organización.
Glosario
- Agente
- Quien conduce la conversación: representante, asesor, ejecutivo, entrevistador u oficial.
- Conversación
- Una visita, cita o entrevista, guiada por el protocolo.
- Cumplimiento
- El porcentaje de los pasos obligatorios del protocolo que se cumplieron en una conversación.
- Evidencia
- La cita de la conversación que respalda un «sí», verificada contra la transcripción.
- Hallazgo
- El registro que abre una regla de calidad: quién, qué, cuándo y las conversaciones que lo respaldan.
- Protocolo
- El guion de la conversación: etapas, qué decir, qué evitar, qué capturar, objeciones y señales críticas.
- Reconocimiento
- Un hallazgo que deja registro del buen trabajo.
- Señal crítica
- Algo que nunca debe pasar desapercibido en una conversación, con lo que el agente debe hacer cuando surge.
- Trazabilidad
- El registro de cómo se obtuvo cada resultado: modelos, instrucciones, pasadas y evidencia.
- Versión
- Cada publicación del protocolo. Cada conversación queda ligada a la versión con la que se evaluó.