Configuração de Recebimento de Email (GMAIL)

📘 Manual de Configuração de Recebimento de E-mails via IMAP com OAuth (Diponível Versão 818)
🧭 Acesso à Tela
Para configurar o recebimento de e-mails:

Acesse a Tela pelo Menu Configurações -> Configurações Adicionais

Na aba de Email

Acesse o módulo de Configuração de Recebimento (Monitoramento da Caixa de Entrada).

Essa tela permite cadastrar perfis de e-mail que serão monitorados automaticamente via protocolo IMAP.

🛠️ Etapas de Configuração
1. Preenchimento dos Dados de Conexão

Na área de configuração à esquerda da tela:

Filial: Selecione a Filial.

Servidor IMAP: Informe o servidor IMAP (ex: imap.gmail.com).

Porta: Informe a porta de conexão (ex: 993 para conexões SSL).

Servidor utiliza SSL: Marque essa opção se o servidor exigir conexão segura. (sim para o Gmail)

Endereço de e-mail: Informe o e-mail que será monitorado.

Senha: pode informar qualquer valor caso for utilizar OAuth.

Após preencher os campos, clique em Adicionar.

2. Visualização na Grid

Após adicionar, o perfil será exibido na grid à direita, com os seguintes dados:

Nome do Filial

Servidor IMAP

Porta

3. Autenticação OAuth

Para ativar a autenticação segura via OAuth:

Clique no botão com o ícone de cadeado com chave ao lado do perfil recém-adicionado.

O sistema abrirá automaticamente o navegador padrão com a página de autenticação do provedor de e-mail (ex: Google).

O usuário deverá:

Fazer login com o e-mail informado.

Aceitar as permissões solicitadas pelo sistema.

Confirmar o acesso à caixa de entrada.

Após a autorização, o sistema armazenará o token de acesso e iniciará a sincronização automática dos e-mails na próxima inicialização dele.

🔄 Sincronização
Com a autenticação concluída, será necessário reabrir o sistema para que seja criado uma rotina de verificação para iniciar a sincronização do monitoramento da caixa de entrada.
O sistema passará a verificar novos e-mails periodicamente, conforme a configuração interna de sincronização.

✅ Recomendações

Certifique-se de que o e-mail utilizado esteja habilitado para acesso via IMAP.

Para contas do Gmail, é necessário que o domínio esteja autorizado para uso de OAuth com o sistema. Caso utilize GSuite, o administrador da conta normalmente precisa habilitar, para demais, segundo Gmail, já esta liberado automaticamente.

Caso a autenticação falhe, verifique se o navegador bloqueou pop-ups ou se o e-mail exige verificação em dois fatores.