> 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/conta-google.md).

# Conta Google

**Conta Google** é a ligação entre o seu usuário do sistema e a sua conta do Google. Uma conexão só, que habilita três coisas:

| Recurso               | O que passa a acontecer                                                    |
| --------------------- | -------------------------------------------------------------------------- |
| **Agenda**            | Seus agendamentos aparecem no seu Google Calendar, com link do Google Meet |
| **Horários ocupados** | Compromissos do seu Google Agenda bloqueiam horários na agenda do sistema  |
| **Entrar com Google** | O botão **Entrar com Google** passa a funcionar para o seu login           |

A sincronização de **contatos** é separada e depende de liberação do admin — veja Google Contacts.

**Caminho:** menu lateral → **Perfil** → aba **Conta Google**

A aba só existe quando a instalação tem o app Google configurado (Configurações Globais → Google).

\[\[FOTO]]

***

### Conectar

1. Abra **Perfil** → aba **Conta Google**.
2. Clique em **Conectar Google**. Abre uma janela do Google.
3. Escolha a conta e autorize os acessos pedidos.
4. A janela se fecha sozinha e a aba passa a mostrar **Conta conectada** com o e-mail.

Se o navegador bloquear janelas pop-up, libere para o endereço do sistema e tente de novo.

\[\[FOTO]]

***

### Desconectar

O botão **Desconectar** desfaz o vínculo e revoga o acesso do sistema na sua conta Google.

A partir daí: agendamentos novos deixam de ir para o Google, os horários do seu calendário deixam de bloquear a agenda e o **Entrar com Google** para de funcionar para você. Os eventos que já foram criados **permanecem** no seu Google Calendar.

Se você tinha o espelho de contatos ligado, os contatos que o sistema tinha criado na sua agenda Google deixam de ser atualizados.

***

### Entrar com Google

Na tela de login, o botão **Entrar com Google** aparece quando a instalação tem o app configurado.

Ele **não cria conta nem descobre usuário por e-mail**. Só funciona para quem já conectou a conta Google no próprio perfil, dentro do sistema. É essa a razão de a primeira conexão ter que ser feita logando normalmente, por senha.

As regras de segurança do login por senha continuam valendo, sem exceção:

| Situação                                    | O que acontece                                          |
| ------------------------------------------- | ------------------------------------------------------- |
| Conta Google não vinculada a nenhum usuário | Recusado, com aviso para conectar primeiro no perfil    |
| Usuário com **Passkey** ativa               | Recusado: esse usuário entra por passkey                |
| Usuário com **2FA (TOTP)**                  | Pede o código do autenticador, igual ao login por senha |
| Usuário inativo                             | Recusado                                                |

\[\[FOTO]]

***

### Regras importantes

* Uma conta Google só pode estar vinculada a **um** usuário do sistema. Se tentar conectar uma conta já usada por outro, a janela avisa e nada é alterado.
* O vínculo é pelo identificador permanente da conta Google, não pelo e-mail — trocar o e-mail da conta não quebra a ligação.
* Suas credenciais do Google **nunca** passam pelo sistema: a autorização acontece na tela do próprio Google.
* Se você remover o acesso do sistema lá na sua conta Google, a conexão aqui aparece como **revogada** e basta reconectar.

***

### Mensagens e erros comuns

| Situação                                                | O que fazer                                     |
| ------------------------------------------------------- | ----------------------------------------------- |
| "Esta conta Google não está vinculada a nenhum usuário" | Entre por senha e conecte a conta no Perfil     |
| "Este usuário exige login por Passkey"                  | Use o botão **Entrar com Passkey**              |
| "O acesso foi revogado na sua conta Google"             | Clique em **Conectar Google** novamente         |
| A janela abriu e fechou sem conectar                    | Verifique o bloqueio de pop-ups e tente de novo |

***

### Dicas de uso

* Conecte a conta **antes** de pedir ao admin a permissão de contatos: assim a autorização já sai completa e você não precisa reconectar.
* Se você usa mais de uma conta Google, confira o e-mail exibido em **Conta conectada** — é dele que virão a agenda e os contatos.
