Submissões SMTP para e-mail transacional

Além da API HTTP, o Flexmail suporta o envio de e-mail transacional via SMTP. Isto é útil quando a aplicação ou plataforma já tem suporte SMTP integrado — um CMS, uma plataforma de e-commerce ou um sistema legado que envia e-mail através de um relay SMTP.

A submissão SMTP está incluída no produto transacional sem custo adicional. Proporciona a mesma fiabilidade de entrega e capacidades de rastreamento que a API, com algumas diferenças nas predefinições e funcionalidades suportadas.

Nota

A submissão SMTP não está ativada por predefinição. É necessário solicitar acesso explicitamente. Consulte "Solicitar acesso" abaixo.

Solicitar acesso

O acesso SMTP não é ativado automaticamente quando ativa o produto transacional. Para solicitar credenciais SMTP para a conta, contacte o suporte do Flexmail em support@flexmail.eu e inclua o ID da conta no pedido. O nome de utilizador e senha SMTP serão fornecidos como parte da resposta de credenciais.

Nota

As credenciais SMTP são separadas do token de acesso pessoal. O nome de utilizador e senha para SMTP são fornecidos pelo Flexmail mediante pedido — não use o ID da conta e o token de acesso pessoal como credenciais SMTP.

Definições de ligação

Uma vez concedido o acesso SMTP, use as seguintes definições:

Definição

Valor

Servidor

submission.flexmail.eu

Porta

587

Segurança da ligação

STARTTLS

Nome de utilizador

Fornecido pelo Flexmail mediante pedido

Senha

Fornecida pelo Flexmail mediante pedido

Cabeçalhos personalizados

As submissões SMTP suportam vários cabeçalhos personalizados opcionais que controlam o comportamento da mensagem e o rastreamento. Funcionam de forma semelhante às opções disponíveis na API HTTP.

Cabeçalho

Descrição

X-Flexmail-Tag

Adicione uma etiqueta para categorizar mensagens e acumular estatísticas. Deve estar em formato snake_case (1–50 caracteres, por exemplo order_confirmation).

X-Flexmail-Metadata-{key}

Adicione metadados personalizados como pares chave/valor. Substitua {key} pelo nome do campo em snake_case. O valor deve ter 1–80 caracteres.

X-Flexmail-Open-Tracking

Defina como true para ativar o rastreamento de aberturas. Desativado por predefinição.

X-Flexmail-Link-Tracking

Defina como true para ativar o rastreamento de ligações. Desativado por predefinição.

Exemplo:

X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true

Nota

O rastreamento de aberturas e ligações está desativado por predefinição tanto para submissões SMTP como para a API HTTP. Adicione os cabeçalhos correspondentes se quiser o rastreamento ativado.

ID da mensagem e correlação de webhooks

O cabeçalho Message-ID original do e-mail submetido é automaticamente armazenado como metadados sob a chave original_message_id. Isto permite correlacionar os eventos de entrega de webhook com as mensagens enviadas do próprio sistema.

SMTP vs. a API HTTP

Os dois métodos têm algumas diferenças nas predefinições e capacidades:

Funcionalidade

API HTTP

Submissão SMTP

Rastreamento de aberturas

Desativado por predefinição

Rastreamento de ligações

Desativado por predefinição

Message-ID original

N/A

Preservado como metadados original_message_id

Anexos inline

Suportado

Não suportado

E-mail apenas em texto simples

Suportado

Não suportado

Funcionalidades suportadas

E-mails HTML com ou sem uma parte de texto simples.
Rastreamento de aberturas e ligações (via cabeçalhos personalizados).
Destinatários em CC e BCC.
Anexos — devem ser codificados em base64. Os anexos inline não são suportados.
Limitação de taxa por destinatário, consistente com os limites de taxa da API.

Requisitos

O endereço De deve ser um remetente verificado na conta Flexmail.
O domínio de envio deve ser autenticado com SPF, DKIM e DMARC, e deve ser configurado um return-path. Estes requisitos são os mesmos que para a API HTTP.

Tratamento de erros

Os erros de submissão são comunicados via NDR (Non-Delivery Report) enviado para o endereço do remetente do envelope. Os eventos de bounce e todos os outros eventos de mensagem estão também disponíveis através do endpoint de detalhes da mensagem e webhooks, da mesma forma que os envios via API.

Próximos passos

Consulte "Começar com a API transacional" para o processo completo de configuração da conta.
Consulte "Webhooks transacionais" para receber eventos de entrega e rastreamento em tempo real.
Consulte "Resolução de problemas transacionais" se a ligação SMTP ou a entregabilidade não estiver a funcionar como esperado.