Conexão com E-mail (IMAP/POP/SMTP): erros comuns e como resolver

O Fiscal.io Monitor pode se conectar à sua conta de e-mail para automatizar a captura/importação de documentos (XML/PDF) enviados por fornecedores e sistemas. Quando há falha de conexão, geralmente é por credenciais incorretas, bloqueios do provedor (Gmail/Outlook), exigência de TLS/SSL, autenticação moderna (OAuth) ou regras de firewall/proxy.

1) Antes de começar (checklist rápido)

• Confirme o provedor: Gmail / Microsoft (Outlook/Office 365/Exchange Online) / servidor próprio.
• Você tem acesso ao e-mail via web? Se não consegue logar no webmail, o problema não é do Monitor.
• Você tem 2FA/MFA ativo? Se sim, normalmente você não usa a senha “normal” no Monitor.
• Você usa “E-mail corporativo” com políticas? Pode exigir liberação de IMAP/SMTP pelo administrador.
• Você está atrás de proxy/firewall? Pode bloquear portas e impedir handshake TLS.

2) Protocolos: o que precisa funcionar

Dependendo da configuração, o Monitor pode usar:

• IMAP: para ler e-mails (mais comum).
• POP3: alternativa para leitura (menos comum).
• SMTP: para enviar e-mails (se o seu cenário exigir envio).

Em quase todos os provedores modernos, você deve usar TLS/SSL. Erros de TLS/SSL geralmente indicam porta incorreta, inspeção de SSL por proxy, certificado interceptado, ou política do servidor.

3) Erros comuns e soluções

3.1) Usuário/senha inválidos

Sintomas: mensagem de autenticação falhou, login inválido, “Invalid credentials”, “AUTHENTICATIONFAILED”.

O que fazer:

• Revise e-mail e senha (sem espaços no começo/fim).
• Se tiver 2FA/MFA, use senha de aplicativo (quando disponível) ou configure OAuth (quando exigido).
• Confirme se a conta não está bloqueada ou exigindo confirmação de segurança no provedor.

3.2) IMAP/POP/SMTP desabilitado na conta

Sintomas: autentica, mas não lista pastas; ou retorna erro de “protocol disabled”.

O que fazer:

• No painel do provedor (ou com o administrador), habilite o protocolo necessário (IMAP recomendado).
• Se for e-mail corporativo, solicite ao TI liberar o uso do protocolo para sua conta.

3.3) Porta incorreta / TLS/SSL incorreto

Sintomas: “Could not create SSL/TLS secure channel”, “Handshake failed”, “EOF occurred”, “connection reset”.

O que fazer:

• Confira se está usando a porta correta para IMAP/SMTP com TLS.
• Evite combinar “porta SSL” com opção “sem SSL” (ou vice-versa).
• Se estiver em rede corporativa com proxy com inspeção SSL, peça ao TI para liberar o domínio/porta sem interceptação ou instalar cadeia correta.

3.4) Proxy/Firewall bloqueando a conexão

Sintomas: timeout, “No route”, “Connection refused”, conexão cai antes de autenticar.

O que fazer:

• Teste em outra rede (ex.: hotspot) para confirmar se é bloqueio local.
• Peça ao TI liberar as portas de saída necessárias para o provedor.
• Se sua empresa usa proxy, configure o proxy no Monitor (quando aplicável) e confirme credenciais do proxy.

3.5) Erros específicos do Gmail (Google)

Causas mais comuns:

• Conta com verificação em duas etapas (2FA) ativa sem senha de app/OAuth.
• Políticas de segurança do Google bloqueando login “menos seguro” (depende do tipo de conta).

Como resolver:

• Se disponível, crie uma senha de aplicativo para IMAP/SMTP e use essa senha no Monitor.
• Se sua conta exigir OAuth, configure a integração via OAuth conforme artigo abaixo.
• Garanta que IMAP esteja habilitado nas configurações do Gmail (quando aplicável).

3.6) Erros específicos do Outlook/Office 365 (Microsoft)

Causas mais comuns:

• MFA/Conditional Access exige autenticação moderna (OAuth).
• O administrador desabilitou IMAP/SMTP para a conta/tenant.

Como resolver:

• Se o tenant exigir OAuth, configure conforme artigo de OAuth abaixo.
• Solicite ao administrador habilitar o protocolo necessário (principalmente IMAP) para sua conta, se essa for a estratégia escolhida.

3.7) Certificado TLS inválido / hostname não confere

Sintomas: “certificate verify failed”, “name mismatch”, “unknown CA”.

O que fazer:

• Confirme se o servidor configurado é o host correto do provedor (não use IP se o certificado é por domínio).
• Se usar e-mail próprio, valide o certificado do servidor (cadeia completa e SNI).
• Se houver proxy com inspeção SSL, o certificado pode ser “substituído” pelo proxy.

4) Pastas, filtros e regras (quando conecta mas não “acha” os e-mails)

Sintomas: conecta sem erro, mas não encontra mensagens/documentos.

• Confirme a pasta monitorada (INBOX vs. outras pastas).
• Verifique regras/encaminhamentos: o e-mail pode estar indo para “Spam”, “Lixo eletrônico” ou uma pasta automática.
• Garanta que os remetentes/dominios corretos estão chegando e que os anexos não estão sendo removidos pelo provedor.

5) Boas práticas recomendadas

• Conta dedicada: use um e-mail exclusivo para integrações (melhor auditoria e menor risco).
• Senha de app/OAuth: prefira autenticação moderna quando disponível.
• Evite compartilhamento: não reutilize a senha do usuário principal em integrações.
• Rotação: se usar senha de app, registre o local e planeje rotação periódica.

6) Como diagnosticar para o suporte (o que enviar)

Para agilizar a análise, envie:

• Provedor (Gmail / Outlook / outro)
• Protocolo (IMAP/POP/SMTP)
• Servidor/porta configurados
• Se usa TLS/SSL e qual modo
• Se tem MFA e se está usando senha de app/OAuth
• Mensagem de erro completa exibida na tela
• Data/hora aproximada do teste

Artigos relacionados

• Importando documentos de saída por e-mail automaticamente (configuração do recurso): ver artigo
  (Se este link não corresponder ao seu cenário de e-mail, substitua pelo artigo correto de “importação por e-mail” do seu KB.)
• OAuth / autenticação moderna para e-mail: procure por “OAuth” na Central de Ajuda
• Buscar na SEFAZ (caso a dúvida seja sobre busca e não e-mail): ver artigo