Cum să migrați de la Mailgun la SendGrid

Dacă Mailgun este furnizorul dvs. actual de servicii de e-mail și doriți să faceți o schimbare, această instrucțiune vă va ajuta să migrați la SendGrid evidențiind diferențele dintre cele două servicii.

Dacă doriți să aruncați o privire în jur înainte de a începe, consultați documentația SendGrid, care include resurse excelente, înainte de a vă scufunda în referința și detaliile API.

Terminologie

Dacă căutați echivalentul SendGrid al anumitor funcționalități Mailgun, următorul tabel vă va ajuta:

Obținerea unei chei API

În primul rând, 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

Avem o serie de 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. 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 .

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 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 de e-mail este punctul final de e-mail. 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.

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”.

Atașamentele trimise prin HTTP sunt tratate diferit de Mailgun. Mailgun necesită un POST multipart/form-date care să conțină fișierele care urmează să fie atașate. Cu SendGrid, conținutul este codificat ca Base64 și încorporat direct în încărcarea utilă JSON alături de informațiile MIME, păstrând întregul mesaj în aceeași sarcină utilă și simplificând solicitarea HTTP. 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 evenimentelor în timp real și Inbound 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ă Mailgun. De asemenea, nu acceptăm în prezent rutarea mesajelor de intrare către diferite adrese URL de apel invers; va trebui să gestionați acest tip de logică în cod, mai degrabă decât la nivel de API.

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

Avem o platformă completă pentru gestionarea listelor de contacte, crearea și proiectarea șabloanelor, testarea A/B diferitelor șabloane și programarea campaniilor. Toate acestea sunt împachetate într-o interfață de utilizare care este ușor de utilizat pentru non-dezvoltatori. Și, desigur, puteți accesa toate aceste funcții prin intermediul API-ului nostru pentru campanii de marketing.

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.