Cum să migrați de la Mailchimp Transactional API la SendGrid

Publicat: 2016-02-26

În 2016, Mandrill – cunoscut acum sub numele de Mailchimp Transactional API – a devenit un serviciu suplimentar exclusiv pentru Mailchimp. Aceasta însemna că numai membrii lunari Mailchimp puteau accesa funcțiile de tranzacție prin e-mail ale lui Mandrill. Pentru alți utilizatori, au trebuit fie să aleagă o altă platformă, fie să opteze să plătească pentru un cont Mailchimp de care nu ar avea întotdeauna nevoie.

Am înțeles atunci că mulți clienți ar căuta un furnizor alternativ care ar putea trimite eficient e-mailuri. Twilio SendGrid a vrut să ajute ca acest proces să fie cât mai ușor posibil.

Migrarea de la Mailchimp Transactional API la SendGrid

Fiind strict un supliment, Mailchimp Transactional API nu este configurat pentru a livra în mod fiabil e-mailurile la scara de care aveți nevoie pentru afacerea dvs. Dar aici, la Twilio SendGrid, suntem lideri în livrarea de e-mailuri sigure și de încredere, procesând peste 100 de miliarde de e-mailuri pe lună pentru expeditorii noștri principali, inclusiv Uber, Airbnb și Spotify.

În acest tutorial, vom prezenta avantajele cheie la care vă puteți aștepta atunci când trimiteți e-mailuri cu Twilio SendGrid. Ghidul nostru de migrare pas cu pas va asigura o tranziție lină și simplificată.

Documentația Twilio SendGrid este cea mai bună resursă pentru cei care caută un răspuns la toate întrebările legate de SMTP, API și e-mail. Este un loc minunat de a începe înainte de a te scufunda în detaliile mai esențiale despre mutarea e-mailurilor și efectuarea apelurilor API.

Dar mai întâi, dacă căutați echivalentul Twilio SendGrid al anumitor funcționalități Mailchimp Transactional API, următorul tabel vă poate ajuta:

Termenul SendGrid Termenul API tranzacțional Mailchimp
substituiri merge_vars
categorii Etichete
argumente personalizate metadate
subutilizator subcont
suprimari respingeri
X-SMTPAPI X-MC-*
șabloane dinamice șabloane

Obținerea unei chei API

Pentru a începe, aveți nevoie de un cont Twilio SendGrid. Apoi, veți dori 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 dacă sunteți conectat la contul dvs. Este o practică înțeleaptă de securitate să utilizați o cheie API diferită pentru fiecare dintre aplicațiile dvs. diferite. De asemenea, puteți defini permisiunile pentru cheile API activând sau dezactivând accesul de citire sau scriere pentru punctele finale individuale. Pentru moment, veți avea nevoie doar de unul care să aibă acces complet la Trimitere e-mail. (Notă: trebuie să treceți aprovizionarea înainte de a putea crea o cheie API.)

biblioteci API

Avem o serie de biblioteci API acceptate oficial, care optimizează și mai mult procesul de trimitere a e-mailurilor. Dacă rescrieți orice cod sau refactorizați modul în care comunicați cu furnizorul de servicii de e-mail (ESP) ca parte a migrării, acum este un moment bun să utilizați una dintre aceste biblioteci pentru a vă accelera integrarea:

  • sendgrid-csharp – Biblioteca oficială C#
  • sendgrid-go – Biblioteca oficială Go
  • sendgrid-java – Biblioteca oficială Java
  • sendgrid-nodejs – Biblioteca oficială Node.js
  • sendgrid-perl – Biblioteca oficială Perl
  • sendgrid-php – Biblioteca oficială PHP
  • sendgrid-python – Biblioteca oficială Python
  • sendgrid-ruby – Biblioteca oficială Ruby
  • ti.sendgrid – Ambalaj oficial din titan

SMTP

Dacă nu utilizați una dintre bibliotecile noastre și trimiteți prin Simple Mail Transfer Protocol sau SMTP, există câteva diferențe pe care ar trebui să le cunoașteți. Pentru a vă autentifica atunci când trimiteți prin SMTP, 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.

Vă puteți conecta utilizând SMTP prin necriptat sau TLS pe ​​porturile 25, 2525 și 587. Sau 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 substituții, 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.

HTTP

Punctul final principal pentru trimiterea e-mailului este punctul final mail.send . Puteți autentifica cererile către acest punct final printr-un antet de autorizare cu cheia dvs. API prezentată ca un simbol Bearer. Găsiți un exemplu mai detaliat în documentele noastre.

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ă mai multe exemple de personalizări pentru cazuri de utilizare obișnuite. De asemenea, puteți găsi exemple de apeluri cURL .

Funcțiile, cum ar fi urmărirea clicurilor, pot fi configurate prin intermediul parametrilor tracking_settings și mail_settings .

Pentru atașamentele trimise prin HTTP, gestionați-le într-un mod similar cu Mailchimp Transactional API, unde conținutul este codificat ca Base64 și încorporat direct în încărcarea utilă JSON împreună cu extensiile de poștă Internet multifuncțională sau informațiile MIME, astfel .

Rețineți că punctul final mail.send al Twilio SendGrid este complet asincron. Vom accepta solicitarea, atâta timp cât este bine formată, și vom încerca să procesăm livrarea e-mailului cât mai curând posibil. Mailchimp Transactional API permite cererilor pentru mai puțin de 10 e-mailuri să se execute sincron. Twilio SendGrid, totuși, nu oferă modul sincron.

De asemenea, puteți programa trimiteri cu până la 72 de ore în avans utilizând parametrul „send_at”.

Webhook-uri

Twilio SendGrid oferă două webhook-uri: Event Webhook pentru postarea evenimentelor în timp real și Inbound Email Parse Webhook pentru a primi e-mailuri și a răspunde programatic la acestea. Formele de date și încărcăturile utile sunt puțin diferite de ceea ce oferă Mailchimp Transactional API - Twilio SendGrid nu are un echivalent cu webhook-ul „sincronizare”.

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 cele mai multe cazuri, și aplicăm limite de rată pentru apeluri. În ciuda faptului că nu există o perioadă de timp pentru a opri suportul, API v2 este încă disponibil minim. Toate integrările noi, totuși, ar trebui să se îndrepte spre v3. Autentificarea API v3 este accesibilă printr- un antet de autentificare cu un simbol Bearer .

Întrebări frecvente despre migrarea la Twilio SendGrid

Î: Acceptați șabloanele pentru e-mailurile tranzacționale?

R: Da, iar șabloanele sunt dinamice! Șabloanele tranzacționale Twilio SendGrid oferă suport nativ pentru sintaxa Handlebars. În plus față de înlocuirile ș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 despre șabloanele noastre, faceți clic aici .

Î: Este posibil pentru mine să-mi testez e-mailurile fără a fi nevoit să le trimit?

R: Puteți activa modul sandbox când trimiteți e-mailuri prin HTTP. Există, de asemenea, o adresă „de colectare” pe care o puteți folosi în scopuri de testare.

Î: Este posibil să transfer adresa mea IP/reputația expeditorului către Twilio SendGrid?

R: Nu putem migra o IP sau o reputație, dar vă putem ajuta la încălzirea automată a unui nou IP .

Î: Twilio SendGrid acceptă TLS forțat?

A: Absolut. Serverele noastre de recepție acceptă TLS și renunță la mesajele trimise care nu sunt conforme.

Î: Pot permite destinatarilor mei să definească tipurile de e-mailuri pe care doresc să le primească?

A: Da! Oferirea mai multor control destinatarilor vă permite să trimiteți e-mailuri către abonații care le doresc cu adevărat, ceea ce este mai bine pentru toată lumea pe termen lung. Consultați grupurile noastre de dezabonare pentru mai multe informații.

Î: Puteți trimite e-mailuri către mai mulți destinatari per solicitare?

A: Da. Clienții API v3 care folosesc personalizări pot include până la 1.000 de destinatari per solicitare. Utilizatorii SMTP pot include până la 10.000 de destinatari per mesaj, dar de multe ori vă recomandăm să utilizați 1.000 de destinatari per cerere.

Aflați mai multe despre trecerea de la Mailchimp Transactional API la Twilio SendGrid