Ir al contenido
Todos los artículos
Integraciones

Sincronizar contactos con Google/Outlook

Una vez conectada tu cuenta de Google Workspace o Microsoft 365, importa tus contactos de Google Contacts (People API) o de Outlook (Microsoft Graph) como contactos del CRM, sin duplicar ni sobrescribir lo que ya completaste.

La sincronización de contactos funciona sobre la misma conexión OAuth usada para el correo y el calendario (modelo BYO: la app OAuth es de tu organización). Trae tus contactos del proveedor al CRM como registros de Contacto.

Requisito previo: conceder el acceso a los contactos

Al conectar Google Workspace o Microsoft 365, el CRM ahora también solicita el permiso de contactos (Google: contacts; Microsoft: Contacts.ReadWrite), además de los de correo y calendario. Si ya habías conectado la cuenta ANTES de esta actualización, la conexión no incluye los contactos: abre Configuración → Integraciones, haz clic en "Reconectar" en la tarjeta del proveedor y concede el permiso de contactos. La sección "Sincronización de contactos (2 vías)" pasa a mostrar "Sincronizando".

💡 En la app OAuth de tu organización, asegúrate de que el permiso de contactos esté habilitado: en Google, habilita la People API; en Azure, agrega el permiso delegado Contacts.ReadWrite a Microsoft Graph.

Importar contactos (Proveedor → CRM)

  1. Abre Configuración → Integraciones y localiza la tarjeta del proveedor conectado.
  2. En la sección "Sincronización de contactos (2 vías)", haz clic en "Importar contactos".
  3. El CRM lee tus contactos (hasta 200 por vez) y crea o actualiza un Contacto por cada uno. Informa cuántos leyó, creó y actualizó.

Cómo funcionan la coincidencia y la deduplicación

La clave de coincidencia es el CORREO del contacto: si ya existe un Contacto con ese correo, se actualiza en lugar de duplicarse; si no, se crea uno nuevo. El CRM también guarda el id del contacto en el proveedor (en el propio registro) como refuerzo de deduplicación. Al actualizar un contacto existente, el CRM solo completa los campos que están VACÍOS; nunca sobrescribe el nombre, teléfono o cargo que ya ajustaste en el CRM.

💡 Los contactos sin correo se omiten en la importación, porque el correo es obligatorio en el Contacto y es la clave usada para no duplicar. Registra un correo en el contacto del proveedor para traerlo.

Enviar un contacto del CRM al proveedor (CRM → Proveedor)

También es posible crear un contacto del CRM en tu Google/Outlook (best-effort). Al enviarlo, el CRM guarda el vínculo para no recrear el mismo contacto en envíos futuros. Esta dirección es opcional y solo funciona con el permiso de contactos concedido.

¿Sin conexión? La funcionalidad queda inerte

Si no has conectado una cuenta (o no concediste el ámbito de contactos), no se importa ni se envía nada, sin errores en tu flujo. El botón de importar solo aparece cuando hay una conexión activa con el permiso de contactos.

Cómo probar

  1. En Configuración → Integraciones → tarjeta del proveedor conectado, sección "Sincronización de contactos (2 vías)", haz clic en "Importar contactos".
  2. Revisa el resumen mostrado: cuántos contactos se leyeron, crearon y actualizaron.
  3. Abre la lista de Contactos del CRM y verifica que un contacto conocido de tu Google/Outlook apareció (o se actualizó) sin duplicar.

Solución de problemas

  • No aparece el botón "Importar contactos": no hay conexión con el ámbito de contactos. Haz clic en "Reconectar" en la tarjeta y concede el permiso de contactos (Google: contacts / People API; Microsoft: Contacts.ReadWrite).
  • Algunos contactos no vinieron: los contactos SIN correo se omiten (el correo es obligatorio y es la clave de deduplicación). Registra un correo en el contacto del proveedor e importa de nuevo.
  • Un contacto que ya había ajustado fue "sobrescrito": no debería: la importación solo completa campos VACÍOS y nunca sobrescribe nombre/teléfono/cargo que editaste. Si notas una sobrescritura, repórtala al soporte con el contacto.
  • 403/permiso insuficiente: no se concedió el ámbito de contactos; reconecta y acepta el permiso en la pantalla de consentimiento. En Google, confirma que la People API esté habilitada en la app OAuth.

Abrir este artículo dentro del sistema

¿Lo leíste y quieres verlo funcionando?

La cuenta es gratis y el manual entero está disponible dentro del sistema, con un asistente que responde con este mismo contenido.

Crear cuenta gratis
Sincronizar contactos con Google/Outlook · Sellio