Testar emails do SendGrid

Uma newsletter criada em Single Sends e uma reposição de palavra-passe enviada através de /v3/mail/send podem sair da mesma conta SendGrid e, ainda assim, chegar como emails bastante diferentes, o que é relevante num teste de spam. O Marketing Campaigns tenta sempre adicionar cabeçalhos de cancelamento de subscrição, enquanto a API só os adiciona se você o tiver solicitado. Por isso, decida qual dos dois pretende testar antes de enviar algo.

A receção funciona da mesma forma para ambos. O Email Spam Tester fornece-lhe um endereço temporário, sem necessidade de conta. Apenas conta a primeira mensagem que chegar no prazo de uma hora, sendo gerado um relatório que abrange a autenticação, os resultados do SpamAssassin e do Rspamd, o conteúdo, as regras para remetentes em massa definidas pelo Gmail e pelo Yahoo e 21 listas de bloqueio consultadas com o seu IP de envio.

Single Sends: o botão de teste e o respetivo prefixo

O teste integrado encontra-se em Marketing > Single Sends. Abra o Single Send, localize Test Your Email, introduza o endereço de teste e clique em Send Test Message. O SendGrid exige um remetente e um assunto antes de permitir o teste. Se o assunto incluir Handlebars, também é necessário preencher Test Data. Ao enviar, o SendGrid adiciona Test - no início do assunto.

Para o envio real, envie o Single Send para uma lista. Os Single Sends são enviados para listas ou segmentos, por isso crie uma lista que tenha o endereço de teste como único contacto e selecione-a em Recipients. Assim, os cabeçalhos, a ligação para cancelar a subscrição e as ligações monitorizadas serão os mesmos que um subscritor recebe. Se também tiver feito o teste de colocação na caixa de entrada, pode adicionar a essa lista as caixas de entrada dos respetivos fornecedores.

A API e o SMTP: um comando curl

Adaptado do exemplo de introdução do SendGrid, com o endereço de teste como destinatário:

curl --request POST \
  --url https://api.sendgrid.com/v3/mail/send \
  --header 'Authorization: Bearer <<YOUR_API_KEY>>' \
  --header 'Content-Type: application/json' \
  --data '{"personalizations":[{"to":[{"email":"test-xxxxxxxxxxxxxxxxxxxx@t.email-spam-tester.com"}],"subject":"Hello, World!"}],"content":[{"type":"text/plain","value":"Heya!"}],"from":{"email":"you@yourdomain.com","name":"Your Name"}}'

Quando o teste da caixa de entrada está ativo, os endereços de teste dos fornecedores são adicionados ao mesmo array to e o marcador é adicionado a subject. Assim, o mesmo pedido também indica em que pasta o Gmail, Outlook, Yahoo e outros fornecedores colocam o email.

Introduza o seu endereço de teste e um endereço From verificado pelo SendGrid, através da verificação de remetente único ou da autenticação de domínio. Melhor ainda, envie a mensagem que a sua aplicação envia realmente, com o respetivo HTML, porque as verificações de conteúdo avaliam o que está no corpo da mensagem.

Se a sua aplicação comunicar por SMTP, nada muda além do transporte. O servidor é smtp.sendgrid.net, o nome de utilizador é literalmente a string apikey (não a sua chave) e o SSL usa a porta 465.

Existe também um endpoint para envios de teste, POST /v3/marketing/test/send_email. Aceita até 10 endereços, mas funciona apenas com Dynamic Transactional Templates. Por isso, para a maioria dos emails enviados por API, a chamada Mail Send simples acima é o teste mais fiel.

Os cabeçalhos de cancelamento dependem da via escolhida

Marketing Campaigns tenta sempre adicionar cabeçalhos List-Unsubscribe. O correio enviado através da API ou de SMTP só os recebe quando Subscription Tracking está ativado em Settings > Tracking. Nesse caso, o SendGrid insere List-Unsubscribe com uma ligação HTTPS e List-Unsubscribe-Post: List-Unsubscribe=One-Click.

Sem Subscription Tracking, você adiciona os cabeçalhos no próprio pedido:

"headers": {
  "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
  "List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}

O SendGrid exige tanto a parte mailto como a parte https e alerta para não cancelar a subscrição de ninguém através de um simples pedido GET a essa ligação. Tenha cuidado ao copiar estes cabeçalhos do artigo de suporte do SendGrid. O segundo exemplo define List-Unsubscribe-Post como URLs, o que está errado. O valor é sempre List-Unsubscribe=One-Click. A nossa página de correção de List-Unsubscribe contém o restante.

Se a mensagem for uma reposição de palavra-passe ou um recibo e não incluir cabeçalhos de lista, o relatório marca o grupo de regras para remetentes em massa como ignorado, em vez de o considerar uma falha. Uma newsletter enviada através da API não beneficia dessa exceção.

Ler os resultados da autenticação

Numa conta sem autenticação de domínio, os destinatários veem "via sendgrid.net" depois do seu endereço From, e a documentação do SendGrid indica que a autenticação de domínio remove essa indicação. O relatório vai além desta indicação. Consulte as linhas de alinhamento DKIM e SPF. Se a assinatura ou o caminho de retorno pertencer a um domínio do SendGrid em vez de ao seu, o DMARC não pode ser aprovado para o seu endereço From, e o plano deve recomendar a autenticação de domínio. Enviar a partir de um endereço gmail.com ou yahoo.com é ainda pior. A página de DMARC do SendGrid indica que tanto o SPF como o DKIM falham nesses casos, e a própria consola avisa que essas mensagens podem falhar numa verificação DMARC.

A autenticação de domínio encontra-se em Settings > Sender Authentication. Com a segurança automatizada ativada, que é a predefinição, o SendGrid fornece quatro registos:

• um CNAME em em[0000], que abrange o SPF e passa a ser o seu caminho de retorno;
• registos CNAME em s1._domainkey e s2._domainkey para DKIM;
• um TXT em _dmarc com v=DMARC1; p=none;.

Com a segurança automatizada desativada, obtém um MX e um TXT de SPF (v=spf1 include:sendgrid.net ~all) em em[0000], além de um TXT de DKIM em m1._domainkey, e fica responsável por gerir o registo SPF. Se o seu fornecedor de DNS rejeitar nomes CNAME que contenham _, esta é a única opção. Se outro serviço já utilizar o seletor s, o SendGrid permite-lhe escolher um seletor personalizado. Verifique o resultado com o verificador de DKIM (seletor s1) e o verificador de SPF, que também contabiliza as consultas DNS caso o seu registo SPF esteja a ficar demasiado preenchido.

Links, IPs e o resto do relatório

O rastreio de cliques reescreve todos os links. Se o texto do link for um URL, o endereço visível e o destino real deixam de corresponder, e a verificação de incompatibilidade de links do relatório irá assinalá-lo. A página de capacidade de entrega do SendGrid refere o mesmo problema. Utilize palavras como texto do link ou configure a personalização de links para que os links monitorizados utilizem o seu próprio domínio, que tem de corresponder ao domínio From.

Os planos Trial e Essentials enviam a partir de conjuntos de IPs partilhados, que, segundo o SendGrid, podem mudar sem aviso prévio se a sua reputação mudar. Por isso, a presença de um desses IPs numa lista de bloqueio afeta todos os utilizadores desse conjunto. O verificador de listas de bloqueio permite voltar a consultar o IP mais tarde. O DNS inverso só pode ser configurado com um IP dedicado, disponível com Pro Email API e Advanced Marketing Campaigns.