Zimun: Appointment Scheduling & Booking Service: Sincronización de calendario externo

User Manuals

Conecta un calendario personal de Google o Microsoft para que tus citas de Zimun aparezcan allí automáticamente y para que tu tiempo ocupado externo bloquee la disponibilidad en Zimun. La conexión es por miembro del equipo: cada persona enlaza su propio calendario; nadie se conecta en nombre de otro. La función está disponible en los planes Pro y Advanced, y el propietario de la organización debe activarla para toda la organización antes de que cualquier miembro pueda conectarse.

Usa la sincronización de calendario externo cuando el personal mantenga otro calendario de referencia —Outlook de la clínica, Google personal— y se hayan colado reservas dobles porque Zimun no conocía ese otro tiempo ocupado. Conectar una sola vez elimina el desfase: las citas de Zimun salen hacia el calendario elegido y los eventos ocupados externos entran para reducir los huecos reservables de ese miembro.

1. Activar el interruptor de la organización (propietario)

Abre Configuración → Organización → Preferencias. Como propietario, activa Activar sincronización de calendario externo. Hasta que lo hagas, la pestaña Calendario externo no aparece en la página de edición de ningún miembro del equipo, ninguna ocupación entrante afecta a la disponibilidad y no se ejecuta ninguna exportación saliente.

Volver a desactivar el interruptor pausa la sincronización para todos los miembros conectados sin eliminar sus tokens almacenados. Si vuelves a activarlo, las conexiones válidas se reanudan; las caducadas muestran a ese miembro un aviso para volver a conectar.

2. Conectar tu propio calendario (miembro)

Abre Ajustes → Equipo y localiza tu propia tarjeta de miembro. Pulsa Editar. Aparece una nueva pestaña «Calendario externo» junto a Perfil / Servicios / Agenda. Elige el proveedor (Google Calendar o Microsoft Outlook) y sigue la pantalla de consentimiento.

Tras dar tu consentimiento, vuelves a la misma pestaña con una franja de confirmación que muestra el proveedor, el calendario elegido y las marcas de tiempo de «Última sincronización». Los botones para conectar se sustituyen por un botón Desconectar. Si el proveedor expone varios calendarios, la conexión usa por defecto tu calendario principal.

Los propietarios y administradores no pueden conectar en nombre de otro miembro. La pestaña Calendario externo solo aparece cuando estás editando tu propia ficha de miembro: cualquier otra persona que edite tu ficha solo ve las otras tres pestañas.

3. Qué se exporta (Zimun → externo)

Cada cita de Zimun asignada a ti se exporta al calendario conectado como un evento normal. La creación, reprogramación y cancelación se propagan dentro de un retraso normal de sincronización: unos segundos en el caso habitual, más si el proveedor está limitando el uso.

Solo se exportan las citas que cuentan como ocupadas en Zimun. Las citas canceladas se eliminan (o se marcan como tales) en el lado externo. Los cambios de estado que no mueven la hora —marcar asistencia, iniciar, finalizar— no reescriben el evento externo en esta versión.

4. Qué se importa (externo → Zimun)

Un trabajo de sincronización en segundo plano (el mismo cron que se ejecuta para cada organización conectada) lee tu calendario externo en una ventana móvil y guarda cada evento que no esté marcado como «libre» como un bloque ocupado en tu ficha de miembro de Zimun. La reserva pública, la API, el agente de chat y la agenda del operador consultan esos bloques ocupados junto con las citas de Zimun al calcular la disponibilidad.

Los bloques ocupados importados solo te afectan a ti. Un almuerzo personal en tu Google Calendar reduce tus propios huecos; no bloquea a tus compañeros del mismo servicio. Las invitaciones rechazadas y los eventos marcados como libres se omiten.

5. Cómo aparece el tiempo ocupado externo en la agenda

En la vista de agenda del operador, los bloques ocupados externos se muestran como una franja de fondo a rayas con la etiqueta «Ocupado externo». Los propietarios y administradores los ven para cualquier miembro dentro de su ámbito de ubicación; tú ves tus propios bloques en tu propia vista. El bloque no es reservable, pero no se comporta como una cita de Zimun: no puedes pulsarlo, reprogramarlo desde dentro de Zimun ni cambiar su contenido.

Los clientes que reservan públicamente no ven nada sobre el origen del calendario externo: simplemente ven menos huecos disponibles cuando estás ocupado externamente, igual que ocurriría con una cita de Zimun en tu calendario.

6. Desconectar y volver a conectar

Usa el botón Desconectar de la pestaña Calendario externo para detener la sincronización futura. Las próximas citas de Zimun dejan de exportarse y el tiempo ocupado externo deja de importarse. Los eventos ya exportados permanecen en tu calendario externo; no se eliminan de forma retroactiva.

Si tu token de OAuth caduca (tanto Google como Microsoft rotan los tokens de forma programada), la pestaña muestra un aviso «Vuelve a conectar para reanudar la sincronización». Vuelve a conectar con el mismo proveedor: se preserva la correspondencia de eventos existente, así que no verás entradas duplicadas en el calendario tras volver a conectar.

7. Solución de problemas

  • Los botones de Conectar no aparecen en tu página de edición de equipo: o el interruptor de la organización está desactivado (pídeselo al propietario), tu plan no incluye la sincronización de calendario externo (plan Gratis), o estás editando el registro de otra persona (abre el tuyo).
  • La cita de Zimun no apareció en tu calendario externo: actualiza la aplicación del calendario externo; la sincronización se ejecuta en segundo plano y no se garantiza una aparición inmediata. Si sigue sin aparecer pasados varios minutos, consulta «Última sincronización saliente» en la pestaña para ver la marca de tiempo del último intento y cualquier mensaje de error.
  • Los huecos disponibles desaparecieron tras conectar: ese es el comportamiento esperado: el tiempo ocupado de tu calendario externo ahora bloquea los huecos de Zimun. Mueve o elimina el evento externo para reabrir el hueco, o pulsa el botón Desconectar para detener las importaciones.
  • Un cliente dice que no encuentra la disponibilidad que tenías antes: los bloques ocupados externos afectan a todas las superficies de reserva (página pública, API, agente de chat). Revisa tu calendario externo en busca de eventos personales que se solapen con la hora que quiere el cliente.

8. Requisito de plan

La sincronización de calendario externo está disponible en los planes Pro y Advanced. En el plan Gratis, la preferencia de la organización está oculta y ningún miembro ve la pestaña Calendario externo.

Bajar al plan Gratis pausa el comportamiento en tiempo de ejecución sin perder las conexiones almacenadas: la sincronización se detiene, el tiempo ocupado externo deja de afectar a la disponibilidad y ningún miembro ve la pestaña. Si más adelante vuelves a subir de plan y los tokens de conexión siguen siendo válidos, la sincronización se reanuda; si no, los miembros vuelven a conectarse desde la pestaña.

9. Resumen

El propietario activa el interruptor de la organización. Cada miembro abre su propia página de edición de equipo, pulsa la pestaña Calendario externo y conecta Google o Microsoft una vez. A partir de ese momento, las citas de Zimun se exportan a su calendario y el tiempo ocupado externo reduce la disponibilidad en Zimun. Para detenerlo, desconecta desde la misma pestaña. La función requiere Pro o Advanced; el plan Gratis lo oculta todo.