Sincronizar contatos com Google/Outlook
Depois de conectar sua conta do Google Workspace ou Microsoft 365, importe seus contatos do Google Contacts (People API) ou do Outlook (Microsoft Graph) como contatos do CRM, sem duplicar e sem sobrescrever o que você já preencheu.
A sincronização de contatos funciona sobre a mesma conexão OAuth usada para o e-mail e o calendário (modelo BYO: o app OAuth é da sua organização). Ela traz seus contatos do provedor para o CRM como registros de Contato.
Pré-requisito: conceder o acesso aos contatos
Ao conectar o Google Workspace ou o Microsoft 365, o CRM agora pede também a permissão de contatos (Google: contacts; Microsoft: Contacts.ReadWrite), além das de e-mail e calendário. Se você já tinha conectado a conta ANTES desta atualização, a conexão não inclui os contatos: abra Configurações → Integrações, clique em "Reconectar" no cartão do provedor e conceda a permissão de contatos. A seção "Sincronização de contatos (2 vias)" passa a mostrar "Sincronizando".
Importar contatos (Provedor → CRM)
- Abra Configurações → Integrações e localize o cartão do provedor conectado.
- Na seção "Sincronização de contatos (2 vias)", clique em "Importar contatos".
- O CRM lê seus contatos (até 200 por vez) e cria ou atualiza um Contato para cada um. Ele informa quantos leu, criou e atualizou.
Como o casamento e a deduplicação funcionam
A chave de casamento é o E-MAIL do contato: se já existe um Contato com aquele e-mail, ele é atualizado em vez de duplicado; senão, um novo é criado. O CRM também guarda o id do contato no provedor (no próprio registro) como reforço de deduplicação. Ao atualizar um contato existente, o CRM só preenche os campos que estão VAZIOS; nunca sobrescreve o nome, telefone ou cargo que você já ajustou no CRM.
Enviar um contato do CRM ao provedor (CRM → Provedor)
Também é possível criar um contato do CRM no seu Google/Outlook (best-effort). Quando enviado, o CRM guarda o vínculo para não recriar o mesmo contato em envios futuros. Essa direção é opcional e só funciona com a permissão de contatos concedida.
Sem conexão? A funcionalidade fica inerte
Se você não conectou uma conta (ou não concedeu o escopo de contatos), nada é importado nem enviado, sem erros no seu fluxo. O botão de importar só aparece quando há uma conexão ativa com a permissão de contatos.
Como testar
- Em Configurações → Integrações → cartão do provedor conectado, seção "Sincronização de contatos (2 vias)", clique em "Importar contatos".
- Confira o resumo exibido: quantos contatos foram lidos, criados e atualizados.
- Abra a lista de Contatos do CRM e verifique se um contato conhecido do seu Google/Outlook apareceu (ou foi atualizado) sem duplicar.
Solução de problemas
- Não aparece o botão "Importar contatos": não há conexão com o escopo de contatos. Clique em "Reconectar" no cartão e conceda a permissão de contatos (Google: contacts / People API; Microsoft: Contacts.ReadWrite).
- Alguns contatos não vieram: contatos SEM e-mail são ignorados (o e-mail é obrigatório e é a chave de deduplicação). Cadastre um e-mail no contato do provedor e importe de novo.
- Um contato que eu já ajustei foi "sobrescrito": não deveria, pois a importação só preenche campos VAZIOS e nunca sobrescreve nome/telefone/cargo que você editou. Se notar sobrescrita, reporte ao suporte com o contato.
- 403/permissão insuficiente: o escopo de contatos não foi concedido; reconecte e aceite a permissão na tela de consentimento. No Google, confirme que a People API está ativada no app OAuth.