SendGrid-e-mails testen

Een nieuwsbrief die in Single Sends is gemaakt en een wachtwoordreset die via /v3/mail/send is verzonden, kunnen vanuit hetzelfde SendGrid-account worden verstuurd en toch als heel verschillende e-mails aankomen. Dat is belangrijk voor een spamtest. Marketing Campaigns probeert altijd afmeldheaders toe te voegen, terwijl de API deze alleen toevoegt als je daarom hebt gevraagd. Bepaal daarom welke van de twee je test voordat je iets verstuurt.

De ontvangende kant is voor beide hetzelfde. Email Spam Tester geeft je een tijdelijk adres, zonder dat je een account nodig hebt. Alleen het eerste bericht dat binnen een uur aankomt, telt. Je krijgt hiervoor een rapport met controles van authenticatie, beoordelingen van SpamAssassin en Rspamd, inhoud, de regels voor bulkafzenders van Gmail en Yahoo, en 21 blokkeerlijsten die met je verzendende IP zijn geraadpleegd.

Single Sends: de testknop en het voorvoegsel

De ingebouwde test vind je onder Marketing > Single Sends. Open de Single Send, zoek Test Your Email, voer het testadres in en klik op Send Test Message. SendGrid vereist een afzender en een onderwerp voordat je kunt testen. Als het onderwerp Handlebars bevat, moet je ook Test Data invullen. Bij het verzenden zet SendGrid Test - voor de onderwerpregel.

Voor de echte test stuur je de Single Send naar een lijst. Single Sends worden naar lijsten of segmenten gestuurd. Maak daarom een lijst met alleen het testadres als contact en selecteer deze onder Recipients. De headers, de afmeldlink en de gevolgde links zijn dan dezelfde als die een abonnee ontvangt. Als je ook de inboxplaatsingstest hebt uitgevoerd, kun je de inboxen van de providers aan die lijst toevoegen.

De API en SMTP: één curl-opdracht

Ingekort uit het introductievoorbeeld van SendGrid, met het testadres als ontvanger:

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"}}'

Wanneer de inboxplaatsingstest is ingeschakeld, worden de inboxadressen van je providers aan dezelfde to-array toegevoegd en komt de marker in subject. Zo laat dat ene verzoek ook zien in welke map Gmail, Outlook, Yahoo en andere providers de e-mail plaatsen.

Vul je eigen testadres in en gebruik een afzenderadres dat SendGrid heeft geverifieerd via verificatie van één afzender of domeinauthenticatie. Nog beter is het om het bericht te versturen dat je app daadwerkelijk verzendt, met de echte HTML, omdat de inhoudscontroles beoordelen wat er in de berichttekst staat.

Als je applicatie via SMTP communiceert, verandert alleen het transport. De host is smtp.sendgrid.net, de gebruikersnaam is letterlijk de tekenreeks apikey (niet je sleutel) en SSL gebruikt poort 465.

Er is ook een endpoint voor testverzending, POST /v3/marketing/test/send_email. Dit accepteert maximaal 10 adressen, maar werkt alleen met Dynamic Transactional Templates. Voor de meeste e-mail via de API is de gewone Mail Send-aanroep hierboven daarom de meest betrouwbare test.

Uitschrijfheaders hangen af van het gekozen pad

Marketing Campaigns probeert altijd List-Unsubscribe-headers toe te voegen. E-mail die via de API of SMTP wordt verzonden, krijgt deze alleen als Subscription Tracking is ingeschakeld onder Settings > Tracking. In dat geval voegt SendGrid List-Unsubscribe toe met een HTTPS-link en List-Unsubscribe-Post: List-Unsubscribe=One-Click.

Zonder Subscription Tracking voeg je de headers zelf toe aan de aanvraag:

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

SendGrid vereist zowel het mailto- als het HTTPS-gedeelte en waarschuwt dat je niemand moet uitschrijven via een gewone GET-aanvraag naar die link. Wees voorzichtig als je iets kopieert uit het supportartikel van SendGrid over deze headers. In het tweede voorbeeld wordt List-Unsubscribe-Post ingesteld op URL's, wat onjuist is. De waarde is altijd List-Unsubscribe=One-Click. De rest staat op onze pagina voor het oplossen van List-Unsubscribe-problemen.

Als het bericht een wachtwoordreset of ontvangstbewijs is en geen lijstheaders bevat, markeert het rapport de groep met regels voor bulkafzenders als overgeslagen in plaats van mislukt. Een nieuwsbrief die via de API wordt verzonden, krijgt die uitzondering niet.

De authenticatieresultaten lezen

Bij een account zonder domeinauthenticatie zien ontvangers "via sendgrid.net" achter je afzenderadres. Volgens de documentatie van SendGrid verdwijnt dit na domeinauthenticatie. Het rapport gaat verder dan alleen deze vermelding. Bekijk de uitlijningsregels voor DKIM en SPF. Als de handtekening of het Return-Path bij een SendGrid-domein hoort in plaats van bij jouw domein, kan DMARC niet slagen voor je afzenderadres. Het stappenplan moet je dan naar domeinauthenticatie verwijzen. Verzenden vanaf een gmail.com- of yahoo.com-adres is nog slechter. Op de DMARC-pagina van SendGrid staat dat zowel SPF als DKIM hiervoor mislukken. De console waarschuwt zelf ook dat zulke berichten mogelijk niet door een DMARC-controle komen.

Domeinauthenticatie vind je onder Settings > Sender Authentication. Als geautomatiseerde beveiliging is ingeschakeld, wat standaard het geval is, geeft SendGrid je vier records:

• een CNAME op em[0000], die SPF afhandelt en je Return-Path wordt;
• CNAME-records op s1._domainkey en s2._domainkey voor DKIM;
• een TXT-record op _dmarc met v=DMARC1; p=none;.

Als geautomatiseerde beveiliging is uitgeschakeld, krijg je op em[0000] een MX-record en een SPF TXT-record (v=spf1 include:sendgrid.net ~all), plus een DKIM TXT-record op m1._domainkey. Je beheert het SPF-record dan zelf. Als je DNS-provider CNAME-namen met _ weigert, is dit de enige optie. Als een andere dienst de selector s al gebruikt, kun je in SendGrid een aangepaste selector kiezen. Controleer het resultaat met de DKIM-controle (selector s1) en de SPF-controle. Die laatste telt ook DNS-lookups als je SPF-record vol begint te raken.

Links, IPs en de rest van het rapport

Kliktracking herschrijft elke link. Als je linktekst zelf een URL is, komen het zichtbare adres en het werkelijke doel niet meer overeen. De controle op niet-overeenkomende links in het rapport zal dit markeren. De pagina van SendGrid over afleverbaarheid wijst op hetzelfde probleem. Gebruik woorden als linktekst, of stel link branding in zodat de gevolgde links via je eigen domein lopen. Dit domein moet overeenkomen met je From-domein.

De abonnementen Trial en Essentials verzenden via gedeelde IP-pools. SendGrid vermeldt dat deze zonder voorafgaande kennisgeving kunnen veranderen als je reputatie verandert. Een vermelding op een blokkeerlijst voor een van deze IPs is daarom van belang voor iedereen in die pool. Met de blokkeerlijstcontrole kun je het IP later opnieuw opzoeken. Reverse DNS is alleen configureerbaar met een dedicated IP, dat beschikbaar is bij Pro Email API en Advanced Marketing Campaigns.