496 Servidor Email
Neste recurso são configurados os servidores de email que serão utilizados pelo ERP em diversas tarefas, como por exemplo no envio da NFe ao cliente. Terá de ser cadastro um servidor para cada Remetente de email desejado.
Lembre-se de alterar os dados neste recurso, toda vez que for alterado alguma condição/configuração do servidor de email em si, como por exemplo a senha.
Contate seu provedor de email para que o mesmo lhe informe todas as informações necessárias.
Fluxo Principal
- Informe a descrição do servidor de email, como por exemplo "Faturamento"
- Informe o endereço do servidor de saída do email, como por exemplo: smtp.touchcomp.com.br
- Informe o email, como por exemplo faturamento@touchcomp.com.br
- Informe a porta do email. Atualmente somente duas portas são suportadas: 587 e 465. Em servidores locais ou antigos, ainda é possível usar a porta 25.
- Informe a senha do email
- Informe email de cópia. Será enviada uma cópia toda vez que um email for enviado a partir deste servidor. Nota: Alguns recursos do ERP ainda não suportam esta opção.
- Marque Compactar Anexos se deseja que os anexos sejam compactados em um arquivo .zip. Diminui o tráfico de banda utilizado, mas alguns destinatários podem ignorar emails com anexos zipados.
Ao salvar, será solicitado um email de destinatário para teste da configuração. Caso ocorra algum erro, contate seu TI para verificar o log e alterar as configurações. O ERP só deixa salvar, caso os dados estejam corretos.
Problemas e Soluções
Configurações
O não envio de um email, pode ser ocasionado por diversas falhas, desta forma deve ser verificado:
- Confirme o login e senha. Se tiver dúvidas quanto a senha, experimente digitar antes em um bloco de notas, copiar e colar.
- Confirme a porta informada. Experimente alternar entre as portas e tente salvar novamente para realizar uma nova tentativa de envio e teste.
- Experimente marcar a opção "Não Autenticar Email"
Problema de criptografia e Protocolo
Caso ocorra o erro:
javax.net.ssl.SSLHandshakeException: No appropriate protocol (protocol is disabled or cipher suites are inappropriate
você deve informar duas propriedades no servidor de email:
properties.put("mail.smtp.starttls.required", "true");
properties.put("mail.smtp.ssl.protocols", "TLSv1.2");
Servidor de e-mail Gmail
- É necessário atentar-se ao status IMAP nas configurações do e-mail. Caso esteja desativa, gentileza ativar para funcionar a configuração no ERP.
- Além disso, acesse o site [1] para habilitar o uso por aplicação de terceiros do e-mail.
- Para realizar a configuração do e-mail em programas de terceiros, deverá gerar uma senha de APP pelas configurações do provedor Gmail. Segue os passos abaixo para gerar a senha.
- Deverá entrar no e-mail pelo navegador;
- Clicar na opção Gerenciar Sua Conta do Google;
- Clicar em Segurança;
- Caso não tenha ativado a opção de Verificação em duas etapas, deverá realizar todo o processo para ativar e assim liberar a opção abaixo.
- Clicar em Senhas de app (deverá informar a senha novamente por segurança do provedor);
- Na primeira opção deverá selecionar o "E-mail" e na segunda opção "Computador Windows", posteriormente clicar na opção GERAR;
- Com todas as opções realizadas acima irá aparecer uma tela com a Senha de app para Computador Windows que será usada para informar no campo senha do sistema.
Servidor de e-mail Microsoft
Servidores de email Microsoft utilizam autenticação através de uma propriedade chamada "Secret Id.". O valor dessa propriedade é gerada pelo usuário através do site Microsoft Azure e mapeada no Mentor. Entretanto, essa autenticação tem prazo de expiração e o usuário deve gerar de tempos em tempos um novo valor e mapear novamente pelo Mentor. Abaixo, está um tutorial de como realizar essa operação.
Este tutorial detalhado visa orientar o usuário na criação de uma nova chave de acesso, ou Secret Id., para um registro de aplicativo (App Registration) no Microsoft Azure (agora parte do Microsoft Entra ID). A necessidade desse procedimento surge frequentemente quando credenciais de autenticação existentes expiram, resultando em erros como:
"The provided client secret keys for app 'a1bb111b-58g9-4z29-aa9f-05xyz7a69236' are expired. Visit the Azure portal to create new keys for your app: https://aka.ms/NewClientSecret".
A criação de um novo Client Secret é a solução direta para restaurar a funcionalidade de autenticação da sua aplicação.
Pré-requisitos
Para seguir este guia, você deve ter:
- Uma conta ativa no Azure com permissões para gerenciar Registros de Aplicativos (no mínimo, a função de Desenvolvedor de Aplicativos).
- Acesso ao Portal do Azure.
- O Nome ou o ID do Aplicativo (Client ID) que está com o segredo expirado.=
Passos Detalhados para a Criação do Client Secret
Siga os passos abaixo para gerar a nova credencial de segurança.
Passo 1: Acessar o Microsoft Entra ID no Portal do Azure
- Navegue até o Portal do Azure e realize o login.
- Na barra de pesquisa superior, digite "Microsoft Entra ID" (antigo Azure Active Directory) e selecione o serviço correspondente.
Passo 2: Localizar o Registro de Aplicativo
- No menu lateral do Microsoft Entra ID, selecione a opção "App registrations" (Registros de aplicativo).
- Na lista de aplicativos, localize e clique no nome da aplicação que está gerando o erro de expiração.
- Dica: Se você tiver o ID do aplicativo (Client ID) exibida na mensagem de erro (exemplo:
a1bb111b-58g9-4z29-aa9f-05xyz7a69236), você pode usá-lo para pesquisar diretamente na lista de Registros de Aplicativo.
- Dentro da página de visão geral do seu aplicativo, no menu lateral esquerdo, selecione "Certificates & secrets" (Certificados e segredos).
- Na seção principal, clique na aba "Client secrets" (Segredos do cliente).
Passo 4: Gerar um Novo Client Secret
- Clique no botão "+ New client secret" (Novo segredo do cliente). Uma janela de configuração será aberta.
| Campo | Descrição | Recomendações |
|---|---|---|
| Description (Descrição) | Um nome para identificar o segredo. | Utilize um nome que indique a finalidade e a data de criação (ex: "Chave_Principal_2025"). |
| Expires (Expira) | O período de validade da chave. | Obrigatório: O tempo máximo permitido é de 24 meses. A Microsoft recomenda um valor de menos de 12 meses para maior segurança. |
- Após preencher a Description e selecionar o período de Expires, clique no botão "Add" (Adicionar).
Passo 5: Copiar e Salvar o Valor do Segredo
ESTE É O PASSO MAIS CRÍTICO.
Após clicar em "Add", o novo segredo será exibido na lista. Você verá duas colunas importantes: Secret ID e Value.
- Copie o
Value(Valor) do segredo imediatamente.- Este valor é a chave de acesso real e nunca mais será exibido após você sair desta página.
- Se você perder este valor, terá que criar um novo segredo.
- Salve o
Valueem um local seguro, como um cofre de senhas (ex: Azure Key Vault) ou um gerenciador de segredos.
| Campo | O que copiar | Observação |
|---|---|---|
| Secret ID | Não é a chave. É um identificador. | Não precisa ser copiado, mas é útil para referência. |
| Value | A CHAVE DE ACESSO. | COPIE IMEDIATAMENTE. Este campo ficará oculto após a navegação. |
Passo 6: Atualizar a Aplicação
Com o novo Value copiado, o passo final é atualizar a configuração do seu servidor de email:
- Acesse o recurso 496 - Servidor E-mail e pesquisa a configuração do servidor que ocorreu o erro
- Edite o registro
- Na tabela de configurações exibida na parte inferior da tela, procure a configuração secret_id e, na coluna Valor da propriedade, cole a chave gerada no processo anterior no site Microsoft Azure. Caso não encontre esse propriedade na tabela, clique no Botão Adicionar e cadastre com os valores citados anteriormente.
- Salve o registro de servidor.
Após a atualização, a aplicação deverá se autenticar com sucesso no Microsoft Entra ID, resolvendo o erro de expiração.
Depure o problema
Encontrar o problema de envio de emails é trabalhoso e pode ser causado por diversos itens. Portanto siga e elimine cada item abaixo até encontrar o problema:
| Item | Ação |
|---|---|
| Teste o envio de email | Teste no próprio recurso 496, ao salvar, o envio de email. Coloque mais de um email se possível, de domínios diferentes (gmail, yahoo, etc). Caso chegue em um e não em outro, verifique a caixa de spam. Caso ainda não tenha chegado, consulte o provedor do email do destinatário e verifique por bloqueios de recepção. |
| Verifique a Caixa de SPAM | Verifique se o email chegou na caixa de SPAM. |
| Verifique a existência de regras | Verifique senão existe regras que possam descartar o email. Estas regras podem ser configuradas tanto pelo TI da empresa como pelo próprio provedor |
| Verifique a existência de Filtros | Alguns usuários criam várias pastas para separar os emails conforme o remetente. Verifique se o email não está em uma destas pastas. |
| Antivírus | Desative o antivirus para testes. Caso o email seja enviado, consulte o TI para verificar o antivirus. |
| Firewall | Desative o Firewall para testes. Caso o email seja enviado, consulte o TI para verificar o antivirus. |
| Proxy | Desative o Proxy para testes. Caso o email seja enviado, consulte o TI para verificar o proxy. |
| Altere o email/Provedor | Coloque o email de outro provedor de email e teste, para verificar se o problema não é no provedor, ou alguma regra do mesmo. Se você usa o Gmail, altere para um email do Yahoo por exemplo. |
| Altere o Provedor de Internet | Faça um teste com outro provedor de internet, por exemplo uma internet 4G. |
| Teste fora da estrutura da empresa | Faça um teste fora da rede da empresa, para verificar se algum aparelho, por exemplo roteador, está causando o problema. |
Confirmação de Recebimento
Muitas das vezes é necessário ter certeza que o email foi enviado. Deve se observar que o enviado não significa que foi entregue, pois o email do destinatário pode estar com problemas, como por exemplo:
- Servidor indisponível
- Caixa de entrada cheia, sem espaço
- Email pode ter sido descontinuado
- Entre outros.
Normalmente, quando um destes problemas ocorre, você recebe um email com codificações de erro, detalhes técnicos na sua caixa de entrada. Observe a seção "Códigos de Erros e Causas para identificar a causa. Consulte seu técnico de TI sobre.
Confirmação: Email, Caixa de emails de Enviados
Você pode habilitar para que cada email enviado seja "copiado" para a caixa de saída de seu email, da mesma forma que o programa gerenciador de emails(por exemplo Outlook, Thunderbird, etc) o faz.
Esta opção, a partir da versão 202204 é realiza automaticamente desde que você informe o servidor de emails de Saída, normalmente o IMAP de seu provedor. Logo, para habilitar esta opção informe o servidor de email IMAP de seu provedor no campo servidor IMAP(Consulte a subseção de exemplos).
Servidor imap: imap.seudominio.com.br
A depender do seu provedor de email, se ele segue as configurações padrões deste serviço, a cópia para a pasta de emails enviados é feita automaticamente. Caso contrário, você deverá confirmar, principalmente o nome da pasta onde é salvo os emails enviados, junto ao seu técnico de TI ou principalmente seu provedor de email. Os valores padrões utilizados são:
- Protocolo: imap
- Pasta Email Enviados: Sent
Para configurar estes detalhes, utilize a tabela de Propriedades Adicionais, informando:
- store.outbox.type e informe o valor conforme seu provedor de email
- sent.folder.name e informe o nome da pasta conforme seu provedor de email
Atenção: Alguns programas gerenciadores de email não mostram, automaticamente, na pasta de Emails Enviados(Sent/Outbox) os emails enviados por outros programas, somente os enviados por eles mesmos. Logo, consulte no Gerenciador online do seu email, para confirmar os emails enviados.
Na medida que forem identificados estas variações, iremos também documentá-las aqui para acelerar o processo.
Kinghost
- Servidor imap: imap.seudominio.com.br
- Pasta Email Enviados: Não infomar
- Pasta Email Enviados: não informar, identificada automaticamente
Confirmação: Email de Cópia
Você pode definir, no servidor de email, no campo "Email de Cópia", onde ao ser informado um email válido, você receberá uma cópia de cada email enviado, independente do lugar do sistema(Este recurso está disponível em todos os principais lugares de envio de email, caso utilize um que ainda não suporte esta opção, abra um atendimento junto ao suporte para adicionar esta funcionalidade). Logo, estes emails aparecerão na sua caixa de entrada do seu email.
Códigos de erros e Causas
| Código | Descrição | Texto do cabeçalho |
|---|---|---|
| 101 | Servidor Indisponível | Verifique o endereço do servidor, se o mesmo não foi alterado pelo provedor de email, etc. Consulte seu provedor de email para confirmar as configurações. |
| 111 | Não foi possível estabelecer uma conexão SMTP | Esse erro normalmente se refere a um problema de conexão com o servidor SMTP remoto, dependendo de firewalls ou domínios com erros ortográficos. Verifique novamente todas as configurações e, no caso, pergunte ao seu provedor. |
| 211 | Mensagem de status, ou informações adicionais do servidor | Verifique as mensagens adicionais retornadas, para poder solucionar o problema. |
| 214 | Resposta de uma solicitação de ajuda | Verifique as mensagens retornadas. |
| 220 | Servidor está pronto | Mensagem de sucesso, de conexão bem sucedida. |
| 221 | Mensagem de finalização | As mensagens foram enviadas, e a conexão está sendo encerrada. |
| 252 | Problema relativo a verificação do usuário | A conta de e-mail do destinatário é válida, mas não verificável. Normalmente o servidor retransmite a mensagem para outro que poderá verificar. |
| 420 | Timeout de conexão | Seu e-mail foi bloqueado pelo firewall do destinatário ou há um problema de hardware. Verifique com seu provedor. |
| 421 | Servidor/Serviço indisponível | Tente novamente mais tarde, ou entre em contato com o seu provedor. |
| 422 | Destinatário está com armazenamento esgotado | Contate o usuário através de outro canal para alertá-lo e pedir para criar algum espaço livre em sua caixa postal. |
| 431 | Armazenamento Esgotado/banda esgotada | Esse erro pode depender de muitas mensagens enviadas para um domínio específico. Você deve tentar novamente enviar conjuntos menores de e-mails em vez de um grande e-mail. |
| 432 | Mensagem lateral típica: "A fila de correio de entrada do Exchange Server do destinatário foi interrompida" | É um código de erro SMTP do Microsoft Exchange Server. Você deve contatá-lo para obter mais informações: geralmente é devido a um problema de conexão. |
| 441 | O servidor do destinatário não está respondendo. | Há um problema com o servidor de entrada do usuário: o seu tentará contatá-lo novamente. |
| 442 | A conexão foi interrompida durante a transmissão. | Um problema típico de conexão de rede, provavelmente devido ao seu roteador: verifique-o imediatamente. |
| 446 | A contagem máxima de saltos foi excedida para a mensagem: ocorreu um loop interno. | Peça ao seu provedor SMTP para verificar o que aconteceu. |
| 447 | Sua mensagem de saída expirou devido a problemas relacionados ao servidor de entrada. | Isso geralmente acontece quando você excede o limite de número de destinatários de uma mensagem do seu servidor. Tente enviar novamente segmentando a lista em diferentes partes. |
| 449 | Erro de roteamento | Como o erro 432, está relacionado apenas ao Microsoft Exchange. Contate seu provedor. |
| 450 | “Ação solicitada não executada – a caixa de correio do usuário não está disponível”. A caixa de correio foi corrompida ou colocada em um servidor offline ou seu e-mail não foi aceito por problemas de IP ou lista negra. | O servidor tentará enviar a mensagem novamente após algum tempo. De qualquer forma, verifique se está funcionando em um endereço IP confiável. Contate seu provedor. |
| 451 | “Ação solicitada abortada – Erro local no processamento”. O servidor do seu ISP ou o servidor que recebeu uma primeira retransmissão do seu encontrou um problema de conexão. | Normalmente é um erro transitório devido a uma sobrecarga de mensagens, mas pode se referir também a uma rejeição devido a um filtro antispam remoto. Se continuar repetindo, peça ao seu provedor SMTP para verificar a situação. (Se você estiver enviando um grande e-mail em massa com um gratuito, isso pode ser um problema comum). |
| 452 | Muitos e-mails enviados ou muitos destinatários: mais em geral, um limite de armazenamento do servidor foi excedido. | Novamente, a causa típica é uma sobrecarga de mensagens. Normalmente, a próxima tentativa será bem-sucedida: em caso de problemas em seu servidor, ele virá com uma mensagem lateral como “Sem memória”. |
| 471 | Um erro do seu servidor de correio, muitas vezes devido a um problema do filtro anti-spam local. | Entre em contato com seu provedor de serviços SMTP para corrigir a situação. |
| 500 | Um erro de sintaxe: o servidor não conseguiu reconhecer o comando. | Pode ser causado por uma má interação do servidor com seu firewall ou antivírus. Leia atentamente suas instruções para resolvê-lo. |
| 501 | Outro erro de sintaxe, não no comando, mas em seus parâmetros ou argumentos. | Na maioria das vezes é devido a um endereço de e-mail inválido, mas também pode estar associado a problemas de conexão (e novamente, um problema relacionado às configurações do antivírus). |
| 502 | O comando não é implementado. | O comando ainda não foi ativado em seu próprio servidor. Entre em contato com seu provedor para saber mais sobre isso. |
| 503 | O servidor encontrou uma sequência incorreta de comandos ou requer uma autenticação. | No caso de “sequência ruim”, o servidor executou seus comandos na ordem errada, geralmente devido a uma conexão interrompida. Se for necessária uma autenticação, você deve inserir seu nome de usuário e senha. |
| 504 | Um parâmetro de comando não está implementado. | Como o erro 501, é um problema de sintaxe; você deve perguntar ao seu provedor. |
| 510/511 | Endereço de e-mail incorreto. | Um dos endereços na sua linha TO, CC ou BBC não existe. Verifique novamente as contas dos seus destinatários e corrija qualquer possível erro ortográfico. |
| 512 | Um erro de DNS: o servidor host para o nome de domínio do destinatário não pode ser encontrado. | Verifique novamente os endereços de todos os seus destinatários: provavelmente haverá um erro em um nome de domínio (como mail@domain.coom em vez de mail@domain.com). |
| 513 | “O tipo de endereço está incorreto”: outro problema relacionado ao erro de ortografia do endereço. Em alguns casos, no entanto, está relacionado a um problema de autenticação. | Verifique novamente os endereços dos seus destinatários e corrija qualquer erro. Se tudo estiver ok e o erro persistir, então é causado por um problema de configuração (simplesmente, o servidor precisa de uma autenticação). |
| 523 | O tamanho total da sua correspondência excede os limites do servidor destinatário. | Reenvie sua mensagem dividindo a lista em subconjuntos menores. |
| 530 | Normalmente, um problema de autenticação. Mas às vezes é sobre o servidor do destinatário que coloca o seu na lista negra ou um endereço de e-mail inválido. |
Defina suas configurações fornecendo uma autenticação de nome de usuário + senha. Se o erro persistir, verifique os endereços de todos os seus destinatários e se você foi colocado na lista negra. |
| 541 | O endereço do destinatário rejeitou sua mensagem: normalmente, é um erro causado por um filtro antispam | Sua mensagem foi detectada e rotulada como spam. Você deve pedir ao destinatário para colocar você na lista de permissões. |
| 550 | Geralmente define um endereço de e-mail inexistente no lado remoto. | Embora possa ser retornado também pelo firewall do destinatário (ou quando o servidor de entrada estiver inativo), a grande maioria dos erros 550 simplesmente informa que o endereço de e-mail do destinatário não existe. Você deve entrar em contato com o destinatário de outra forma e obter o endereço correto. |
| 551 | “Usuário não local ou endereço inválido – Relé negado”. Ou seja, se o seu endereço e o do destinatário não estiverem hospedados localmente pelo servidor, uma retransmissão pode ser interrompida. | É uma estratégia (não muito inteligente) para evitar spam. Você deve entrar em contato com seu ISP e pedir que o autorizem como um remetente certificado. |
| 552 | “Ações de correio solicitadas abortadas – Alocação de armazenamento excedida”: simplesmente, a caixa de correio do destinatário excedeu seus limites. | Tente enviar uma mensagem mais leve: isso geralmente acontece quando você envia e-mails com anexos grandes, então verifique-os primeiro. |
| 553 | “Ação solicitada não executada – nome da caixa de correio inválido”. Ou seja, há um endereço de e-mail incorreto na linha de destinatários. | Verifique todos os endereços nos campos TO, CC e BCC. Deve haver um erro ou um erro de ortografia em algum lugar. |
| 554 | Isso significa que a transação falhou. É um erro permanente e o servidor não tentará enviar a mensagem novamente. | O servidor de entrada pensa que seu e-mail é spam ou que seu IP foi colocado na lista negra. Verifique cuidadosamente se você acabou em algumas listas de spam e entre em contato com o seu provedor. |
Problemas e Soluções
Erro ao enviar emails "aleatórios", ou após o envio de alguns emails ocorre erro de autenticação ou timeout (javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure)
Alguns servidores de email podem identificar de forma não inteligente, possíveis problemas de segurança relacionados a SPAM, envio de arquivos maliciosos, especialmente quando há anexos no email, ou quando são enviados vários emails em sequencia.
As causas deste comportamento são variadas, sendo necessário realizar testes:
- Experimente marcar para compactar anexos;
- Aumente o tempo de envio entre os emails, 5/10 segundos;
- Verifique os destinatarios, se há algum email "estranho";
- Experimente mudar de internet/provedor, por exemplo tentar o envio de internet 3G/4G
- Entre em contato com o seu provedor de email com detalhes do problema;