Antes do primeiro envio a sério

Tudo o que está aqui já causou um incidente a alguém. Nenhum destes pontos demora mais do que minutos a verificar.

Testa para endereços que controlas

Manda as primeiras mensagens para caixas tuas, e de vários fornecedores: Gmail, Outlook, e uma caixa de empresa com filtro próprio, se tiveres. As três comportam-se de maneira diferente e é isso que queres ver.

Confirma em cada uma:

• A mensagem chegou à caixa de entrada e não ao spam.
• O nome do remetente é o que querias, e não o endereço cru.
• O assunto não está cortado nem com caracteres estranhos.
• A versão em texto simples existe e faz sentido sozinha.
• As ligações apontam para onde devem, em produção e não em desenvolvimento.

Vê a autenticação na própria mensagem

No Gmail, abre a mensagem, carrega nos três pontos e escolhe Mostrar original. O que queres ver é isto:

SPF:   PASS with IP 1.2.3.4
DKIM:  'PASS' with domain mail.empresa.pt
DMARC: 'PASS'

Se o DKIM disser o teu domínio e passar, está feito. Se o DMARC falhar com o DKIM a passar, é quase sempre o From a apontar para um domínio diferente do que está assinado.

Confirma que as devoluções voltam

Manda uma mensagem para um endereço que de certeza não existe, no teu próprio domínio, e vê em Mensagens que a linha passa a Devolvido dentro de minutos. Se ficar em Aceite para sempre, há alguma coisa errada no caminho das devoluções e vais descobri-lo com uma lista inteira em vez de uma mensagem.

Trata o 202 como aceite e não como entregue

É o erro de integração mais comum. Se mostras ao utilizador "email enviado" quando recebes o 202, estás a prometer uma coisa que ainda não aconteceu. Espera pelo evento de entrega, ou muda o texto.

Guarda o identificador

O id que a API devolve é o que liga a tua base de dados aos eventos, aos webhooks e ao que o suporte precisa para procurar uma mensagem. Guardá-lo custa uma coluna.

Decide o que fazer com uma supressão

Um pedido para um endereço suprimido volta com 422. A resposta certa raramente é repetir; é marcar esse contacto do teu lado como não contactável, para não voltares a tentar amanhã.

Cuidado com o ambiente

A causa número um de uma campanha enviada para clientes reais a partir de um ambiente de testes é uma base de dados copiada de produção com os endereços verdadeiros lá dentro. Se tens um ambiente de testes, usa uma chave de API diferente e endereços teus.

Sobe o volume aos poucos

Se vais começar a enviar milhares de mensagens por dia a partir de um domínio novo, não comeces por aí. Alguns milhares no primeiro dia, a dobrar de dois em dois dias, e a ver as devoluções entre cada passo. Um domínio novo com um pico súbito parece exactamente o que um filtro está à espera de bloquear.