> For the complete documentation index, see [llms.txt](https://solaytech.gitbook.io/klug/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://solaytech.gitbook.io/klug/modulos/calendario/sincronizar-google-calendar.md).

# Google Calendar

Qué se sincroniza entre Klug y Google Calendar, cómo asignar tus eventos de Google a la agenda y qué pasa cuando algo cambia.

Esta página explica cómo trabaja la agenda cuando tu negocio ya conectó su cuenta de Google. Para conectarla, ver [Conectar Google Calendar](/klug/modulos/administracion/integraciones/conectar-google-calendar.md).

### 1) Qué se sincroniza

| Dirección         | Qué pasa                                                                                                                                                                                                                                                                                                        | Cuándo                                                                                                                                         |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Klug → Google** | Cada cita activa de la agenda aparece en el calendario de Google conectado, con el título **Cliente — Servicio (Profesional)**, la sucursal como lugar y el color de la profesional (el más parecido de Google). En la descripción van el teléfono, el correo, quién atiende, las notas y el código de la cita. | Unos segundos después de crear, mover o cambiar la cita (menos de un minuto).                                                                  |
| **Google → Klug** | Los eventos del calendario de Google llegan a Klug **por asignar**: no ocupan la agenda hasta que tú decides qué hacer con cada uno.                                                                                                                                                                            | Al instante cuando Google avisa del cambio; si no, en unos 5 minutos. También al abrir **Sincronizar Google** o al usar **Sincronizar ahora**. |

Klug no vuelve a traer como evento de Google las citas que él mismo envió, así que no se duplican.

{% hint style="warning" %}
**Las citas se cambian en Klug, no en Google.** Si mueves o editas en Google una cita que vino de Klug, ese cambio no regresa a Klug. La única excepción es borrarla: si borras en Google el evento de una cita **Creada** o **Confirmada** que todavía no pasa, la cita se **cancela** en Klug (y, si lo tienes activo, el cliente recibe el aviso de cancelación).
{% endhint %}

### 2) Asignar los eventos de Google

Mientras haya eventos por asignar, en **Calendario → Agenda** aparece el botón **Sincronizar Google (n)**, donde *n* es cuántos faltan. Si no hay pendientes, la opción está en **Más acciones → Sincronizar Google**.

1. Haz clic en **Sincronizar Google**. Klug trae lo más reciente de Google y abre **Sincronizar Google Calendar** con los eventos por asignar de los **próximos 30 días**.
2. Para cada evento elige una opción:
   * **Asignar a…**: elige un profesional (grupo **Profesionales**) o una sala, silla o estación (grupo **Recursos**). Ese horario queda bloqueado solo en esa agenda.
   * **Ignorar**: no afecta la agenda. Útil para pendientes personales o recordatorios. Si te equivocas, haz clic en **Deshacer** antes de terminar.
   * **Convertir en cita**: se cierra la lista y se abre **Nueva cita** con la fecha y la hora del evento; su título y lugar quedan en la **Nota**. Elige cliente y servicio y guarda. La cita queda ligada al **mismo** evento de Google (no se duplica) y su canal es **Google Calendar**.
3. Abajo ves cuántos llevan decisión (por ejemplo «3 de 5 con decisión»). Cuando todos la tengan, haz clic en **Terminar sincronización**.

{% hint style="info" %}
Si una decisión no se puede guardar, Klug no guarda ninguna de esa lista y te dice por qué. Corrige y vuelve a hacer clic en **Terminar sincronización**.
{% endhint %}

### 3) Cambiar un evento ya asignado

Los eventos asignados aparecen en la agenda como un bloqueo gris. Haz clic en él para abrir **Evento de Google Calendar**, cámbialo a otra persona o recurso, ignóralo o conviértelo en cita, y haz clic en **Guardar**.

Un evento ignorado ya no ocupa la agenda ni vuelve a la lista de pendientes.

### 4) Qué pasa cuando algo cambia

| Cambio                                                        | Resultado                                                                               |
| ------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Creas, mueves o cambias de profesional una cita en Klug       | Se actualiza en Google.                                                                 |
| Cancelas una cita o la marcas **No asistió** en Klug          | Se quita de Google.                                                                     |
| La cita pasa a **Terminada** o **Facturada**                  | Sigue en Google.                                                                        |
| Mueves en Google un evento que ya asignaste                   | El bloqueo se mueve con él en Klug. Tu decisión (a quién bloquea) se respeta.           |
| Borras en Google un evento asignado o por asignar             | Desaparece de Klug.                                                                     |
| Borras en Google el evento de una cita de Klug                | La cita se cancela en Klug (solo si estaba **Creada** o **Confirmada** y no ha pasado). |
| Editas en Google el evento de una cita de Klug (hora, título) | No cambia nada en Klug. Haz el cambio en la agenda.                                     |

### 5) Qué eventos de Google se traen

* Los de hoy en adelante, hasta un año.
* Los de **todo el día** bloquean el día completo, uno por cada día que dure.
* Los eventos con hora marcados en Google como **Disponible** no se traen: no bloquean.
* Los que no tienen título aparecen como **Ocupado**.

### 6) Ten en cuenta

* Mientras un evento esté **por asignar**, no bloquea la agenda: alguien podría agendar o reservar en línea a esa hora. Revisa **Sincronizar Google** cuando veas el número.
* Un evento asignado a un profesional bloquea solo su agenda; asignado a un recurso, solo choca con las citas que usan ese recurso.
* Las citas que convertiste desde Google aparecen con el canal **Google Calendar** en **Filtros → Canal** y en el **Listado**.
* Quien ve la agenda (**Calendario → Agenda → Listar** en su rol) puede usar **Sincronizar Google** y asignar eventos. Conectar o desconectar la cuenta se hace en Integraciones, con otro permiso.

### 7) Preguntas frecuentes

**¿Cada profesional conecta su propio Google?** No. Se conecta una sola cuenta de Google por negocio. Si cada profesional quiere ver sus citas en su celular, crea un **enlace por profesional** en [Conectar Google Calendar → Otras opciones](/klug/modulos/administracion/integraciones/conectar-google-calendar.md#8-otras-opciones-sin-conectar-una-cuenta-de-google).

**No veo el botón Sincronizar Google.** Aparece solo cuando hay una cuenta conectada. Sin conexión, en **Más acciones** verás **Conectar Google Calendar** (si tienes permiso de ver Integraciones).

**Agendé algo en Google y en Klug alguien reservó a esa hora.** El evento seguía **por asignar**. Asígnalo a la profesional en **Sincronizar Google** para que bloquee su horario.

**Una cita desapareció de Klug.** Revisa si alguien borró su evento en Google: eso cancela la cita. En la cita, la pestaña **Actividad** muestra el cambio de estado.

**Moví la cita en Google y en Klug sigue igual.** Es lo esperado: los cambios de las citas se hacen en Klug. Muévela en la agenda y Google se actualiza solo.

**Google tarda en mostrar las citas.** Con la cuenta conectada tardan segundos. Si usas el **enlace por profesional** (Otras opciones), Google lo refresca cada varias horas: eso no se puede acelerar desde Klug.