Cum să migrați de la Livrarea prin e-mail Dyn la SendGrid
Publicat: 2016-11-23Odată cu vestea recentă că Dyn este achiziționată de Oracle pentru afacerea sa de management DNS, oamenii au căutat soluții care se concentrează complet pe e-mail. Echipa noastră a avut o creștere a numărului de întrebări despre cum să migrați de la livrarea de e-mail Dyn la SendGrid, așa că am decis să creăm acest ghid.
Dacă doriți să aruncați o privire în jur înainte de a pleca, consultați documentația SendGrid. Classroom este un loc grozav pentru a începe să înveți despre e-mail înainte de a te scufunda în referințele și detaliile API.
De la înființarea noastră, suntem o companie API, care folosește numai e-mailuri, iar acest lucru se reflectă în produsele noastre. Punctul final de e-mail HTTP, webhook-urile, SMTP și API-ul non-email sunt esențiale pentru afacerea noastră și veți vedea acest lucru reflectat în capacitățile lor. Acest ghid va avea ca scop să vă ofere elementele de bază despre cum să vă configurați pe SendGrid, evidențiind în același timp funcțiile utile cărora le lipsesc furnizorul dvs. actual.
Obținerea unei chei API
Mai întâi veți avea nevoie de un cont SendGrid. Apoi, ar trebui să creați o cheie API pe care o veți folosi pentru trimitere. Accesați Setări -> Chei API sau utilizați acest link. O bună practică SendGrid și de securitate este să utilizați o cheie API diferită pentru fiecare dintre aplicațiile dvs. diferite. Cheile API au permisiuni granulare, astfel încât să puteți activa sau dezactiva accesul de citire sau scriere pentru punctele finale individuale. Asigurați-vă că cheia API pe care o creați are acces deplin la Mail Send . (Notă: contul dvs. trebuie să treacă aprovizionarea înainte de a putea crea o cheie API.)
Biblioteci API
În timp ce Dyn oferă SDK-uri oficiale în Python și PHP, noi șapte biblioteci API acceptate oficial pentru a face integrarea mai ușoară pentru clienții noștri. Dacă rescrieți orice cod sau refactorizați modul în care comunicați cu ESP ca parte a migrării, acum este un moment bun pentru a evalua aceste biblioteci:
- sendgrid-csharp – Biblioteca oficială C#
- sendgrid-go – Biblioteca oficială Go
- sendgrid-java – Biblioteca oficială Java
- sendgrid-nodejs – Biblioteca oficială NodeJS
- sendgrid-php – Biblioteca oficială PHP
- sendgrid-python – Biblioteca oficială Python
- sendgrid-ruby – Biblioteca oficială Ruby
SMTP
Dacă trimiteți prin SMTP, există câteva diferențe de care ar trebui să știți. În primul rând, nu trebuie să vă faceți griji cu privire la utilizarea unui anumit server SMTP bazat pe dimensiunea mesajului dvs., așa cum o cere Dyn. De asemenea, acceptăm mesaje de până la ~19,5 MB față de limita Dyn de 10 MB. Pentru a vă autentifica, furnizați șirul „apikey” ca nume de utilizator SMTP și utilizați cheia API ca parolă. Apoi indicați numele dvs. de gazdă către smtp.sendgrid.net .
De asemenea, oferim opțiuni de porturi suplimentare în comparație cu Dyn. Vă puteți conecta utilizând SMTP prin necriptat sau TLS pe porturile 25, 2525 și 587. Vă puteți conecta și prin SSL pe portul 465. În general, vă recomandăm portul 587, deoarece tinde să ducă la cele mai puține probleme cu furnizorii de găzduire.
Mecanismul de personalizare a e-mailului trimis prin SMTP este antetul nostru X-SMTPAPI. Acest antet vă va permite să definiți înlocuiri cheie/valoare, să trimiteți solicitări de stil de îmbinare prin corespondență și să controlați filtrele (cum ar fi urmărirea clicurilor) care sunt active pentru trimiterea dvs. Puteți grupa e-mailurile pe categorii sau puteți urmări metadatele pe e-mail cu unique_args. Acestea sunt funcții puternice care vă pot reduce timpul de trimitere și cantitatea de lățime de bandă necesară pentru tranzacțiile dvs. prin e-mail și merită explorate.
HTTP
Punctul final principal pentru trimiterea de e-mail este punctul final de e-mail/trimitere. Solicitările către acest punct final sunt autentificate printr-un antet de autorizare cu cheia dvs. API prezentată ca un token purtător. Puteți găsi un exemplu mai detaliat în documentele noastre.
În comparație cu API-ul HTTP Dyn, punctul nostru final oferă mai multe funcții pentru a vă permite să personalizați și să vă gestionați destinatarii și chiar să trimiteți mai multe mesaje diferite într-o singură solicitare.
Personalizările vă permit să definiți destinatari și metadate pentru fiecare mesaj, cum ar fi valori de înlocuire pentru personalizarea conținutului sau custom_args pentru asocierea mesajelor cu ID-uri de utilizator sau numere de comandă. Există o serie de exemple de personalizări pentru cazuri de utilizare obișnuite. De asemenea, puteți găsi exemple de apeluri cURL.
Funcții precum urmărirea clicurilor sunt configurate prin intermediul parametrilor tracking_settings și mail_settings. De asemenea, puteți programa trimiteri cu până la 72 de ore în avans utilizând parametrul „send_at”.
De asemenea, facem foarte ușor să adăugați atașamente la solicitarea dvs. API. Doar codificați fișierul ca șir Base64 și încorporați-l direct în sarcina utilă JSON alături de informațiile de conținut MIME. Puteți citi mai multe despre includerea atașamentelor în următoarea secțiune a Documentation Classroom.
Webhook-uri
SendGrid oferă două webhook-uri: Event Webhook pentru postarea în timp real a evenimentelor de e-mail, cum ar fi dezabonări, respingeri etc. și Inbound Parse Webhook pentru primirea e-mail-urilor și răspunsul programatic la acestea.
Aceste funcții nu sunt disponibile pe Dyn, dar pot fi grozave pentru a adăuga automatizare suplimentară la gestionarea e-mailului. Merită să le aruncați o privire pe măsură ce începeți configurarea.
Puncte finale API non-e-mail
Pentru punctele finale API care nu trimit e-mail, consultați prezentarea generală a API v3. Folosim metode HTTP intuitive și coduri de răspuns în majoritatea cazurilor și aplicăm limite de rată pentru apeluri. API v2 este învechit, deși nu există nicio cronologie care să nu o mai accepte. Toate integrările noi ar trebui să prefere v3. Autentificarea API v3 se realizează printr-un antet de autentificare cu un simbol Bearer.
Campanii de marketing
O altă caracteristică pe care o oferim este o platformă robustă de campanii de marketing, care vă permite să vă gestionați listele, să creați segmente dinamice, să vă încărcați activele și să vă proiectați șablonul de e-mail cu un editor vizual, să efectuați teste A/B automate și multe altele. Și, desigur, există și un API deschis în spatele tuturor acestor funcții.
Câteva întrebări frecvente
Î: Acceptați șabloanele pentru e-mailurile tranzacționale?
R: Da, și sunt dinamici! Șabloanele tranzacționale SendGrid oferă suport nativ pentru sintaxa Handlebars. Pe lângă înlocuirea și înlocuirile de bază, puteți utiliza enumerari/iterați peste liste, puteți profita de condițiile și multe altele. Pentru a afla mai multe, dați clic aici.
Î: Există un sandbox sau o modalitate de a-mi testa e-mailurile fără a le trimite?
R: Puteți activa modul sandbox când trimiteți prin HTTP. Există, de asemenea, o adresă „de colectare” pe care o puteți folosi pentru testare.
Î: Este posibil să transfer adresa mea IP/reputația expeditorului către SendGrid?
R: Nu putem migra un IP sau o reputație, dar vă putem ajuta la încălzirea automată a unui nou IP.
Î: SendGrid acceptă TLS impus ?
A: Absolut. Puteți solicita ca serverele de primire să accepte TLS și să trimiteți mesajele către servere care nu sunt conforme.
Î: Pot permite destinatarilor mei să definească tipurile de e-mailuri pe care doresc să le primească?
A: Da. Oferându-le destinatarilor mai mult control asupra e-mailului lor, poți să trimiți e-mailuri pe care oamenii le doresc, ceea ce este mai bine pentru toată lumea. Consultați grupurile de dezabonare pentru mai multe informații.
Dacă sunteți interesat să migrați la SendGrid, puteți găsi mai multe informații la sendgrid.com/pricing.