Email Spam Tester

Home › Integrációk › Útmutatók › SendGrid

Útmutató · nincs szükség csatlakoztatásra

SendGrid e-mailek tesztelése

A SendGrid valójában két küldőt biztosít egyetlen bejelentkezéssel: a Marketing Campaigns felületeit és az Email API-t. Eltérő fejléceket adnak a levelekhez, ezért kissé eltérően kell tesztelni őket.

Útmutató · SendGrid

Teszteljen egy e-mailt a(z) SendGrid platformról

Egy cím, egy e-mail, egy órán át érvényes. Nincs szükség fiókra vagy API-kulcsra.

Tesztcím kérése

1. lépés

Hitelesítse a domaint

Domainhitelesítés: egy CNAME az em[0000] címen, két DKIM CNAME és egy DMARC TXT.

2. lépés

Küldjön egy valódi e-mailt egy tesztcímre

Egy Single Send küldése egyetlen kontaktot tartalmazó listára, vagy egy curl-hívás a /v3/mail/send végpontra.

3. lépés

Olvassa el a jelentést

Keresse a "via sendgrid.net" jelölést, az igazítási sorokat és a leiratkozási fejléceket.

A Single Sends szolgáltatásban összeállított hírlevél és a /v3/mail/send útvonalon keresztül küldött jelszó-visszaállítás ugyanabból a SendGrid-fiókból indulhat, mégis jelentősen eltérő e-mailként érkezhet meg, ami fontos a spamtesztnél. A Marketing Campaigns mindig megpróbál leiratkozási fejléceket hozzáadni, míg az API csak akkor adja hozzá őket, ha Ön ezt kérte. Ezért még a küldés előtt döntse el, hogy a kettő közül melyiket teszteli.

A fogadó oldal mindkét esetben ugyanaz. Az Email Spam Tester ideiglenes címet biztosít, fiók létrehozása nélkül. Csak az egy órán belül beérkező első üzenet számít, és erről jelentés készül, amely kiterjed a hitelesítésre, a SpamAssassin és a Rspamd eredményeire, a tartalomra, a Gmail és a Yahoo által meghatározott tömeges küldőkre vonatkozó szabályokra, valamint a küldő IP alapján lekérdezett 21 tiltólistára.

Single Sends: a tesztgomb és az előtagja

A beépített teszt a Marketing > Single Sends alatt található. Nyissa meg a Single Send elemet, keresse meg a Test Your Email lehetőséget, írja be a tesztcímet, majd kattintson a Send Test Message gombra. A SendGrid csak a feladó és a tárgy megadása után engedélyezi a tesztelést, Handlebars-kódot tartalmazó tárgy esetén pedig a Test Data mezőt is ki kell tölteni. Küldéskor a SendGrid a Test - előtagot illeszti a tárgysor elé.

A tényleges teszthez küldje el a Single Send elemet egy listára. A Single Sends listákra vagy szegmensekre küldhető, ezért hozzon létre egy listát, amelynek egyetlen névjegye a tesztcím, majd válassza ki ezt a Recipients alatt. Így a fejlécek, a leiratkozási hivatkozás és a nyomon követett hivatkozások megegyeznek azokkal, amelyeket egy feliratkozó kap. Ha beérkezési tesztet is végzett, annak szolgáltatói postafiókjait is hozzáadhatja ehhez a listához.

Az API és az SMTP: egyetlen curl parancs

A SendGrid első lépéseket bemutató példájának rövidített változata, amelyben a tesztcím a címzett:

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

Ha a beérkezési teszt be van kapcsolva, a szolgáltatóknál használt postaládái ugyanabba a to tömbbe kerülnek, a jelölő pedig a subject mezőbe, így az egyetlen kérés azt is megmutatja, hogy a Gmail, Outlook, Yahoo és más szolgáltatók melyik mappába helyezik az e-mailt.

Illessze be a saját tesztcímét, és adjon meg olyan From címet, amelyet a SendGrid egyedi feladó-ellenőrzéssel vagy domainhitelesítéssel ellenőrzött. Még jobb, ha azt az üzenetet küldi el, amelyet az alkalmazása ténylegesen küld, a valódi HTML-tartalommal együtt, mert a tartalom-ellenőrzések a levéltörzs tartalmát értékelik.

Ha az alkalmazása SMTP-n keresztül kommunikál, csak az átviteli mód változik. A kiszolgáló címe smtp.sendgrid.net, a felhasználónév szó szerint az apikey karakterlánc, nem az Ön kulcsa, az SSL pedig a 465-ös porton működik.

Tesztküldési végpont is rendelkezésre áll: POST /v3/marketing/test/send_email. Legfeljebb 10 címet fogad, de csak Dynamic Transactional Templates sablonokkal működik, ezért a legtöbb API-n keresztül küldött levélnél a fenti egyszerű Mail Send hívás ad valós teszteredményt.

A leiratkozási fejlécek a választott küldési módtól függenek

A Marketing Campaigns minden esetben megpróbál List-Unsubscribe fejléceket hozzáadni. Az API-n vagy SMTP-n keresztül küldött levelek csak akkor kapják meg ezeket, ha a Settings > Tracking alatt be van kapcsolva a Subscription Tracking. Ebben az esetben a SendGrid egy HTTPS-hivatkozást tartalmazó List-Unsubscribe fejlécet, valamint egy List-Unsubscribe-Post: List-Unsubscribe=One-Click fejlécet illeszt be.

Subscription Tracking nélkül Önnek kell hozzáadnia a fejléceket a kéréshez:

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

A SendGrid a mailto és a https részt is kéri, és arra figyelmeztet, hogy egy egyszerű GET kérés hatására senkit se irasson le ezen a hivatkozáson. Legyen óvatos, amikor a SendGrid e fejlécekről szóló támogatási cikkéből másol. A második példában a List-Unsubscribe-Post értékeként URL-ek szerepelnek, ami hibás. Az érték mindig List-Unsubscribe=One-Click. A további részleteket a List-Unsubscribe javítási oldalunkon találja.

Ha az üzenet jelszó-visszaállítás vagy nyugta, és nem tartalmaz levelezőlistás fejléceket, a jelentés sikertelen minősítés helyett kihagyottként jelöli meg a tömeges küldőkre vonatkozó szabálycsoportot. Az API-n keresztül küldött hírlevél nem kap ilyen felmentést.

A hitelesítési eredmények értelmezése

Tartományhitelesítés nélküli fióknál a címzettek a „via sendgrid.net” szöveget látják az Ön feladói címe után, a SendGrid dokumentációja szerint pedig ezt a tartományhitelesítés távolítja el. A jelentés azonban ennél a címkénél többet mutat. Nézze meg a DKIM- és SPF-igazítás sorait. Ha az aláírás vagy a visszatérési útvonal az Ön tartománya helyett egy SendGrid-tartományhoz tartozik, a DMARC nem lehet sikeres az Ön feladói címénél, és a tervnek a tartományhitelesítést kell javasolnia. Még rosszabb, ha gmail.com vagy yahoo.com címről küld. A SendGrid DMARC-oldala szerint ezeknél az SPF és a DKIM is sikertelen, és maga a konzol is figyelmeztet arra, hogy az ilyen üzenetek esetleg nem mennek át a DMARC-ellenőrzésen.

A tartományhitelesítés a Settings > Sender Authentication menüpontban található. Ha az alapértelmezés szerint bekapcsolt automatikus biztonság aktív, a SendGrid négy rekordot ad:

  • egy CNAME rekordot az em[0000] névnél, amely az SPF-et kezeli, és az Ön visszatérési útvonala lesz;
  • CNAME rekordokat az s1._domainkey és az s2._domainkey névnél a DKIM-hez;
  • egy TXT rekordot a _dmarc névnél, v=DMARC1; p=none; értékkel.

Példaértékek. A tényleges értékeket másolja ki a fiókjából.

NévTípusÉrtékMire szolgálMásolás
Automatikus biztonság bekapcsolva (alapértelmezett)
em[0000]CNAMEA fiókjában megadott célértékSPF és a visszatérési útvonal.
s1._domainkeyCNAMEA fiókjában megadott célértékDKIM.
s2._domainkeyCNAMEA fiókjában megadott célértékDKIM, a második selector.
_dmarcTXTv=DMARC1; p=none;DMARC.
Automatikus biztonság kikapcsolva
em[0000]MXA fiókjában megadott hosztA visszatérési útvonal.
em[0000]TXTv=spf1 include:sendgrid.net ~allSPF, amelyet Ön kezel.
m1._domainkeyTXTA fiókjában megadott kulcsDKIM.

Kikapcsolt automatikus biztonságnál egy MX rekordot és egy SPF TXT rekordot (v=spf1 include:sendgrid.net ~all) kap az em[0000] névnél, valamint egy DKIM TXT rekordot az m1._domainkey névnél, az SPF rekordot pedig Ön kezeli. Ha DNS-szolgáltatója elutasítja az _ karaktert tartalmazó CNAME-neveket, ez az egyetlen lehetőség. Ha pedig egy másik szolgáltatás már használja az s selectort, a SendGrid lehetővé teszi egy egyéni selector kiválasztását. Ellenőrizze az eredményt a DKIM-ellenőrzővel (s1 selector) és az SPF-ellenőrzővel, amely a DNS-lekérdezéseket is megszámolja, ha az SPF rekordja kezd túlzsúfolttá válni.

A kattintáskövetés minden hivatkozást átír. Ha a hivatkozás szövege maga is URL, a látható cím és a tényleges cél már nem egyezik, ezért a jelentés hivatkozáseltérés-ellenőrzése megjelöli. A SendGrid kézbesíthetőségi oldala ugyanezt a problémát emeli ki. Használjon szavakat a hivatkozás szövegeként, vagy állítsa be a hivatkozások márkajelzését, hogy a követett hivatkozások az Ön saját domainjén haladjanak át, amelynek egyeznie kell a feladói domainnel.

A Trial és Essentials csomagok megosztott IP-készletekből küldenek. A SendGrid szerint ezek előzetes értesítés nélkül változhatnak, ha megváltozik az Ön hírneve, ezért ha valamelyik IP tiltólistára kerül, az az adott készlet minden használóját érinti. A tiltólista-ellenőrzővel később ismét ellenőrizheti az IP-címet. A Reverse DNS csak dedikált IP-címmel állítható be, amely a Pro Email API és az Advanced Marketing Campaigns csomaghoz érhető el.

Kérdések

Miért jelenik meg a „via sendgrid.net” az e-mailjeimnél?

A SendGrid még nem hitelesítette az Ön küldő domainjét. Állítsa be a domainhitelesítést a Settings > Sender Authentication alatt. A SendGrid dokumentációja szerint ezután eltűnik a jelölés.

A jelentés szerint hiányzik a List-Unsubscribe, pedig SendGridet használok. Miért?

Valószínűleg az API-n vagy SMTP-n keresztül küld, miközben a Subscription Tracking ki van kapcsolva. Kapcsolja be a Settings > Tracking alatt, vagy adja hozzá mindkét fejlécet a headers objektumban.

Használhatom ehhez a SendGrid „Send Test Message” funkcióját?

Igen, az üzenet megérkezik a tesztcímre. Ne feledje, hogy a tárgysor elejére bekerül a Test - előtag. Ha pontosan olyan fejléceket szeretne, mint amilyeneket a feliratkozók kapnak, akkor jobb megoldás egy Single Send küldése egy egyetlen névjegyet tartalmazó listára.

Használhatom a tesztküldési API-végpontot a Mail Send helyett?

Csak Dynamic Transactional Templates esetén, mert a /v3/marketing/test/send_email kizárólag ezt fogadja el. Legfeljebb 10 címet kezel. Minden más a /v3/mail/send végponton keresztül megy.

Melyik szelektort írjam be a DKIM-ellenőrzőbe?

Ha az automatikus biztonság be van kapcsolva, ellenőrizze az s1 és az s2 szelektort. Ha ki van kapcsolva, a szelektor m1. Ha a beállítás során egyéni szelektort választott, akkor azt használja.

Útmutatók más platformokhoz

Minden integráció és útmutató →

Teszteljen egy e-mailt most

Egy cím, egy e-mail, egy órán át érvényes. Nincs szükség fiókra. A jelentés az ellenőrzések befejeződésével automatikusan elkészül.

Tesztcím kérése