> 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/administracion/integraciones/conectar-google-calendar.md).

# Conectar Google Calendar

Conecta la cuenta de Google de tu negocio: tus citas de Klug aparecen solas en Google Calendar y lo que tengas en Google puede bloquear la agenda.

La conexión se hace en **Administración → Integraciones**, pestaña **Google Calendar**, sección **Conectar con Google Calendar**.

### 1) Antes de empezar

| Necesitas                           | Detalle                                                                                                                                                              |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Módulo de agenda**                | La pestaña **Google Calendar** solo existe en cuentas de Klug.                                                                                                       |
| **Permiso para ver Integraciones**  | En tu rol: **Administración → Integraciones → Listar**. Sin él no ves la pantalla.                                                                                   |
| **Permiso para conectar**           | **Administración → Integraciones → Crear** o **Editar**. Sin él, el botón **Conectar con Google** aparece apagado y no ves **Sincronizar ahora** ni **Desconectar**. |
| **La cuenta de Google del negocio** | La que usa el salón o la clínica, no la personal de un empleado: se conecta **una sola cuenta de Google por negocio**.                                               |

Los usuarios con el rol **Admin** tienen todos estos permisos. Ver [Roles](/klug/modulos/administracion/roles.md).

{% hint style="info" %}
**Atajos.** También llegas aquí desde **Calendario → Agenda → Más acciones → Conectar Google Calendar** (aparece mientras no hay conexión y tienes permiso de ver Integraciones) y desde el paso **Conecta Google Calendar** de la guía **Tu agenda en 5 pasos** del Inicio.
{% endhint %}

### 2) Conectar paso a paso

1. Haz clic en **Conectar con Google**. Klug te lleva a la página de Google.
2. Inicia sesión con la cuenta de Google del negocio (o elígela si ya tienes varias abiertas).
3. Si Google muestra **«Google no verificó esta app»**, elige **Configuración avanzada** y luego **Ir a Klug**. Google todavía está revisando la aplicación.
4. Google te pide permiso para **ver tus calendarios** y **administrar tus eventos**. **Acepta los dos.** Si quitas el acceso a los eventos, Klug no conecta y te muestra: *«Debe permitir el acceso a sus eventos de Google Calendar para conectar la cuenta.»*
5. Google te regresa a la pestaña **Google Calendar** con el aviso **Google Calendar conectado** («Sus citas se están enviando a Google»).

Klug no guarda tu contraseña de Google. Termina el proceso en menos de 15 minutos: si tardas más, el enlace vence y tienes que hacer clic otra vez en **Conectar con Google**.

### 3) Qué pasa al conectar

* Klug usa el **calendario principal** de esa cuenta de Google. Puedes cambiarlo después (paso 4).
* Envía a Google todas las **citas futuras** activas (hasta un año adelante).
* Trae los eventos que ya tienes en Google y los deja **por asignar**: todavía no ocupan la agenda. Los asignas en **Calendario → Agenda → Sincronizar Google**. Ver [Google Calendar en la agenda](/klug/modulos/calendario/sincronizar-google-calendar.md).

Una vez conectado ves:

* El **correo** de la cuenta de Google conectada.
* **Sincronizado** (fecha y hora), cuántas **citas enviadas** y cuántos **bloqueos desde Google** hay.
* **Los cambios en Google llegan al instante** o **Los cambios en Google llegan en unos 5 minutos**, según cómo esté recibiendo Google los avisos.
* Si hay eventos **por asignar**, el número y el botón **Ir a Calendario**.

### 4) Elegir el calendario de Google

En **Calendario de Google** eliges en cuál sincronizar. Te recomendamos uno solo para las citas (por ejemplo «Citas Klug») en lugar del principal:

1. Crea el calendario en Google Calendar desde una computadora (junto a «Otros calendarios», el botón **+** → «Crear calendario»).
2. Regresa a Klug y recarga la página.
3. Elígelo en **Calendario de Google**.

Al cambiar de calendario, Klug quita las citas que había puesto en el calendario anterior, las pone en el nuevo y vuelve a traer los eventos del nuevo calendario como **por asignar**. Lo que habías asignado del calendario anterior se quita de la agenda.

El selector aparece apagado si la cuenta de Google tiene un solo calendario.

### 5) Sincronizar ahora

Haz clic en **Sincronizar ahora** para traer al momento lo que cambió en Google. Klug te dice cuántos eventos son **nuevos**, **actualizados** y **quitados**. Si alguna cita de Klug se cruza con un evento de Google ya asignado, te muestra la lista para que la revises en la agenda.

### 6) Desconectar o cambiar de cuenta

Haz clic en **Desconectar** y confirma. En ese momento:

* Klug deja de enviar y de traer cambios.
* Se quitan de la agenda los **bloqueos futuros** que vinieron de Google.
* Se borran de Google las **citas futuras** que Klug había agregado. Las citas que convertiste desde un evento tuyo de Google se quedan en Google: ese evento ya era tuyo.
* Klug pierde el acceso a tu cuenta de Google.

Para usar **otra cuenta de Google**, primero desconecta y luego haz clic otra vez en **Conectar con Google** con la cuenta nueva. Si vuelves a conectar la **misma** cuenta, Klug conserva el calendario que tenías elegido.

### 7) Las citas en el calendario de tus clientes

En la misma pestaña, **Citas en el calendario de sus clientes** controla los correos que recibe el cliente (no necesita que conectes Google):

* **Invitación de calendario en los correos de citas**: la confirmación y los recordatorios llevan la cita como invitación (Gmail, Apple y Outlook la agregan) y los botones **Agregar a Google Calendar** y **Descargar evento**. Si reprogramas o cancelas en Klug, la cita se mueve o se quita sola de su calendario.
* **Avisar al cliente cuando se reprograma su cita**: si mueves una cita que el cliente ya recibió por correo, le llega la confirmación con el horario nuevo un minuto después del último cambio.

### 8) Otras opciones (sin conectar una cuenta de Google)

Están plegadas en **Otras opciones (sin conectar una cuenta de Google)**:

* **Ver las citas de Klug en el calendario de cada profesional**: elige **Toda la agenda**, **Una sucursal** o **Un profesional**, haz clic en **Crear enlace** y luego en **Agregar a Google Calendar** (con la cuenta de Google de esa persona) o **Copiar enlace** para Apple u Outlook. Es solo para ver: Google tarda unas horas en mostrar los cambios y lo que la persona tenga en su calendario no bloquea su horario. Quien tenga el enlace ve los nombres de los clientes: si se filtra, cámbialo con la flecha.
* **Bloquear horarios con otro calendario (iCal)**: pega la **Dirección secreta en formato iCal** de un calendario de Google, iCloud u Outlook, elige **Agenda de** (el profesional) y haz clic en **Conectar**. Cada evento, desde hoy hasta un año, bloquea el horario de ese profesional. Klug revisa los cambios cada 15 minutos. Si ya conectaste tu cuenta de Google arriba, no lo necesitas.

### 9) Problemas comunes

| Lo que ves                                                                                                            | Qué hacer                                                                                                                      |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Conectar con Google** está apagado                                                                                  | Te falta el permiso **Administración → Integraciones → Crear** o **Editar**. Pídelo al administrador.                          |
| «La conexión con Google todavía no está disponible»                                                                   | Klug no tiene activa la conexión con Google en el servidor. Usa **Otras opciones** mientras tanto y avísale a soporte.         |
| «Google no verificó esta app»                                                                                         | Elige **Configuración avanzada** → **Ir a Klug**.                                                                              |
| «Debe permitir el acceso a sus eventos de Google Calendar…»                                                           | Vuelve a conectar y marca las dos casillas de permisos de Google.                                                              |
| «El enlace de autorización venció…»                                                                                   | Pasaron más de 15 minutos. Haz clic otra vez en **Conectar con Google**.                                                       |
| «No se dio acceso a Google Calendar.»                                                                                 | Cancelaste en Google. Vuelve a intentarlo y acepta.                                                                            |
| En rojo bajo el correo: «Google ya no permite el acceso a este calendario. Desconecte y vuelva a conectar la cuenta.» | Alguien quitó el acceso de Klug desde la configuración de la cuenta de Google. Haz clic en **Desconectar** y conecta de nuevo. |
| «No se pudo leer Google Calendar (…). Se reintentará.»                                                                | Falla pasajera de Google. Klug lo vuelve a intentar solo; también puedes usar **Sincronizar ahora**.                           |
| No aparece **Conectar Google Calendar** en **Más acciones**                                                           | Ya hay una cuenta conectada, o no tienes permiso de ver Integraciones.                                                         |
