Pular para o conteúdo principal

Solução de Problemas

Se você estiver enfrentando problemas para conectar à sua conta de e-mail ou sincronizar e-mails, siga esta checklist para investigar e resolver problemas comuns.

1. Verifique o Log de Atividade​

Vá para Utilities → Activity Log dentro do Perfex CRM para visualizar mensagens de erro relacionadas à conexão IMAP ou falhas de sincronização.

2. Ative o Modo Debug​

Para obter saída de erro mais detalhada:

  1. Abra index.php na raiz da sua instalação Perfex CRM
  2. Localize a linha:
define('ENVIRONMENT', 'production');
  1. Altere para:
define('ENVIRONMENT', 'development');
  1. Salve o arquivo e recarregue a página para ver mensagens de erro brutas
aviso

Não esqueça de alterar de volta para production após o teste!

3. Inspecione os Logs de Erro do Hosting​

Se a tela ficar em branco ou nenhum erro aparecer no Perfex:

  1. Acesse seu painel de controle de hospedagem web (por exemplo, cPanel ou Plesk)
  2. Procure por "Error Log", geralmente na seção "Metrics" ou "Logs"
  3. Procure por erros recentes como "memory exhausted", "timeout" ou problemas relacionados a IMAP

4. Verifique Duplamente a Configuração do Cron​

Certifique-se de que seus trabalhos cron estão rodando. Sem eles, o módulo Mailbox não pode sincronizar e-mails.

Consulte a documentação do Perfex CRM ou seu administrador de servidor para solução de problemas do cron.

5. OAuth vs. Autenticação por Senha​

O módulo Mailbox suporta dois métodos de autenticação:

Autenticação OAuth2 (Recomendado)​

Para usuários Gmail e Outlook, OAuth2 é o método recomendado. É mais seguro e não requer armazenamento de senhas.

Problemas Comuns de OAuth:

IssueSolution
"OAuth connection failed"Verifique as credenciais OAuth em Setup → Settings → Mailbox Settings. Verifique a configuração do URI de redirecionamento. Certifique-se de que o app OAuth tem os escopos necessários.
"Token expired"Os tokens OAuth são atualizados automaticamente. Tente desconectar e reconectar. Para Gmail: tokens expiram após 7 dias para apps não verificados.
"OAuth not available"OAuth está disponível apenas para Gmail e Outlook. Use autenticação por senha para outros provedores.

Autenticação por Senha​

Para provedores de e-mail que não suportam OAuth2, use autenticação por senha.

Verifique se seu provedor de e-mail precisa de uma Senha de App

Alguns provedores de e-mail, como Gmail, Yahoo e Outlook, exigem que você use uma Senha de App em vez da senha real da sua conta de e-mail - especialmente se a 2FA (Autenticação em Dois Fatores) estiver ativada.

Exemplo: Usuários Gmail

  1. Acesse https://myaccount.google.com/security
  2. Ative 2-Step Verification, se ainda não estiver ativada
  3. Em "Signing in to Google", localize App Passwords
  4. Gere uma nova senha de app para "Mail"
  5. Use essa senha na Mailbox Config do módulo em vez da sua senha normal do Gmail
aviso

Não usar uma Senha de App quando necessário resultará em erros de autenticação ou tentativas de login bloqueadas.

dica

Para Gmail e Outlook, recomendamos fortemente usar OAuth2 em vez de Senhas de App para melhor segurança e facilidade de uso. Consulte Gmail OAuth Setup ou Outlook OAuth Setup.

6. Configurações por Staff vs. Globais​

O módulo suporta configurações IMAP tanto por staff quanto globais:

  • Configurações por Staff: Cada membro da equipe pode configurar seu próprio servidor IMAP, porta, criptografia e mapeamento de pastas
  • Configurações Globais: Configurações de fallback usadas quando as configurações por staff não estão configuradas

Se os e-mails não estiverem sincronizando:

  1. Verifique sua página Mailbox Config para configurações por staff
  2. Verifique se o servidor IMAP, porta e criptografia estão corretos
  3. Verifique o mapeamento de pastas (especialmente se estiver usando nomes de pastas não padronizados)
  4. Revise o Log de Atividade para mensagens de erro específicas

7. Problemas de Sincronização do Status de Leitura​

Se você habilitou "Sync Read Status to Email Server" mas as alterações não estão refletindo no Gmail/Outlook:

  • E-mails antigos: E-mails importados antes da versão 2.1.7 podem não ter UID armazenada. Apenas novos e-mails sincronizarão o status de leitura.
  • UID ausente: Verifique o Log de Atividade para mensagens "Email ID XXX has no UID stored" (isso é normal para e-mails antigos).
  • OAuth necessário: A sincronização do status de leitura funciona melhor com autenticação OAuth.
  • Sincronização manual: Use o botão Manual Sync em Settings para testar a conexão.

Ainda Precisa de Ajuda?​

Se você estiver travado ou não conseguir resolver um problema, nossa equipe de suporte está aqui para ajudar. Por favor, abra um ticket através do Themesic Support Portal, e teremos prazer em ajudá-lo o mais rápido possível.