# SALUD 365

## Módulo 05 · Videoconsulta

**Última actualización:** 14 de noviembre de 2026.

Documento funcional para validación con usuarios. Se presentan comportamientos esperados y reglas en lenguaje claro, sin códigos de trazabilidad técnica.

### Contexto funcional vigente

El MVP se desarrolla en plataforma web. Salud 365 presenta la experiencia del usuario y coordina las operaciones; Elite Global Doctors (EGD) es el core clínico. Las capacidades concretas de sus servicios e interfaces aún requieren validación técnica.

El titular que contrata y paga puede ser distinto del paciente; los pacientes dependientes deben estar vinculados y autorizados. Los usuarios, pacientes y médicos requieren registro y correspondencia de identidad entre Salud 365 y EGD. La correspondencia de los datos del médico no implica que este ingrese a Salud 365: en esta fase participa desde la plataforma de EGD.

Las modalidades son telemedicina «Lo antes posible» y programada. El consentimiento informado y el motivo de consulta en la etapa Triaje se registran antes del pago. El pago con Izipay se confirma antes de elegir horario para programada o continuar con la asignación de «Lo antes posible».

El motivo se guarda en Salud 365 antes del pago, asociado al paciente y a la solicitud. Se transmite a EGD vinculado a la cita cuando exista el identificador externo correspondiente; guardar datos localmente no equivale a confirmar su recepción en EGD.

EGD entrega la solución de videoconsulta para integrarla en Salud 365 y envía por WhatsApp el enlace al paciente y al médico. Terminar la llamada no significa cerrar el acto médico: el profesional puede retomar una atención pendiente. El titular/paciente autorizado accede desde Salud 365 y el médico desde la plataforma de EGD. Ante un fallo de conexión o error, se conserva la misma URL de EGD, no se genera otra y el enlace deja de expirar para permitir retomar la comunicación.

### Descripción funcional y procesos

### Especificación Funcional Detallada

### Objetivo y alcance

Especificar la preparación, acceso, conexión, seguimiento y salida de la videoconsulta del titular/paciente autorizado desde la plataforma web Salud 365, utilizando la URL y el mecanismo de sesión proporcionados por EGD. El médico participa y continúa su trabajo clínico desde la plataforma de EGD. Las responsabilidades de documentación clínica, diagnósticos, recetas y cierre se coordinan con el Módulo 06 – Acto Médico y los módulos clínicos relacionados.

Incluye telemedicina «Lo antes posible» y programada, acceso del titular/paciente desde Salud 365 y participación del médico desde EGD, validación de cita y permisos, sala de espera si EGD la ofrece, integración del video, interrupciones, estados, incidencias y trazabilidad. Salud 365 conserva los datos de seguimiento y los registros técnicos conforme al alcance de integración y los permisos acordados.

### Decisiones base y límites

Confirmado: EGD proporciona la videoconsulta y es el sistema clínico principal. El médico ingresa desde la plataforma de EGD y no desde Salud 365 en esta fase. Salud 365 presenta el acceso del titular/paciente autorizado, mantiene la correspondencia de registros y conserva datos y logs para seguimiento; el alcance de esa conservación se rige por las reglas y contratos de integración.

Confirmado en Módulo 04 ajustado: consentimiento y motivo de consulta antes de Izipay; pago confirmado antes de agendar una programada o continuar con la asignación de «Lo antes posible».

Confirmado: EGD registra la cita, proporciona el enlace de videoconsulta embebible en el frontend web Salud 365 y notifica por WhatsApp al paciente y al médico asignado, incluyendo el enlace. Quedan por validar únicamente los detalles técnicos de integración, autenticación, vigencia y gestión de fallos. Ante un fallo se conserva la misma URL de EGD y deja de expirar, sin generar otra por esa incidencia.

No se presupone que EGD disponga de SDK, iframe, sala de espera, chat, grabación o webhooks. El acceso del titular/paciente se integra en Salud 365 mediante el mecanismo técnico compatible acordado con EGD.

La finalización de la llamada no implica el cierre del acto médico. El médico puede mantener una atención pendiente de cierre y retomarla en la plataforma de EGD, conforme a las responsabilidades del Módulo 06.

La videoconsulta no procesa pagos ni modifica unilateralmente la reserva de la cita.

### Actores y responsabilidades

### Flujo funcional de referencia

1. La cita ha sido creada y confirmada en EGD después del pago, conforme al Módulo 04.

2. El TITULAR selecciona al paciente asociado y su cita; Salud 365 valida vínculo, paciente, médico, horario y permisos, y obtiene de EGD el enlace para presentar la videoconsulta embebida.

3. El TITULAR, desde su sesión en Salud 365, visualiza Ingresar a videoconsulta cuando la cita y la ventana de acceso lo permitan. El médico ingresa desde su acceso autorizado en la plataforma de EGD. EGD envía también el enlace por WhatsApp al paciente y al médico, conforme al requisito base de notificaciones.

4. El usuario verifica cámara, micrófono, navegador y permisos del dispositivo; accede a sala de espera si el mecanismo de EGD lo contempla.

5. EGD habilita la comunicación. Salud 365 presenta la videoconsulta integrada al titular/paciente y EGD proporciona el acceso al médico desde su plataforma.

6. Durante la llamada, el médico utiliza las funciones clínicas en la plataforma de EGD. Salud 365 conserva los datos de seguimiento, resultados conocidos y logs que correspondan según la integración autorizada.

7. Ante una desconexión por fallo o error, Salud 365 permite reingresar con la misma URL de EGD, sin nueva cita ni pago; el enlace deja de expirar por esa incidencia. Se comprueban nuevamente los permisos y se registra el resultado técnico.

8. Al finalizar la llamada, Salud 365 registra o consulta el estado técnico cuando EGD lo permita. La atención clínica puede continuar pendiente de conclusiones y cierre en la plataforma de EGD; se mantiene su separación del fin de la llamada.

Se proponen nueve requerimientos funcionales. Sus operaciones técnicas están sujetas a demostración y validación de EGD.

### RF-05-001 · Habilitación de acceso a videoconsulta

**Objetivo:** Permitir acceder únicamente a sesiones de citas válidas y autorizadas.

**Actores:** PACIENTE/TITULAR desde Salud 365; MÉDICO desde la plataforma de EGD; Salud 365 y EGD como sistemas integrados.

**Precondiciones:** cita confirmada por EGD, paciente y médico asociados; titular autenticado y autorizado en Salud 365; médico autenticado en la plataforma de EGD para su participación.

**Flujo principal:**

1. Consulta cita y valida ID EGD/Salud 365, paciente, médico, modalidad, horario y estado.

2. Evalúa el rol, el vínculo con el paciente y la ventana de acceso del participante que ingresa por Salud 365; EGD aplica los controles correspondientes al médico en su plataforma.

3. Solicita a EGD datos de sesión o enlace de acceso.

4. Habilita Ingresar en Salud 365 solo al titular/paciente autorizado. El acceso del médico se gestiona desde la plataforma de EGD.

**Validaciones y reglas:**

El TITULAR autenticado podrá seleccionar un paciente asociado autorizado, consultar sus citas e ingresar desde su misma sesión a la videoconsulta embebida. El acceso se limita a pacientes vinculados y citas válidas; el alcance de representación y acceso a datos clínicos se define por separado.

No exponer el enlace a usuarios ajenos a la cita; validar vínculo, paciente y cita antes de mostrar la opción de ingreso. EGD deberá aplicar controles de acceso apropiados al enlace, incluidos los compartidos por WhatsApp, según el mecanismo técnico acordado.

**Alternativas y excepciones:**

Cita cancelada, expirada o sin enlace: bloquear acceso y mostrar motivo apropiado.

EGD no responde: registrar incidencia y permitir reintento controlado.

**Integraciones y datos:** servicio de sesión EGD.

**Criterios de aceptación:**

Solo participantes autorizados ingresan a la sesión correspondiente.

No se habilita acceso a una cita inexistente o cancelada.

Confirmado: acceso del TITULAR desde su sesión en Salud 365, seleccionando al paciente asociado autorizado, con videoconsulta integrada. El médico accede desde la plataforma de EGD.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-002 · Obtención y apertura segura de sesión EGD

**Objetivo:** Abrir dentro del frontend web Salud 365 la videoconsulta de EGD mediante un enlace integrado/embebido, sin exigir al TITULAR abandonar la plataforma.

**Actores:** PACIENTE/TITULAR y Salud 365 para la apertura integrada; EGD como proveedor de la sesión y del acceso del MÉDICO en su plataforma.

**Precondiciones:** Acceso autorizado y sesión disponible.

**Flujo principal:**

1. Salud 365 solicita o recupera la sesión asociada a la cita EGD.

2. Recibe la URL de EGD y, si el contrato lo requiere, los parámetros o credenciales técnicas del componente. Ante un fallo se conserva esa URL sin generar otra y el enlace deja de expirar.

3. Abre la videoconsulta integrada dentro de Salud 365 mediante el mecanismo aprobado con EGD, sin exigir al titular abandonar la plataforma.

4. Registra resultado de apertura sin guardar secretos en registros.

**Validaciones y reglas:**

La URL corresponde a la cita autorizada y no se considera pública. El reingreso por fallo utiliza esa misma URL, sujeto a la autorización del participante; no habilita el acceso a otras citas.

Separar credenciales técnicas de las credenciales de usuario.

**Alternativas y excepciones:**

Ante un fallo de conexión o error se aplica RF-05-006: conservar la URL original de EGD, sin generar otra y sin que expire por esa incidencia. Otros supuestos de vencimiento se gestionan mediante el procedimiento autorizado con EGD.

Componente no compatible: informar y habilitar ruta de soporte.

**Integraciones y datos:** EGD proporciona la URL, consulta y estado de sesión, conservación del enlace ante fallos, parámetros de autenticación y política de origen conforme al contrato técnico.

**Criterios de aceptación:**

Acceso correcto desde navegador web soportado.

No se filtran tokens ni datos clínicos en URLs o logs públicos.

Confirmado funcionalmente: videoconsulta integrada en Salud 365 para el titular/paciente autorizado; el médico participa desde la plataforma de EGD.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-003 · Preparación técnica y sala de espera

**Objetivo:** Orientar a los participantes antes de la conexión y controlar la espera si EGD la ofrece.

**Actores:** PACIENTE, MÉDICO, EGD.

**Precondiciones:** Cita accesible y dispositivo compatible.

**Flujo principal:**

1. Muestra información de cita y recomendaciones técnicas.

2. Solicita permisos de cámara y micrófono cuando corresponda.

3. Permite probar dispositivos si la tecnología lo soporta.

4. Presenta estado de espera/admisión si EGD lo expone. El titular/paciente puede utilizar vista normal, ampliada o minimizada en ventana flotante cuando la integración EGD permita conservar la misma comunicación al cambiar de presentación.

**Validaciones y reglas:**

No confundir consentimiento clínico con permisos de cámara/micrófono.

No registrar audio o video como prueba de dispositivo.

**Alternativas y excepciones:**

Permiso denegado: mostrar instrucciones para habilitarlo.

Médico no conectado: mostrar espera o alternativa según estado disponible.

**Integraciones y datos:** Componente EGD, permisos del navegador y estados de sala.

**Criterios de aceptación:**

Se informa claramente al usuario cómo habilitar audio y video.

La espera no se presenta como atención iniciada.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-004 · Ingreso y participación del médico

**Objetivo:** describir el ingreso del médico desde la plataforma de EGD únicamente a las sesiones de sus citas asignadas y coordinar la información de seguimiento disponible para Salud 365.

**Actores:** MÉDICO y EGD para el acceso profesional; Salud 365 para la correlación y el seguimiento autorizado.

**Precondiciones:** médico validado, autenticado en la plataforma de EGD y asignado a la cita.

**Flujo principal:**

1. El médico abre su agenda en la plataforma de EGD y selecciona la cita asignada.

2. EGD verifica la asignación, el estado y las condiciones de acceso del médico a la cita.

3. El médico obtiene acceso seguro a la sesión desde la plataforma de EGD.

4. El médico participa en la videoconsulta y continúa el acto médico en la plataforma de EGD. Salud 365 conserva la correspondencia y los datos o eventos de seguimiento que EGD exponga según el contrato.

**Validaciones y reglas:**

No autorizar ingreso por conocer solo un ID o enlace.

El registro clínico no depende de mantener la cámara activa.

**Alternativas y excepciones:**

Médico reemplazado: EGD revoca o restringe el acceso anterior conforme al mecanismo disponible; Salud 365 refleja la asignación confirmada y conserva la trazabilidad correspondiente.

Falla de sesión: se permite reintento por el mecanismo EGD; Salud 365 registra el incidente y el resultado cuando dispone de esa información.

**Integraciones y datos:** autenticación, asignación y sesión del médico en EGD; consulta o recepción de datos de seguimiento autorizados en Salud 365.

**Criterios de aceptación:**

Solo el médico asignado y autorizado puede ingresar desde la plataforma de EGD.

El médico puede retomar el acto médico en la plataforma de EGD después de terminar la llamada, cuando esté autorizado.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-005 · Control de estados y eventos de sesión

**Objetivo:** Distinguir eventos de videollamada de estados de cita y de acto médico.

**Actores:** Salud 365, EGD, ADMINISTRADOR.

**Precondiciones:** Sesión asociada a cita identificada.

**Flujo principal:**

1. Registra ID de cita, ID de sesión y participantes autorizados.

2. Consulta o recibe eventos de apertura, conexión, desconexión y finalización cuando EGD los exponga.

3. Actualiza el estado técnico local conforme a mapeo aprobado.

4. Mantiene trazabilidad temporal sin alterar automáticamente el estado clínico.

**Validaciones y reglas:**

Fin de videollamada ≠ cita cancelada ni acto médico cerrado.

No inferir asistencia o cierre clínico solo por evento de conexión.

**Alternativas y excepciones:**

Evento duplicado o fuera de orden: procesar idempotentemente.

EGD sin eventos: consultar estado o registrar estado no determinado.

**Integraciones y datos:** EGD API de sesión, webhooks/eventos si existen; y Módulo 06.

**Criterios de aceptación:**

Se diferencian los tres estados: sesión, cita y acto médico.

Los eventos repetidos no generan transiciones incorrectas.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-006 · Desconexión y reingreso

**Objetivo:** recuperar la comunicación tras una interrupción de conectividad mediante la misma URL proporcionada por EGD, sin crear otra cita ni otro pago.

**Actores:** PACIENTE, MÉDICO, Salud 365, EGD.

**Precondiciones:** cita y participantes autorizados; continuidad de la misma URL de EGD ante fallo o error.

**Flujo principal:**

1. Detecta o recibe información de desconexión.

2. Muestra la opción de reintentar la conexión con la misma URL de EGD, sin crear nueva cita, enlace ni pago.

3. Verifica la autorización del participante. Si la interrupción se debe a un fallo o error, el enlace original deja de expirar y no se reemplaza.

4. Recupera la comunicación según el mecanismo de EGD y registra el resultado. El titular/paciente reingresa desde Salud 365 y el médico desde la plataforma de EGD.

**Validaciones y reglas:**

No generar automáticamente una segunda cita.

No declarar «atención realizada» por desconexión.

**Alternativas y excepciones:**

Ante un fallo o error no se impide el reingreso por expiración de la URL: se conserva el mismo enlace de EGD y deja de expirar. Si la causa es una restricción de autorización o un estado de cita incompatible, se informa y aplica el procedimiento correspondiente.

Interrupción prolongada: registrar incidencia para decisión operativa.

**Integraciones y datos:** estado y recuperación de sesión EGD con la misma URL, comprobación de permisos y bitácora técnica.

**Criterios de aceptación:**

El reingreso utiliza la misma URL de EGD y no duplica citas ni pagos; el enlace deja de expirar ante el fallo o error.

La interrupción queda trazada y no cierra automáticamente acto médico.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-007 · Finalización de llamada y continuidad clínica

**Objetivo:** Permitir finalizar la conexión manteniendo el acto médico abierto si corresponde.

**Actores:** MÉDICO, PACIENTE, Salud 365, EGD.

**Precondiciones:** Sesión iniciada o conectada.

**Flujo principal:**

1. El participante abandona o termina la videollamada.

2. Salud 365 registra o consulta fin de sesión cuando sea posible.

3. El médico conserva acceso a la atención clínica pendiente desde la plataforma de EGD, según su asignación y permisos.

4. El cierre del acto médico se realiza por separado en la plataforma de EGD, conforme a las responsabilidades definidas para el Módulo 06. Salud 365 refleja el resultado confirmado y conserva la trazabilidad autorizada.

**Validaciones y reglas:**

Guardar borrador no equivale a finalizar acto médico.

No marcar historia clínica cerrada por fin de sesión de video.

**Alternativas y excepciones:**

Sin conclusiones/receta: dejar acto médico pendiente según reglas aprobadas.

Falla al cerrar clínicamente: mantener estado pendiente y conciliar.

**Integraciones y datos:** Módulo 06, eventos EGD y registro clínico.

**Criterios de aceptación:**

Puede terminar la llamada y quedar el acto médico pendiente de cierre.

El estado clínico solo cambia tras confirmación confiable de EGD.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-008 · Notificaciones y recordatorios de acceso

**Objetivo:** Garantizar que EGD envíe por WhatsApp al paciente y al médico asignado la notificación de cita con el enlace de videoconsulta, y definir el tratamiento de cambios e incidencias.

**Actores:** PACIENTE, MÉDICO, Salud 365, EGD.

**Precondiciones:** Cita confirmada y datos de contacto habilitados.

**Flujo principal:**

1. EGD identifica la confirmación de la cita como evento para enviar por WhatsApp el enlace al paciente y al médico asignado; otros recordatorios o eventos quedan sujetos a definición.

2. Determina plataforma responsable de cada mensaje.

3. EGD proporciona el enlace seguro de la cita. Salud 365 lo obtiene para presentarlo al titular/paciente autorizado; el médico accede desde la plataforma de EGD.

4. Registra resultado de envío cuando el responsable lo exponga.

**Validaciones y reglas:**

Confirmado como requisito funcional: EGD es responsable de enviar por WhatsApp el enlace de videoconsulta al paciente y al médico asignado. Validar implementación técnica, confirmación de entrega y tratamiento de errores.

No incluir datos clínicos sensibles ni tokens persistentes en mensajes.

**Alternativas y excepciones:**

Mensaje no entregado: permitir consultar acceso desde Mis citas.

Notificación duplicada: evitar repetición por correlación de evento.

**Integraciones y datos:** EGD proporciona el enlace y las notificaciones WhatsApp al paciente y al médico, conforme al requisito base; Salud 365 consulta la cita y presenta el acceso integrado al titular/paciente; el médico utiliza la plataforma de EGD.

**Criterios de aceptación:**

El paciente puede encontrar acceso desde su cita aun sin notificación.

Responsabilidades de envío están definidas y auditables.

Confirmado como texto base: canal WhatsApp, emisor EGD, destinatarios paciente y médico, mensaje con enlace.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.

### RF-05-009 · Supervisión de incidencias y auditoría técnica

**Objetivo:** Dar soporte a problemas de acceso, conexión y estados de sesión.

**Actores:** ADMINISTRADOR, Salud 365, EGD.

**Precondiciones:** Rol autorizado; bitácoras técnicas disponibles.

**Flujo principal:**

1. Consulta incidencias por cita, sesión, fecha, participante y tipo de error. Salud 365 guarda datos técnicos y logs de acceso, operaciones, reintentos, resultados e incidencias conforme al alcance autorizado; estos registros no se limitan a errores.

2. Visualiza cronología técnica y estado de comunicación EGD.

3. Realiza consulta/reintento autorizado o escala al soporte correspondiente.

4. Registra resolución, responsable y evidencia mínima necesaria.

**Validaciones y reglas:**

No exponer contenido audiovisual ni información clínica en bitácoras.

Acceso administrativo restringido al mínimo necesario.

**Alternativas y excepciones:**

Sin ID EGD: buscar por correlación de solicitud.

Inconsistencia de estados: escalar y conciliar sin forzar cierre clínico.

**Integraciones y datos:** APIs, estados y logs que EGD exponga, correlación de identificadores y bitácoras técnicas conservadas en Salud 365, con los controles de seguridad correspondientes.

**Criterios de aceptación:**

Una incidencia se puede rastrear de extremo a extremo.

Las acciones de soporte quedan auditadas.

Los estados son ejemplos funcionales; no se consideran confirmados por EGD.

Control de acceso por paciente autorizado y médico asignado; validar dependientes adultos y representantes.

No incluir grabación de videollamadas en el MVP sin decisión explícita, base legal y capacidad EGD verificada.

Separar claramente eventos técnicos de video, estados de cita y estados clínicos.

La videoconsulta integrada en Salud 365 para el titular/paciente y las notificaciones WhatsApp de EGD al paciente y al médico se conservan como requisitos funcionales base. El médico ingresa desde la plataforma de EGD. La integración técnica y sus controles deben demostrarse conforme al contrato, sin atribuir al mecanismo funciones no confirmadas.

**Referencias cruzadas:** /011, /009, y Módulo 06.

Demostración de un titular/paciente ingresando desde su cita en Salud 365 y del médico ingresando desde la plataforma de EGD, ambos a la sesión que corresponde.

Confirmación documental de mecanismo de enlace/componente, permisos, seguridad y expiración.

Prueba de interrupción, reingreso y cierre de llamada sin cierre automático del acto médico.

Responsable de envío indicado en el requisito base: EGD.

Aprobación de mapeo de estados y contratos de integración EGD.

**Referencias de trazabilidad:** FL por vincular | INT por vincular | API/Checklist EGD por verificar.
