# Gmail y Pilotiko: sus correos leídos, clasificados y respondidos desde su dirección

> Qué solicita la conexión Gmail de Pilotiko (lectura y envío), qué lee, qué conserva, qué espera su aprobación y cuál es su estado actual hoy.

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

La conexión Gmail de la empresa lee, en solo lectura, sus correos (24 meses de historial y luego los nuevos), sus contactos y su agenda, para que la secretaria IA clasifique las solicitudes y prepare las respuestas. Envía desde su dirección los mensajes que una persona haya aprobado. Alcances: gmail.readonly, gmail.send, contacts.readonly, calendar.readonly. Estado: Disponible.

## En resumen
- Alcances solicitados para la bandeja de la empresa: gmail.readonly, gmail.send, contacts.readonly, calendar.readonly, openid y email. Para la bandeja de una persona: gmail.send, openid y email.
- Lo que se lee: sus correos de todas las etiquetas, sus contactos y su agenda, conservados en la memoria de su empresa. Pilotiko no modifica, no archiva ni elimina ningún correo en Gmail.
- Lo que se envía: solo lo que una persona haya aprobado (respuestas, confirmaciones, recordatorios).
- Puede retirar el acceso con un clic en Pilotiko y también en su cuenta de Google.

## ¿Qué hace la conexión Gmail?

Otorga a Pilotiko el derecho de leer su bandeja, sus contactos y su agenda, y de enviar un correo en su nombre. La secretaria IA clasifica los correos recibidos y prepara respuestas; nada sale sin la aprobación de una persona.

Google clasifica sus permisos en tres familias. Google describe el alcance **gmail.send** como « Send email on your behalf » y figura entre los alcances llamados sensibles [1]. La lectura de la bandeja se hace con **gmail.readonly**, un alcance restringido que exige la verificación de la aplicación y una evaluación de seguridad en Google [1]. Pilotiko lo solicita para la bandeja de la empresa.

La lectura abarca los correos de todas las etiquetas, primero los últimos 24 meses y luego cada correo nuevo. Los correos se conservan en la memoria de su empresa y se analizan automáticamente (reglas y luego un modelo de IA) para extraer lo útil: solicitudes de clientes, precios ya enviados, citas. Pilotiko no modifica, no archiva ni elimina ningún correo en Gmail.

En concreto, el conector compone un mensaje de texto (destinatario, asunto, cuerpo), lo codifica y lo envía mediante el método users.messages.send de la API de Gmail [2]. Google describe este método como el envío del mensaje a los destinatarios de los encabezados To, Cc y Bcc [2]. Los nombres y asuntos se depuran para impedir la inyección de encabezados mediante un nombre de cliente malicioso.

El correo nunca se envía dos veces por error: cada mensaje lleva una clave única, un mismo destinatario con el mismo asunto en los últimos 10 minutos se deduplica, y los reintentos tras una falla siguen una espera creciente (1 minuto, 5 minutos, 30 minutos).

- **gmail.readonly**: leer sus correos, en solo lectura. Sin modificación ni eliminación.
- **contacts.readonly** y **calendar.readonly**: leer sus contactos y su agenda, en solo lectura.
- **gmail.send**: enviar un correo en su nombre, solo después de la aprobación de una persona.
- **openid** y **email**: saber qué cuenta de Google se vinculó, para mostrarla en la página Conexiones.
- **Lo que se lee en Google**: sus correos, sus contactos y su agenda. Usted elige lo que se lee (correos, contactos, agenda) en la página Conexiones.
- **Lo que se escribe en Google**: los correos aprobados, enviados desde su dirección. Nada más se modifica en su cuenta.
- **Lo que espera a una persona**: todo mensaje que no derive de una cita ya aceptada (oferta, seguimiento comercial, respuesta a un cliente) queda como borrador por aprobar en Pilotiko.

## ¿Cómo vincular Gmail con Pilotiko?

1. **Abrir la página Conexiones** — En Pilotiko, abra Conexiones, grupo Correos de la empresa. Si la tarjeta Gmail muestra « À activer par Pilotiko » (por activar por Pilotiko), la conexión aún no está disponible para su cuenta: no se muestra ningún botón ficticio.
2. **Hacer clic en Conectar** — Pilotiko lo envía a la página de consentimiento de Google, con un parámetro de seguridad de un solo uso que caduca a los 10 minutos.
3. **Leer la pantalla de Google** — Google muestra los permisos solicitados: leer sus correos, sus contactos y su agenda, y enviar correos en su nombre. Acepte con la cuenta que representa a la empresa.
4. **Elegir Gmail como remitente** — Si hay varias bandejas vinculadas (Gmail, Outlook, Zoho Mail), indique cuál habla en nombre de la empresa. Pilotiko no elige por usted.
5. **Hacer un envío de prueba** — Envíe un recordatorio de prueba a una dirección del equipo y verifique al recibirlo el remitente, el asunto y la hora de la cita.

## ¿Qué está disponible o próximo con Gmail?

| Función | Estado | Detalle |
|---|---|---|
| Autorización de Google (OAuth 2.0 con PKCE) | Disponible | Flujo OAuth 2.0 con PKCE. |
| Envío de confirmaciones de citas | Disponible | Enviadas desde su dirección, tras la aprobación. |
| Recordatorios 24 h y 1 h antes | Disponible | Misma vía de envío que las confirmaciones. |
| Lectura y clasificación de la bandeja de entrada | Disponible | Solo lectura (gmail.readonly), clasificación por la secretaria IA, respuestas preparadas por aprobar. |
| Boletines y secuencias de marketing | Próximamente | No pasan por Gmail; el consentimiento y la baja existen, el envío real está por venir. |

## ¿Cómo es una semana de recordatorios enviados por Gmail?

**Ejemplo: una clínica de fisioterapia con 3 terapeutas**

La clínica recibe 18 citas por día, 5 días por semana. Cada cita genera una confirmación, un recordatorio el día anterior y un recordatorio una hora antes.

Estos mensajes salen de la dirección de la clínica, y las respuestas de los pacientes llegarían a su bandeja Gmail habitual.

- Citas por semana : 18 × 5 = 90
- Correos por cita : 3 (confirmación, recordatorio 24 h, recordatorio 1 h)
- Correos por semana : 90 × 3 = 270
- Correos por día laborable : 270 ÷ 5 = 54
- **= Aproximadamente 54 correos por día laborable, enviados desde la dirección de la clínica.**

## ¿Qué sucede con sus datos y cómo retirar el acceso?

El token entregado por Google se cifra en reposo (AES-256-GCM) y nunca sale del servidor de Pilotiko: no aparece en los registros, ni en la pantalla, ni en un mensaje de error. Los correos, contactos y eventos leídos se copian en la memoria de su empresa, visibles solo para las personas de su empresa que tienen acceso.

En Quebec, una empresa debe informar a la persona de los fines de la recopilación y de su derecho a retirar su consentimiento [4]. El consentimiento debe ser manifiesto, libre, informado y otorgado para fines específicos [4]. Aquí, los fines están escritos en la pantalla de Google y en esta página: leer su bandeja para clasificar y preparar su trabajo, y enviar lo que usted apruebe.

Para cortar el acceso: en Pilotiko, Conexiones → Gmail → Desconectar. Los tokens se borran, lo que Pilotiko leyó en Gmail (correos, contactos, citas) se borra de la memoria, salvo los hechos que una persona de su empresa haya validado, y la acción queda registrada en el registro de auditoría. Luego, en su cuenta de Google, abra la página de aplicaciones vinculadas, elija Pilotiko y después « Eliminar acceso » [3]. Google precisa que, tras esta eliminación, la aplicación ya no puede acceder a la cuenta [3].

Detalles técnicos: la página [Seguridad](/securite) y la [política de privacidad](/confidentialite).

## ¿Cuáles son los límites de la conexión Gmail?

- Sin ordenamiento en Gmail: Pilotiko no clasifica, no archiva ni marca ningún correo como leído en su bandeja (ningún alcance gmail.modify); la clasificación se ve en Pilotiko.
- Correo en texto simple: por ahora, sin formato HTML ni archivos adjuntos por esta vía.
- El protocolo de autorización sigue el estándar PKCE (RFC 7636) [5].
- Si el token caduca y no puede renovarse, la tarjeta pasa a « À reconnecter » (por reconectar); nada se envía en silencio.
- Para Outlook, vea [la integración Outlook / Microsoft 365](https://app.pilotiko.com/es/integraciones/outlook-microsoft-365); para una bandeja alojada en Canadá en Zoho, [la integración Zoho Mail](https://app.pilotiko.com/es/integraciones/zoho-mail); para los mensajes de texto, [la integración Twilio](https://app.pilotiko.com/es/integraciones/twilio).

## Preguntas frecuentes

### ¿Puede Pilotiko leer mis correos de Gmail?

Sí, si vincula la bandeja de la empresa: Pilotiko solicita gmail.readonly (solo lectura), contacts.readonly y calendar.readonly. Lee para clasificar y preparar las respuestas, sin modificar ni eliminar nada en Gmail. La bandeja de una persona, en cambio, solo solicita el envío (gmail.send).

### ¿Las confirmaciones ya salen de mi dirección de Gmail?

Sí, una vez vinculada la bandeja: cada confirmación sale de su dirección, tras la aprobación de una persona cuando corresponde.

### ¿Se necesita una cuenta de Google Workspace o basta con una cuenta gratuita de Gmail?

Pilotiko no exige ningún plan de Google: solo solicita la autorización para enviar desde la cuenta que usted elija. Una dirección en su propio dominio resulta más clara para sus clientes que una dirección genérica.

### ¿Qué ocurre si Google retira la autorización de Pilotiko?

La tarjeta de Gmail pasa a «Por reconectar» y muestra el motivo. Los mensajes pendientes permanecen en cola: Pilotiko nunca afirma que un correo salió si no recibió la respuesta de Google.

### ¿Puedo vincular Gmail y Outlook al mismo tiempo?

Sí, pero solo un buzón habla en nombre de la empresa. Si hay varios vinculados, Pilotiko le pide que elija cuál usar para las confirmaciones.

### ¿Cómo saber que un recordatorio realmente salió?

Pilotiko solo registra «enviado» después de la confirmación de Gmail, que devuelve el identificador del mensaje. Sin ese identificador, el envío se trata como un fallo y se reintenta más tarde, nunca se cuenta como exitoso.

## Fuentes

1. Google for Developers, « Choose Gmail API scopes », https://developers.google.com/workspace/gmail/api/auth/scopes (consultado el 2026-10-15)
2. Google for Developers, « Method: users.messages.send (Gmail API) », https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/send (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)
