Integración Oficial de Zoom Meetings para Calmatia
Esta guía contiene las especificaciones técnicas e instrucciones de uso para terapeutas sobre la aplicación Calmatia en el Zoom App Marketplace, abarcando el flujo de autorización OAuth, la gestión automática de salas de videollamada y los procedimientos de desinstalación y borrado de datos.
1Instalación y Conexión de la Aplicación (Adding the App)
Para vincular tu cuenta de Zoom y habilitar la generación de salas virtuales en tus consultas psicológicas, sigue estos pasos:
https://zoom.us/oauth/authorize). Inicia sesión si se te solicita y revisa los permisos que Calmatia solicita:meeting:writeomeeting:write:meeting: Requerido para crear, actualizar fecha/hora y cancelar las salas de reunión de tus citas programadas.user:readouser:read:user: Requerido para identificar tu cuenta de Zoom y verificar que coincide con tu usuario terapéutico.
2Uso de la Aplicación en la Práctica Clínica (Using the App)
Una vez vinculada la cuenta, la generación y administración de salas virtuales se realiza de forma transparente:
Al programar una sesión con modalidad Videollamada en línea y plataforma Zoom Meetings, Calmatia genera una reunión programada en tu cuenta de Zoom con fecha y duración exactas, contraseña aleatoria autogenerada (default_password: true) y sala de espera habilitada por defecto.
Para series de citas recurrentes semanales o quincenales, Calmatia genera una sala recurrente fija exclusiva para esa serie clínica. Si posteriormente ajustas la hora de las citas futuras (división de serie), Calmatia genera de forma aislada una nueva sala independiente para que pacientes de distintos horarios nunca coincidan en la misma sala virtual.
- Para el Terapeuta: Puede iniciar la sesión con un solo clic desde la Agenda (
/agenda) o desde el expediente de la cita (/dashboard/sessions/[id]) presionando "Iniciar en Zoom". - Para el Consultante: Recibe el enlace de acceso seguro directamente en su correo de confirmación y en su Portal del Consultante (
/portal). - Reagendar o Cancelar: Si el terapeuta modifica el horario de la sesión en Calmatia, la hora se actualiza automáticamente en Zoom. Si la cita es cancelada o eliminada, la sala se remueve en Zoom sin dejar reuniones huérfanas.
3Desinstalación y Revocación de Permisos (Removing the App)
Puedes desconectar la aplicación en cualquier momento utilizando cualquiera de los siguientes dos métodos:
Método A: Desconexión directa desde Calmatia (Recomendado)
- Inicia sesión en Calmatia y dirígete a Ajustes > Integraciones.
- Ubica la tarjeta de Zoom Meetings y presiona el botón "Desconectar".
- Confirma la acción. Al confirmar, Calmatia:
- Llama al endpoint oficial de Zoom (
https://zoom.us/oauth/revoke) para revocar de inmediato el token de acceso. - Elimina de forma irreversible las credenciales y tokens OAuth cifrados de nuestra base de datos.
- Limpia los enlaces de videollamada de Zoom de las citas futuras para evitar discrepancias.
- Llama al endpoint oficial de Zoom (
Método B: Desinstalación desde el Zoom App Marketplace
- Inicia sesión en tu cuenta de Zoom y accede al Zoom App Marketplace.
- Haz clic en Manage (Administrar) en la esquina superior derecha.
- Selecciona Added Apps (Aplicaciones Agregadas) o busca la aplicación "Calmatia".
- Haz clic en Remove (Eliminar / Desinstalar).
- Confirma la solicitud de eliminación. Zoom revocará el acceso de la aplicación a tu cuenta.
No almacenamos grabaciones ni audio: Calmatia no tiene acceso, no graba ni almacena transmisiones de audio o video de tus llamadas de Zoom.
Destrucción de datos: Al desinstalar la integración o eliminar tu cuenta de terapeuta, todas las credenciales de acceso se eliminan de forma definitiva sin conservar copias de tus llaves OAuth.
Solución de Problemas Frecuentes de Zoom
Error "Sesión de autorización expirada" (invalid_state): Ocurre si abriste la ventana de conexión en múltiples pestañas o si tardaste más de 10 minutos en autorizar. Cierra las pestañas adicionales e inicia el flujo de nuevo.
Error "Falta permiso para reuniones" (missing_meeting_scope): Ocurre si la cuenta de Zoom tiene políticas corporativas que restringen la creación de reuniones por aplicaciones de terceros. Contacta al administrador de tu cuenta de Zoom o utiliza una cuenta independiente.
¿Necesitas soporte técnico con Zoom? Escribe a soporte@calmatia.com y te responderemos en menos de 24 horas hábiles.
¿Tienes dudas adicionales sobre estas integraciones?
Nuestro equipo de soporte para desarrolladores y terapeutas está disponible para asesorarte.