emailManager

Acesso SMTP

Você quer testar o emailmanager, mas sua aplicação envia e-mails a partir de um servidor SMTP? Você pode trocar instantâneamente a sua entrega de e-mail sem precisar modificar a aplicação. Esse recurso permite que você use o SMTP de forma simplificada para enviar suas mensagens e, para isto, você precisa apenas alterar a sua configuração atual para direcionando para o servidor SMTP do emailmanager.

Como o envio funciona?

Assim como a API Transacional usa o Token de acesso do servidor para autenticar o cliente, o acesso SMTP também é configurado por servidor. A tela de configurações do servidor permite que você habilite ou desabilite o acesso SMTP para um servidor. Depois de habilitar o acesso SMTP, você poderá se conectar ao endereço/host smtp.trans.emailmanager.com usando o Token de acesso do seu servidor nome de usuário e senha.

Depois de habilitar o acesso SMTP, todos os e-mails enviados por seu servidor serão coletados e direcionados para a fila de envio da API Transacional. Quando uma mensagem SMTP chega, ela é analisada para que sejam extraidos o remetente, os destinatários, o assunto e outros cabeçalhos de e-mail. é então montada uma mensagem similar aquela definida pela API Transacional. Para as mensagens por SMTP, é necessário montar seu próprio corpo, seja ele Html, Texto ou Multipart (MIME), sendo então enviado para os destinatários.

Se você não puder utilizar a porta 25 devido a problemas de firewall, nós oferecemos uma porta alternativa: 2525

Detalhes da conexão

O serviço SMTP do emailmanager está disponível para acesso pelo endereço smtp.trans.emailmanager.com na porta 25 e 2525 (para contornar problemas de firewall). A autenticação deve ser feita em modo Text-Plain (autenticação simples). O conteúdo da mensagem deve ser enviado para o SMTP sem criptografia, para que possa ser intepretada e exibida pelos destinatários corretamente.

Diferenças para a API

A API Transacional é a API primária para o envio dos e-mails e o SMTP é considerado uma rota de migração. O propósito de se usar o acesso SMTP é evitar mudanças no seu código de programação. Uma vez que você está no ponto de modificar o seu código, é melhor fazer uso da API Transacional.

Muitas bibliotecas pré-definidas para uso da API Transacional oferecem recursos avançados como repetições no caso de erros na rede. Isso ajudaria nos casos em que há uma dificuldade temporária em se conectar aos servidores do emailmanager. Este é um dos motivos pelo qual recomendamos que clientes com alto volume de envio, eventualmente troquem para a API Transacional.

Outra diferença importante entre os dois meios de envio, é como se lida com os erros. A API Transacional vai retornar um erro imediatamente se você fornecer dados incorretos na requisição. O SMTP vai aceitar todas as mensagens e bounces para que seja feita a validação e envio posteriormente.

Solucionando problemas de entrega

Devido a natureza do protocolo SMTP, não é possível para nós retornarmos um erro para o cliente SMTP quando descobrirmos que há algo de errado com a mensagem. Para contornar essa limitação, nós registramos um tipo especial de bounce - SMTPApiError. A descrição do bounce vai conter uma curta mensagem descrevendo o erro ocorrido. Conferindo a fonte bruta do bounce irá mostrar uma mensagem de erro maior, além de outros detalhes como o código do erro. A fonte bruta também vai conter a mensagem SMTP que foi recebida. É aconselhavel monitorar seus bounces periodicamente ou definir um "bounce hook" virtual que irá lhe alertar se houverem falhas na entrega por SMTP.

O que devo fazer se minha mensagem é legítima, mas ainda assim foi rejeitada?

Por favor, entre em contato com nosso suporte fornecendo detalhes sobre o erro que você está recebendo - melhor ainda se for fornecido o conteúdo completo do erro, contendo tanto as mensagens de erro quanto as que foram enviadas.

Por que eu não consigo autenticar com o servidor SMTP?

Por favor, verifique se você está usando o Token do seu servidor como nome de usuário, e também como senha. Também verifique se você habilitou o acesso SMTP para o seu Servidor na tela de configurações, senão a mensagem será recusada.