Conectar Google Calendar
Autorizá Google, asigná un calendario por profesional, entendé la sincronización y repará vínculos sin duplicar citas.
Google Calendar es una conexión opcional. Agenda sigue guardando sus citas si Google falla; por eso una advertencia de sincronización no significa que debás crear la cita de nuevo.
Antes de empezar
- Usá rol Dueño o Administrador.
- Elegí una cuenta Google que pueda escribir en los calendarios necesarios.
- Prepará un calendario por profesional o definí claramente cuáles compartirán.
- Confirmá la organización activa.
1. Conectar la cuenta
Ruta: Ajustes → Conexiones → Google Calendar
- Seleccioná Conectar Google Calendar.
- Elegí la cuenta correcta.
- Revisá el permiso de Calendar y autorizá.
- Esperá el regreso a Agenda.
Si Google rechaza o revoca la conexión, Agenda muestra un aviso: las citas se siguen guardando, pero no llegan a Calendar hasta reconectar.
2. Obtener el ID de cada calendario
En Google Calendar:
- Pasá el puntero sobre el calendario.
- Abrí ⋮ → Configuración y uso compartido.
- Buscá Integrar calendario.
- Copiá ID de calendario.
Puede verse como un correo o terminar en @group.calendar.google.com. Si pegás el enlace completo de Insertar calendario, Agenda intenta extraer el ID; revisá el resultado antes de guardar.
3. Asignar calendarios
- Volvé a Ajustes → Conexiones.
- Pegá el ID correspondiente junto a cada profesional.
- Seleccioná Guardar agendas.
- Creá o editá una cita de prueba no sensible y comprobá el evento en el calendario correcto.
Una cita con varios tramos para la misma persona produce un evento que cubre su bloque completo. Si participan personas distintas, cada una recibe su propio evento.
Qué ocurre al cambiar una cita
- Crear, editar o mover intenta reconciliar el evento.
- Cancelar o marcar No vino libera el evento asociado.
- Eliminar dispara la limpieza correspondiente.
- Un cambio hecho únicamente en la duración de Google es operativo y no siempre se marca como diferencia de Agenda.
La cita principal se guarda antes de completar la sincronización. Revisá el aviso posterior.
Entender ocupaciones y conflictos
La vista Día puede mostrar tiempos ocupados en Google. En el flujo manual, Google funciona como señal y advertencia; no prometemos que toda hora visible haya sido bloqueada por Calendar.
Agenda también calcula conflictos internos, horarios y pausas. Una hora libre en Google puede chocar con una cita de Agenda, y una hora libre en Agenda puede estar ocupada en Google si la conexión está caída o mal asignada.
La reserva pública puede consultar Google con tiempo limitado y continuar si no responde. La validación final no vuelve a consultar Calendar, así que la conexión reduce riesgo, pero no garantiza por sí sola cero dobles reservas.
Resaltar diferencias
Cuando la opción experimental está activa, la agenda puede marcar:
- rojo: evento eliminado en Google;
- naranja: fecha o inicio desplazado;
- ámbar: cita todavía sin vínculo confirmado.
Usá la marca como diagnóstico, no como instrucción automática para crear otro evento.
Revisar y reparar
Si aparecen citas futuras sin vínculo:
- confirmá cuenta e IDs;
- seleccioná Revisar y reparar;
- revisá el resumen del lote visible;
- verificá una muestra en Google.
La reparación procesa hasta 200 citas visibles, intenta enlazar coincidencias antes de crear y deja los casos ambiguos para revisión. No la ejecutés repetidamente sin inspeccionar el resultado.
Solución de problemas
Google Calendar desconectado
Reconectá desde Ajustes. Las citas creadas durante la caída siguen en Agenda; no las dupliqués.
Si el proyecto OAuth de Google continúa en modo Testing, la autorización puede vencer cada siete días. En ese caso reconectá la cuenta; para evitar la recurrencia, el responsable técnico debe completar la publicación de la pantalla de consentimiento correspondiente.
El evento llegó al calendario equivocado
Revisá el ID asignado a esa persona, corregilo y guardá. Luego usá la reparación con cuidado.
El ID no se guarda
Copiá el ID, no una URL de navegación. Confirmá que el calendario exista y que la cuenta autorizada tenga permiso.
Agenda muestra una diferencia después de editar Google
Abrí ambos registros y compará fecha, inicio y profesional. Corregí la fuente que deba mandar para tu operación y verificá la reconciliación.
La cita se guardó, pero no existe el evento
La escritura de Agenda fue exitosa y la sincronización falló. Corregí conexión/ID y repará; no creés otra cita.