> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/contatos/google-contacts.md). # 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.