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 por dominio — emails de @acme.com se asocian al cliente Acme automáticamente.
• 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 (opcional, requiere scope de send) — responder sin salir de la ficha.

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. Aceptas los scopes:
   • https://www.googleapis.com/auth/gmail.readonly — leer.
   • https://www.googleapis.com/auth/gmail.send — opcional, para responder desde LealUp.
3. Autorizas el acceso.
4. Backfill inicial — LealUp indexa los últimos 90 días de threads que involucren dominios de clientes.

Los 90 días son configurables (hasta 365) en plan Scale+.

Scopes y seguridad

Usamos los scopes mínimos necesarios:

• readonly por defecto.
• send solo si activas "Responder desde LealUp".
• No modify, no delete, no contacts API.

Almacenamos:

• Metadata (from, to, subject, date, thread_id, label_ids) — siempre.
• Cuerpo del email — solo de threads asociados a clientes (no tu bandeja personal completa).
• Attachments — nombres y tamaños sí; contenido solo si explícitamente pides "indexar attachments".

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

Por orden de precedencia:

1. Dominio del remitente/destinatario coincide con email_domain del cliente.
2. Email del contacto está registrado en los contactos del cliente.
3. Referencia en el body — si el email menciona explícitamente al cliente (manual, opcional).

Si un email involucra dos dominios de cliente distintos (ej. un CSM hablando con Acme y Globex en el mismo thread), se duplica en ambos timelines con etiqueta "compartido".

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

Si activaste el scope de send:

• 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 el dominio del cliente esté bien en su ficha (email_domain).
• 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).
• Puede ser de un dominio no asociado al cliente.
• 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. Si pasa, es un bug — reporta con el trace_id.
• Mitigación inmediata: revisa email_domain del cliente; si es un dominio genérico (gmail.com, outlook.com), asegúrate de que solo esté poblado con emails específicos de contactos.

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.