# Conectar Google Calendar a Pilotiko

> Qué hace realmente la conexión con Google Calendar en Pilotiko: alcance calendar.events, periodos ocupados, invitaciones, estado actual y revocación del acceso.

Actualizado el 8 de noviembre de 2026 · https://app.pilotiko.com/es/integraciones/google-calendar

Hoy, Pilotiko gestiona sus citas y sus horarios libres con su propia agenda, sin Google. El conector de Google Calendar lee sus eventos (horas, títulos, participantes), obtiene de ellos sus periodos ocupados, los conserva en la memoria de su empresa y crea eventos. Estado: Disponible.

## En resumen
- La agenda de Pilotiko ya funciona por sí sola: reserva de citas en línea, horarios libres reales, asignación propuesta.
- La conexión con Google solicita el alcance calendar.events, además de openid y email para saber qué cuenta está conectada.
- Una reunión que envía invitaciones siempre espera la aprobación de una persona.

## ¿Qué hace la conexión con Google Calendar?

Sirve para dos cosas: saber cuándo ya está ocupado e incluir en su calendario de Google las reuniones planificadas en Pilotiko, con un enlace de Google Meet si es necesario.

Pilotiko ya tiene su propia agenda: calcula los horarios libres a partir de los horarios de su equipo y de las citas que conoce. Sin embargo, mucha gente vive en Google Calendar: una cena de negocios, una cita con el dentista, una capacitación. La conexión evita ofrecer a un cliente una hora en la que la persona no está libre, y también evita registrar dos veces la misma reunión.

Para ello, Pilotiko solicita a Google tres autorizaciones. La principal, **calendar.events**, es descrita por Google como « View and edit events on all your calendars »: ver y editar los eventos de sus calendarios [1]. Las otras dos, **openid** y **email**, solo sirven para mostrar qué cuenta está conectada. Pilotiko no solicita Gmail ni Drive con esta conexión; el envío de correos pasa por [la conexión de Gmail](https://app.pilotiko.com/es/integraciones/gmail), que es distinta.

Para los periodos ocupados, el conector lee la lista de sus eventos (events.list), que el alcance calendar.events cubre; no llama al método freeBusy, que exigiría otro alcance [2]. Un evento cancelado, marcado como « disponible » o rechazado no bloquea ningún horario.

Los eventos leídos (hora, título, descripción, lugar, participantes) también pasan a la memoria de su empresa, para que el asistente sepa a quién ha atendido y cuándo.

- **Lo que se lee en Google**: la lista de sus calendarios y los periodos ocupados (solo inicio y fin) en un intervalo dado.
- **Lo que se escribe en Google**: un evento con título, descripción, hora, participantes y, si se solicita, una conferencia de Google Meet; su modificación o cancelación.
- **Invitaciones**: Pilotiko pide a Google que avise a los participantes (parámetro sendUpdates=all) cuando crea, mueve o cancela una reunión.
- **Aprobación**: planificar una reunión que envía invitaciones exige la aprobación de una persona. El asistente propone; usted decide.
- **Verificación**: cada paso (reunión, evento, invitación) se revisa; si uno falla, lo que se haya creado se cancela.

## ¿Cómo conectar Google Calendar a Pilotiko?

1. **Abrir la página Conexiones** — En Pilotiko, vaya a Conexiones, tarjeta Google Calendar. Si Pilotiko aún no ha activado este proveedor para su cuenta, la tarjeta lo indica en lugar de mostrar un botón que no llevaría a ninguna parte.
2. **Elegir la cuenta de Google** — Haga clic en Conectar. Se le envía a Google, a la cuenta que contiene el calendario de la empresa o el suyo.
3. **Leer la pantalla de consentimiento** — Google muestra las autorizaciones solicitadas: ver y editar los eventos de sus calendarios, su dirección de correo y su identidad. Nada más.
4. **Autorizar y volver** — Tras su aceptación, Google redirige a Pilotiko con un código de un solo uso. Pilotiko lo intercambia por tokens, que cifra de inmediato.
5. **Verificar el estado** — La tarjeta pasa a Conectado. Un error de renovación la hace pasar a Por reconectar, nunca a un fallo silencioso.

## ¿Qué está disponible y qué está por venir?

| Función | Estado | Detalle |
|---|---|---|
| Citas en línea y horarios libres de la agenda de Pilotiko | Disponible | Funciona sin Google, a partir de los horarios del equipo. |
| Archivo .ics « Agregar a mi calendario » para el cliente | Disponible | Formato iCalendar leído por Google, Apple y Outlook. |
| Lectura de los periodos ocupados en Google Calendar | Disponible | Lectura de eventos con calendar.events. |
| Creación, traslado y cancelación de eventos con invitación | Disponible | Cada paso se revisa; en caso de fallo, lo que se haya creado se cancela. |
| Enlace de Google Meet en una reunión | Disponible | Se solicita a Google al crear el evento. |
| Transcripciones de Google Meet | Próximamente | Nada está construido. |
| Conexión del calendario personal de cada empleado | Disponible | calendar.events, desde Mis conexiones. |

Estados leídos en el registro de capacidades de Pilotiko: Google Calendar figura allí como adaptador.

## ¿Cómo es una semana de citas sincronizadas?

**Ejemplo: un equipo de 3 técnicos en Sherbrooke**

Cada técnico ofrece 40 horas de franjas de servicio por semana en Pilotiko. Una vez conectado Google Calendar, Pilotiko retira de esas franjas los periodos marcados como ocupados en los calendarios de Google.

Las citas duran 90 minutos. El cálculo muestra cuántas citas completas caben aún en la semana.

- Franjas ofrecidas (3 × 40 h) : 120 h
- Periodos ocupados leídos en Google Calendar : − 18 h
- Horas realmente libres : 102 h
- Citas de 1,5 h posibles (102 ÷ 1,5) : 68
- Citas ya tomadas en la semana : − 41
- **= 27 citas de 90 minutos aún disponibles, sin superposición con los calendarios de Google.**

## ¿Cómo se protegen sus datos de Google?

Los tokens entregados por Google se cifran en reposo (AES-256-GCM) y nunca salen del servidor; su navegador no los ve. El enlace de conexión lleva un parámetro « state » de un solo uso, vinculado a su empresa y a su usuario, que caduca a los 10 minutos. Además, el código de autorización está protegido por PKCE, el método normalizado por la IETF para impedir la interceptación de un código [5].

Pilotiko lee sus eventos (hora, título, descripción, lugar, participantes) para sus disponibilidades y para la memoria de su empresa; solo son visibles para las personas de su empresa que tienen acceso. La Ley sobre la protección de los datos personales en el sector privado, modernizada por la Loi 25 (Ley 25), exige informar a la persona de los fines de la recopilación y de su derecho a retirar el consentimiento (art. 8), y un consentimiento otorgado para fines específicos (art. 14) [4]. La pantalla de Google y la tarjeta de Pilotiko sirven para eso: decir para qué sirve el acceso antes de que usted lo otorgue. Más detalles en [la página Seguridad](/securite) y en [la política de confidencialidad](/confidentialite).

El acceso se retira de ambos lados. En Pilotiko, Desconectar borra los tokens, borra de la memoria los eventos leídos en Google (salvo los hechos que una persona de su empresa haya validado) y registra la acción en el registro de auditoría. En Google, la página Aplicaciones asociadas de su cuenta permite elegir Pilotiko y luego « Eliminar acceso »; Google precisa que, después, la aplicación ya no puede acceder a su cuenta [3].

## ¿Cuáles son los límites hoy?

- Las citas que toman sus clientes permanecen primero en la agenda de Pilotiko; la copia automática hacia Google aún no está en servicio.
- Las transcripciones de Google Meet no están construidas; para los resúmenes de reuniones, vea [Zoom](https://app.pilotiko.com/es/integraciones/zoom) y [Microsoft Teams](https://app.pilotiko.com/es/integraciones/microsoft-teams).
- Si su empresa vive en Microsoft 365, la página [Outlook / Microsoft 365](https://app.pilotiko.com/es/integraciones/outlook-microsoft-365) describe el equivalente; todas las conexiones están listadas en [el índice de integraciones](https://app.pilotiko.com/es/integraciones).

## Preguntas frecuentes

### ¿Necesito Google Calendar para tomar citas con Pilotiko?

No. La reserva de citas en línea y el cálculo de los horarios libres funcionan solo con la agenda de Pilotiko. Google Calendar añade la consideración de sus demás compromisos, una vez conectado el conector.

### ¿Puede Pilotiko leer el contenido de mis eventos?

Sí, una vez conectado el calendario: Pilotiko lee la hora, el título, la descripción, el lugar y los participantes de sus eventos, para sus disponibilidades y para la memoria de su empresa. La pantalla de Google lo muestra antes de su aceptación (calendar.events: ver y editar los eventos).

### ¿Reciben mis clientes una invitación de Google?

Cuando se crea una reunión en su calendario de Google, Pilotiko pide a Google que avise a los participantes. Esta creación espera la aprobación de una persona.

### ¿Pilotiko agrega un enlace de Google Meet?

Sí, si la reunión está prevista por videoconferencia y Google Meet es la herramienta elegida, Pilotiko lo solicita al crear el evento.

### ¿Cómo cortar el acceso de Pilotiko a mi agenda?

Haga clic en Desconectar en la página Conexiones de Pilotiko: los tokens se borran. Retire también el acceso en las Aplicaciones asociadas de su cuenta de Google para que la autorización quede anulada en Google.

### ¿Y Apple Calendario o un enlace iCal?

Pilotiko no se conecta a iCloud ni a una suscripción iCal. Solo proporciona a sus clientes, después de una cita, un archivo .ics «Añadir a mi calendario», que Apple, Google y Outlook saben abrir.

## Fuentes

1. Google for Developers, « Choose Google Calendar API scopes », https://developers.google.com/workspace/calendar/api/auth (consultado el 2026-10-15)
2. Google for Developers, « Freebusy: query (Google Calendar API) », https://developers.google.com/workspace/calendar/api/v3/reference/freebusy/query (consultado el 2026-10-15)
3. Aide Compte Google, « Gérer les associations entre votre compte Google et les applications d'autres développeurs », https://support.google.com/accounts/answer/13533235?hl=fr (consultado el 2026-10-15)
4. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (consultado el 2026-10-15)
5. RFC Editor (IETF), « RFC 7636 : Proof Key for Code Exchange by OAuth Public Clients », https://www.rfc-editor.org/rfc/rfc7636 (consultado el 2026-10-15)
