Gmail

La integración con Gmail es probablemente la más importante para un CSM. Alimenta el timeline, el sentimiento y la dimensión de engagement del score de salud.

Qué hace

• Timeline automático — cada email hacia o desde un contacto asociado a un cliente queda en su ficha.
• Asignación automática — si un participante del email es un contacto registrado de un cliente, el mensaje se asocia a ese cliente solo.
• IA con contexto — cuando le preguntes "qué pasó con Acme este mes", la IA puede leer los emails sincronizados.
• Señales de salud — frecuencia, tiempo de respuesta, sentimiento NLP alimentan la dimensión Engagement.
• Respuesta desde LealUp — responder sin salir de la ficha, desde tu propia cuenta.

Qué NO hace

• No manda emails automáticos sin que un humano los despache.
• No modifica tus labels ni crea folders.
• No lee emails de otros miembros del equipo — cada CSM conecta su propia cuenta.

Cómo conectar

Esta integración es por usuario, no por workspace.

1. Configuración → Integraciones → Gmail → Conectar.
2. Flow OAuth de Google. Es una sola autorización que cubre los cuatro scopes que usa LealUp — no hay opt-in por scope:
   • https://www.googleapis.com/auth/gmail.readonly — leer mensajes.
   • https://www.googleapis.com/auth/gmail.send — enviar desde tu cuenta.
   • https://www.googleapis.com/auth/calendar.events — leer y crear eventos (Google Calendar).
   • https://www.googleapis.com/auth/userinfo.email — saber qué cuenta conectaste.
3. Autorizas el acceso.
4. Backfill inicial — LealUp lee los últimos 7 días de tu bandeja y guarda los mensajes en los que participa un contacto de cliente. De ahí en adelante la sincronización es continua.

Ese backfill inicial no es configurable. Si necesitas traer más histórico, escríbenos y lo vemos caso a caso.

Scopes y seguridad

Usamos los scopes más estrechos que existen para lo que hace el producto. gmail.readonly es el scope más acotado de Google que devuelve el cuerpo de un mensaje — gmail.metadata entrega solo cabeceras (no sirve para análisis de sentimiento) y está igual de restringido. No pedimos modify, delete, ni Contacts API.

Leer y guardar son cosas distintas, y la diferencia importa:

• Leemos los mensajes de la ventana sincronizada de tu bandeja. La API de Gmail no permite filtrar por remitente en el sync incremental, así que la única forma de saber si un mensaje es de un cliente es leerlo.
• Guardamos cabeceras y cuerpo solo de los mensajes en los que participa un contacto registrado de alguno de tus clientes, en el timeline de ese cliente.
• No guardamos nada de los mensajes que no involucran a ningún contacto de cliente. Se descartan en el momento — tu correspondencia personal no llega a la base de datos.
• Attachments — solo nombre, tamaño y tipo. Nunca el contenido del archivo.

Revoca en cualquier momento desde myaccount.google.com/permissions. LealUp detecta la revocación en minutos y marca la integración como desconectada.

Cómo se asocian emails a clientes

Se comparan los participantes del mensaje (from, to, cc) contra los emails de contacto registrados de tus clientes. La coincidencia es por dirección exacta, no por dominio.

Tu propia dirección queda fuera de la comparación: muchos CSM están registrados como contacto en varios clientes, y sin esa exclusión cada mensaje tuyo coincidiría con todos ellos.

Según cuántos clientes coincidan:

1. Un cliente → el mensaje queda en el timeline de ese cliente.
2. Ningún cliente → se descarta. No se guarda nada.
3. Dos o más clientes → va a Correos sin Asignar para que elijas a cuál pertenece. Pasa cuando un contacto trabaja con dos de tus clientes, o cuando el thread tiene participantes de ambos.

IA y Gmail

La IA de LealUp puede responder preguntas usando los emails indexados:

• "Qué se habló con Acme sobre renovación?"
• "Resume los últimos 5 emails con María de Globex."
• "Algún cliente mencionó 'cancelar' esta semana?"

Todo queda dentro del workspace. LealUp no usa tus emails para entrenar modelos globales.

Sentimiento y NLP

De los emails sincronizados, LealUp analiza:

• Tono — positivo / neutro / negativo (modelo multilingüe ES/PT/EN).
• Palabras clave críticas — competidores, términos como "cancelar", "terminar", "problemas", "bug crítico".
• Tiempo de respuesta — cuánto tarda tu champion en responderte (proxy de interés).

Estas señales alimentan la dimensión Sentimiento del score de salud. Ver Modelo de salud.

Responder desde LealUp

• En Cliente 360 → Timeline → botón "Responder" al lado de un email.
• Se abre un compositor con el thread. El email sale desde tu cuenta de Gmail (como si lo hubieras escrito en Gmail directo).
• Queda en tu Enviados real de Gmail — no vive solo en LealUp.

La IA puede sugerir borradores basados en contexto:

• "Escribe una respuesta al último email de María agradeciendo el feedback y pidiendo referir un caso."

Siempre revisas y envías tú. No hay envío automático.

Extensión de Chrome (opcional)

Para loguear emails desde Gmail.com directo sin salir:

1. Instala la LealUp Gmail Extension desde Chrome Web Store.
2. En cualquier email, aparece botón "Log to LealUp".
3. Se asocia al cliente automáticamente (o sugiere opciones si hay ambigüedad).

La extensión es opcional — la integración OAuth ya indexa emails. La extensión ayuda para notas rápidas o asociación manual de casos ambiguos.

Problemas comunes

"No veo mis emails en el timeline"

• Verifica que la dirección de la otra persona esté registrada como contacto del cliente. La coincidencia es por dirección exacta: si el contacto no está, el mensaje no se guarda.
• Backfill inicial puede tardar hasta 30 min para cuentas grandes.
• Confirma que la integración dice "conectada" en Integraciones.

"Gmail dice que el acceso se revocó"

• Algún admin de Google Workspace cambió la política de apps OAuth.
• Reconectar: Configuración → Integraciones → Gmail → Reconectar.
• Si persiste, contacta a tu admin de Workspace para whitelist LealUp.

"La IA no encuentra el email de X"

• Puede estar en un thread antiguo (fuera de la ventana de 90 días).
• La dirección del remitente puede no estar registrada como contacto de ningún cliente — en ese caso el mensaje nunca se guardó.
• La IA solo lee lo indexado; si no se indexó, no lo ve.

"Veo emails de mi vida personal en el timeline"

• Esto no debería pasar: un mensaje solo se guarda si uno de sus participantes está registrado como contacto de un cliente.
• La causa habitual es un contacto registrado con una dirección personal que también usas para tus cosas. Revisa los contactos de ese cliente y quita la dirección que no corresponda.
• Si no es eso, es un bug — reporta con el trace_id.

Desconectar

Configuración → Integraciones → Gmail → Desconectar

• Revoca el token OAuth (vía Google).
• Los emails indexados quedan (para preservar historia del cliente).
• Si quieres borrar los emails también: Soporte → Solicitar borrado de data de Gmail.