For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Contacts

Finalidade

Google Contacts liga a agenda de contatos do Google de cada atendente à base do sistema, nos dois sentidos:

  • Importar: traz os contatos da agenda Google para a base, com uma conferência completa antes de gravar qualquer coisa.

  • Espelhar: mantém os contatos da carteira do atendente na agenda Google dele, dentro de um grupo chamado DigiCRM.

Caminho: menu lateral → Contatos → botão do Google no cabeçalho

Cada atendente trabalha com a própria conta Google. Ninguém enxerga nem sincroniza a agenda de outro.

[[FOTO]]


Antes de começar: três condições

A tela avisa qual delas está faltando e não deixa avançar enquanto não for resolvida.

Condição
Quem resolve
Onde

A instalação tem um app Google configurado

Master

Configurações Globais → Google

Sua conta Google está conectada

O próprio usuário

Conta Google

Você tem permissão de sincronizar

Admin / Super

Cadastro do usuário → Sincronização de contatos (Google)

A permissão tem três modos:

Modo
O que libera

Desligado (padrão)

Nada sincroniza, mesmo com a conta conectada

Só importar

Traz contatos do Google para a base

Importar e exportar

Também espelha a carteira na agenda Google

Se você conectou a conta antes de o admin liberar a permissão, a tela pede para desconectar e conectar de novo: a autorização de contatos só é pedida ao Google para quem já tem a permissão ligada.

[[FOTO]]


Aba Importar

1. Ler a agenda

Clique em Ler minha agenda Google. Nada é gravado nessa etapa — o sistema apenas lê seus contatos e compara com a base, montando a conferência.

Agendas grandes levam alguns instantes.

2. Conferir, por grupo

Os contatos são separados em abas, e a ação de cada linha é a da aba em que ela está:

Aba
O que significa

Novos

Não existe na base — será criado

A completar

Já existe (mesmo telefone ou e-mail) — só os campos vazios são preenchidos

A mesclar

O Google mostra que dois registros da base são a mesma pessoa — serão unidos num só

Ignorados

Sem telefone e sem e-mail: não há como importar

Em cada aba você marca ou desmarca as linhas (há um Selecionar todos). Quem tem mais de um telefone permite escolher qual é o principal — os demais entram como campo personalizado "Telefone adicional (Google)".

Na aba A mesclar cada linha ainda oferece a escolha entre Mesclar os dois e Completar existente.

[[FOTO]]

3. Escolher o destino

Acima da lista ficam três opções que valem para todo o lote:

Opção
Para que serve

Carteira

Define de quem serão os contatos importados. Vem preenchida com a sua; escolha outro atendente ou Não atribuir carteira

Etiquetas

Marca todos os contatos do lote — útil para achar depois quem veio da importação

Aplicar também aos que já existem

Desmarcado por padrão

A última merece atenção: desmarcada, carteira e etiquetas valem apenas para os contatos criados agora. Contatos que já existiam mantêm o dono e as etiquetas atuais. Se você marcar, a importação passa a mexer também neles — inclusive em contatos que hoje pertencem a outro atendente.

4. Importar

O rodapé mostra quantos contatos estão marcados e conclui a importação. Ao final, o resumo informa quantos foram criados, completados, mesclados e ignorados, e lista os erros quando houver.

[[FOTO]]


Aba Pendências

Serve para o caminho inverso: um contato do espelho foi editado direto na agenda Google.

Quando isso acontece, o sistema não sobrescreve a edição nem a aceita sozinho. Ele abre uma pendência, mostrando lado a lado o que está na base e o que está no Google, campo a campo:

  • Aprovar selecionados — aplica à base só os campos que você marcar. Telefone e e-mail passam pelas mesmas validações de unicidade do sistema: se já pertencerem a outro contato, aquele campo é ignorado e a tela avisa.

  • Rejeitar — descarta a alteração. Na próxima sincronização, o dado oficial da base volta a valer na agenda Google.

Enquanto a pendência estiver aberta, aquele contato não é sobrescrito no Google.

Admin e super podem ligar Todas do tenant para revisar pendências de todos os atendentes.

[[FOTO]]


Aba Status (admin)

Visão geral por usuário: permissão atual, conta Google conectada, se falta a autorização de contatos, quantos contatos foram importados, quantos estão espelhados e quantas pendências existem. A permissão também pode ser alterada aqui, sem abrir o cadastro do usuário.

[[FOTO]]


Como funciona o espelho (modo "Importar e exportar")

  • Os contatos da carteira do atendente são criados na agenda Google dele, dentro do grupo DigiCRM.

  • A sincronização acontece a cada 10 minutos, ou na hora, pelo botão Sincronizar carteira agora. Não é instantânea: editar um contato aqui não o atualiza no Google no mesmo segundo.

  • Contato apagado na agenda Google é recriado — o espelho reflete a carteira.

  • Contato editado na agenda Google vira pendência de revisão (acima).

  • Contato que sai da carteira, ou é apagado no sistema, é removido da agenda Google.

  • Ao desligar a permissão do usuário, o espelho dele é limpo da agenda Google.

O que o sistema apaga no Google é somente o que ele mesmo criou. Contatos pessoais e os que vieram de importação nunca são removidos.


Regras importantes

  • Cada atendente sincroniza apenas a própria conta e a própria carteira.

  • A importação nunca sobrescreve dado preenchido: só completa campos vazios. Alterar dado existente só pelo fluxo de pendências, com aprovação.

  • Contatos sem telefone e sem e-mail são ignorados — a base não teria como identificá-los.

  • O limite de contatos do seu plano é respeitado: se o lote ultrapassar, a tela avisa antes e os excedentes não são criados.

  • Mesclar é irreversível: os dois registros viram um, preservando o histórico.


Mensagens e erros comuns

Situação
O que fazer

"A sincronização não está habilitada para o seu usuário"

Peça ao admin para liberar no seu cadastro

"Conecte sua conta Google no seu perfil"

Vá em Perfil → Conta Google

"Sua conta foi conectada antes da permissão de contatos"

Desconecte e conecte de novo

Importação com erros na lista final

Cada linha traz o motivo (limite do plano, telefone já usado, etc.)

Alguns campos não puderam ser aplicados na aprovação

O telefone ou e-mail já pertence a outro contato


Dicas de uso

  • Use uma etiqueta na importação (ex.: "Agenda Google") para conseguir filtrar depois exatamente o que entrou naquele lote.

  • Deixe Aplicar também aos que já existem desmarcado, a não ser que você queira mesmo assumir a carteira de contatos que já estavam na base.

  • Antes de uma importação grande, confira o limite de contatos do plano no aviso da própria tela.

  • Passou a mexer nos contatos direto pelo celular? Espere o ciclo de 10 minutos ou use Sincronizar carteira agora antes de conferir o resultado.

Atualizado