Cara Bermigrasi Dari API Transaksi Mailchimp ke SendGrid

Diterbitkan: 2016-02-26

Pada tahun 2016, Mandrill—sekarang dikenal sebagai API Transaksional Mailchimp—menjadi layanan tambahan eksklusif untuk Mailchimp. Ini berarti bahwa hanya anggota bulanan Mailchimp yang dapat mengakses fitur transaksi email Mandrill. Untuk pengguna lain, mereka harus memilih platform lain atau memilih untuk membayar akun Mailchimp yang tidak selalu mereka butuhkan.

Kami kemudian memahami bahwa banyak pelanggan akan mencari penyedia alternatif yang dapat mengirimkan email secara efisien. Twilio SendGrid ingin membantu membuat proses itu semulus mungkin.

Bermigrasi dari API Transaksional Mailchimp ke SendGrid

Sebagai tambahan, API Transaksional Mailchimp tidak disiapkan untuk mengirimkan email secara andal pada skala yang Anda butuhkan untuk bisnis Anda. Namun di Twilio SendGrid, kami adalah pemimpin dalam pengiriman email yang aman dan tepercaya, memproses lebih dari 100 miliar email per bulan untuk pengirim terkemuka kami, termasuk Uber, Airbnb, dan Spotify.

Dalam tutorial ini, kita akan membahas keuntungan utama yang dapat Anda harapkan saat mengirim email dengan Twilio SendGrid. Panduan migrasi langkah demi langkah kami akan memastikan transisi yang mulus dan efisien.

Twilio SendGrid Documentation adalah sumber terbaik bagi mereka yang mencari jawaban untuk semua SMTP, API, dan pertanyaan terkait email. Ini adalah tempat yang bagus untuk memulai sebelum masuk ke detail yang lebih rumit tentang memindahkan email dan membuat panggilan API.

Tetapi pertama-tama, jika Anda mencari Twilio SendGrid yang setara dengan fungsionalitas API Transaksional Mailchimp tertentu, tabel berikut dapat membantu:

Istilah SendGrid Istilah API Transaksional Mailchimp
substitusi merge_vars
kategori tag
argumen khusus metadata
subpengguna sub-akun
penindasan penolakan
X-SMTPAPI X-MC-*
template dinamis template

Mendapatkan kunci API

Untuk memulai, Anda memerlukan akun Twilio SendGrid. Kemudian, Anda ingin membuat kunci API yang akan Anda gunakan untuk mengirim. Buka Pengaturan → Kunci API atau gunakan tautan ini jika Anda masuk ke akun Anda. Ini adalah praktik keamanan yang bijaksana untuk menggunakan kunci API yang berbeda untuk setiap aplikasi Anda yang berbeda. Anda juga dapat menentukan izin untuk kunci API dengan mengaktifkan atau menonaktifkan akses baca atau tulis untuk masing-masing titik akhir. Untuk saat ini, Anda hanya memerlukan satu yang memiliki akses penuh ke Pengiriman Surat. (Catatan: Anda harus melewati penyediaan sebelum dapat membuat kunci API.)

perpustakaan API

Kami memiliki sejumlah Perpustakaan API yang didukung secara resmi yang lebih mengoptimalkan proses pengiriman email. Jika Anda menulis ulang kode apa pun atau memfaktorkan ulang cara Anda berkomunikasi dengan penyedia layanan email (ESP) sebagai bagian dari migrasi, sekaranglah saat yang tepat untuk memanfaatkan salah satu pustaka ini untuk mempercepat integrasi Anda:

  • sendgrid-csharp – Perpustakaan C# Resmi
  • sendgrid-go – Perpustakaan Go Resmi
  • sendgrid-java – Perpustakaan Resmi Java
  • sendgrid-nodejs – Perpustakaan Node.js Resmi
  • sendgrid-perl – Perpustakaan Perl Resmi
  • sendgrid-php – Perpustakaan PHP Resmi
  • sendgrid-python – Perpustakaan Python Resmi
  • sendgrid-ruby – Perpustakaan Ruby Resmi
  • ti.sendgrid – Pembungkus Titanium resmi

SMTP

Jika Anda tidak menggunakan salah satu perpustakaan kami dan mengirim melalui Simple Mail Transfer Protocol atau SMTP, ada beberapa perbedaan yang harus Anda ketahui. Untuk mengautentikasi saat mengirim melalui SMTP, berikan string "apikey" sebagai nama pengguna SMTP dan gunakan kunci API Anda sebagai kata sandi. Kemudian, arahkan nama host Anda ke smtp.sendgrid.net.

Anda dapat terhubung menggunakan SMTP melalui tidak terenkripsi atau TLS pada port 25, 2525, dan 587. Atau, Anda juga dapat terhubung melalui SSL pada port 465. Secara umum, kami merekomendasikan port 587, karena cenderung menghasilkan sedikit masalah dengan penyedia hosting .

Mekanisme untuk menyesuaikan email yang dikirim melalui SMTP adalah header X-SMTPAPI kami . Header ini akan memungkinkan Anda untuk menentukan substitusi, mengirim permintaan gaya gabungan surat, dan filter kontrol (seperti pelacakan klik) yang aktif untuk pengiriman Anda.

HTTP

Titik akhir utama untuk mengirim email adalah titik akhir mail.send . Anda dapat mengautentikasi permintaan ke titik akhir ini melalui header otorisasi dengan kunci API Anda disajikan sebagai token Bearer. Temukan contoh yang lebih detail di dokumen kami.

Personalisasi memungkinkan Anda menentukan penerima dan metadata untuk setiap pesan, seperti nilai substitusi untuk menyesuaikan konten atau custom_args untuk mengaitkan pesan dengan ID pengguna atau nomor pesanan. Ada beberapa contoh personalisasi untuk kasus penggunaan umum. Anda juga dapat menemukan panggilan contoh cURL .

Fitur, seperti pelacakan klik, dapat dikonfigurasi melalui parameter tracking_settings dan mail_settings .

Untuk lampiran yang dikirim melalui HTTP, tangani dengan cara yang mirip dengan API Transaksional Mailchimp, di mana konten dikodekan sebagai Base64 dan disematkan langsung di muatan JSON bersama Ekstensi Surat Internet Serbaguna atau informasi MIME, seperti .

Perhatikan bahwa titik akhir mail.send Twilio SendGrid sepenuhnya asinkron. Kami akan menerima permintaan tersebut—selama permintaan tersebut dibuat dengan baik—dan berusaha untuk memproses pengiriman suratnya sesegera mungkin. API Transaksional Mailchimp memungkinkan permintaan kurang dari 10 email untuk dieksekusi secara sinkron. Twilio SendGrid, bagaimanapun, tidak menawarkan mode sinkron.

Anda juga dapat menjadwalkan pengiriman hingga 72 jam sebelumnya dengan menggunakan parameter “send_at”.

Webhook

Twilio SendGrid menyediakan dua webhook: Webhook Acara untuk memposting acara waktu nyata dan Webhook Parse Email Masuk untuk menerima email dan menanggapinya secara terprogram. Bentuk data dan muatannya sedikit berbeda dari yang ditawarkan oleh Mailchimp Transactional API—Twilio SendGrid tidak memiliki yang setara dengan webhook "sinkronisasi".

Titik akhir API non-email

Untuk titik akhir API yang tidak mengirim email, lihat ikhtisar API v3 . Kami menggunakan metode HTTP intuitif dan kode respons, dalam banyak kasus, dan memberlakukan batas tarif untuk panggilan. Meskipun tidak ada garis waktu untuk berhenti mendukungnya, API v2 masih tersedia secara minimal. Namun, semua integrasi baru harus condong ke v3. Otentikasi API v3 dapat diakses melalui header otentikasi dengan token Bearer .

Migrasi ke Twilio SendGrid FAQ

T: Apakah Anda mendukung template untuk email transaksional?

J: Ya—dan templatenya dinamis! Template transaksi Twilio SendGrid menampilkan dukungan asli untuk sintaks Handlebars. Selain penggantian dan penggantian dasar, Anda dapat menggunakan enumerasi/mengulangi daftar, memanfaatkan kondisional, dan banyak lagi. Untuk mempelajari lebih lanjut tentang template kami, klik di sini .

T: Apakah mungkin bagi saya untuk menguji email saya tanpa harus mengirimkannya?

J: Anda dapat mengaktifkan mode kotak pasir saat mengirim email melalui HTTP. Ada juga alamat "sink" yang dapat Anda gunakan untuk tujuan pengujian.

T: Apakah mungkin untuk mentransfer alamat IP/reputasi pengirim saya ke Twilio SendGrid?

J: Kami tidak dapat memigrasikan IP atau reputasi tetapi dapat membantu menghangatkan IP baru untuk Anda secara otomatis .

T: Apakah Twilio SendGrid mendukung TLS yang diberlakukan?

J: Tentu saja. Server penerima kami mendukung TLS dan menghapus pesan keluar yang tidak sesuai.

T: Dapatkah saya mengizinkan penerima saya untuk menentukan jenis email yang ingin mereka terima?

J: Ya! Memberi penerima lebih banyak kontrol memungkinkan Anda mengirim email ke pelanggan yang benar-benar menginginkannya, yang lebih baik untuk semua orang dalam jangka panjang. Lihat grup berhenti berlangganan kami untuk informasi lebih lanjut.

T: Dapatkah Anda mengirim email ke beberapa penerima per permintaan?

J: Ya. Pelanggan API v3 yang menggunakan personalisasi dapat menyertakan hingga 1.000 penerima per permintaan. Pengguna SMTP dapat menyertakan hingga 10.000 penerima per pesan—tetapi kami sering menyarankan agar Anda menggunakan 1.000 penerima per permintaan.

Pelajari lebih lanjut tentang beralih dari API Transaksional Mailchimp ke Twilio SendGrid