Conectar Google Calendar
Autorizá Google, asigná un calendario por profesional, ocultá en tu página de reservas las horas ocupadas en Google 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. Agenda prueba cada calendario en ese momento y muestra debajo de cada ID si funciona o qué falta.
- 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.
Tu página de reservas y el widget también pueden ocultar las horas ocupadas en Google: lo explica la sección siguiente.
Ocultar horas ocupadas en la página de reservas
Con esta opción, si una profesional tiene un evento ocupado en su Google Calendar, esa hora no aparece en tu página de reservas ni en el widget, aunque en Agenda esté libre. Sirve para que nadie reserve encima de una cita médica, un trámite o un turno que se anotó solo en Google.
Activarla
Ruta: Ajustes → Página de reservas → Página → Fechas y horas → Respetar Google Calendar
- No usar: la página ofrece las horas según Agenda, sin mirar Google.
- Ocultar las horas ocupadas en Google: la página y el widget no ofrecen las horas en que la profesional tiene un evento ocupado.
- Ocultar y avisar al equipo al agendar: lo mismo, y además el panel avisa cuando alguien del equipo agenda una cita que choca con Google. Avisa, no impide guardar.
Compartir el calendario de cada profesional
Agenda lee los calendarios con la cuenta de Google que conectaste en Ajustes → Conexiones. Si el calendario de una profesional es de otra cuenta (por ejemplo, su Gmail personal), ella tiene que compartirlo con esa cuenta:
- En Google Calendar, pasá el puntero sobre su calendario y abrí ⋮ → Configuración y uso compartido.
- En Compartir con personas y grupos específicos, agregá el correo de la cuenta conectada (Agenda lo muestra junto a la opción).
- Con el permiso Ver solo disponible (ocultar detalles) alcanza: Agenda solo necesita saber si la hora está ocupada, no qué evento es.
- Volvé a Agenda y tocá Probar ahora.
Leer el diagnóstico
Debajo de la opción aparece Calendario de cada profesional, con el estado de cada una y el botón Probar ahora:
- Funciona: las horas ocupadas en su calendario no se ofrecen.
- No se puede leer: Google no encuentra ese calendario. Casi siempre es que no está compartido con la cuenta conectada; también puede ser un ID mal copiado.
- Sin permiso: el calendario existe, pero la cuenta conectada no tiene acceso. Compartilo como en el paso anterior.
- Google sin conectar o Conexión caída: conectá o reconectá la cuenta en Ajustes → Conexiones.
- Google tardó o Error de Google: un problema de Google en ese momento. Probá de nuevo en un rato.
- Sin calendario asignado: esa profesional no tiene ID de agenda, así que sus horas se ofrecen sin mirar Google.
Mientras alguna profesional no se pueda leer, Agenda lo avisa arriba de Página de reservas y en el Inicio de dueños y administradores. En el Inicio podés ocultar el aviso hasta el día siguiente. La página también registra sola cuando un calendario deja de leerse o vuelve a funcionar, sin que nadie toque Probar ahora.
Qué cuenta como ocupado
- Un evento marcado como Ocupado bloquea su horario.
- Un evento marcado como Disponible no bloquea nada. Usalo para recordatorios.
- Un evento de todo el día marcado como ocupado bloquea el día entero. Si es solo un recordatorio, marcalo como Disponible.
- Las citas que Agenda ya sincronizó a Google no se cuentan dos veces.
Si Google falla
Si Google no responde a tiempo o la conexión está caída, la página ofrece las horas de Agenda como si la opción estuviera apagada: un problema de Google nunca deja tu página sin horas. Por eso importa el aviso: mientras esté, esas horas pueden reservarse aunque estén ocupadas en Google.
Reserva directa
En el modo Reserva directa, Agenda vuelve a preguntarle a Google justo antes de confirmar la cita. Si la profesional anotó un evento en esa hora mientras la clienta completaba sus datos, la clienta ve «Justo tomaron esa hora» y elige otra. Con Cualquiera disponible, la cita queda con alguien que esté libre también en Google.
La página guarda lo que leyó de Google hasta un minuto y medio, así que un evento recién creado puede tardar ese tiempo en ocultar la hora. En reserva directa, la confirmación final igual lo detecta.
Si apagaste Dejar elegir profesional, el equipo se asigna solo y Agenda no puede elegir a quién. En ese caso la hora se rechaza únicamente cuando todo el equipo que puede atenderla está ocupado en Google.
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.
La página ofrece una hora ocupada en Google
Abrí Ajustes → Página de reservas → Fechas y horas y tocá Probar ahora. Si esa profesional no dice Funciona, seguí la indicación que aparece. Revisá también que el evento esté marcado como Ocupado y no como Disponible.
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.