Mailgun'dan SendGrid'e Nasıl Geçilir?

Yayınlanan: 2018-11-10

Mailgun mevcut e-posta servis sağlayıcınızsa ve bir değişiklik yapmak istiyorsanız, bu nasıl yapılır, iki hizmet arasındaki farkları vurgulayarak SendGrid'e geçmenize yardımcı olacaktır.

Gitmeden önce etrafa bir göz atmak isterseniz, API referansına ve ayrıntılarına dalmadan önce SendGrid'in harika kaynaklar içeren belgelerine göz atın.

terminoloji

Belirli Mailgun işlevlerinin SendGrid eşdeğerini arıyorsanız, aşağıdaki tablo yardımcı olacaktır:

SendGrid Terimi posta tabancası terimi
ikameler/bölümler ikame verileri
kategoriler etiketler
benzersiz_args X-Mailgun-Değişkenleri
Çoklu Kimlik Bilgileri Çoklu Kullanıcı Erişimi
alt kullanıcı Mailgun ayrı alt kullanıcılar sağlamaz.
bastırmalar bastırmalar
X-SMTPAPI Mailgun, X-Mailgun-Recipient-Variables gibi her yapılandırma seçeneği için ayrı bir X-Başlığı kullanır
Gelen Ayrıştırma Web kancası Rotalar
Etkinlik Web kancası Web kancaları
Pazarlama Kampanyaları Eşdeğeri Yok

API Anahtarı Alma

İlk olarak, bir SendGrid hesabına ihtiyacınız olacak. Ardından, göndermek için kullanacağınız bir API anahtarı oluşturmalısınız. Ayarlar -> API anahtarlarına gidin veya bu bağlantıyı kullanın. SendGrid ve güvenlik için en iyi uygulama, farklı uygulamalarınızın her biri için farklı bir API anahtarı kullanmaktır. API anahtarlarının ayrıntılı izinleri vardır, böylece ayrı uç noktalar için okuma veya yazma erişimini etkinleştirebilir veya devre dışı bırakabilirsiniz. Oluşturduğunuz API anahtarının Mail Send'e tam erişime sahip olduğundan emin olun. (Not: Bir API anahtarı oluşturabilmeniz için hesabınızın temel hazırlığı geçmesi gerekir.)

API Kitaplıkları

Müşterilerimiz için entegrasyonu kolaylaştırmak için resmi olarak desteklenen çok sayıda API Kitaplığımız var. Geçişinizin bir parçası olarak herhangi bir kodu yeniden yazıyorsanız veya ESP'niz ile nasıl iletişim kurduğunuzu yeniden gözden geçiriyorsanız, şimdi bu kitaplıkları değerlendirmenin tam zamanı:

  • sendgrid-csharp – Resmi C# kitaplığı
  • sendgrid-go – Resmi Go kitaplığı
  • sendgrid-java – Resmi Java kütüphanesi
  • sendgrid-nodejs – Resmi NodeJS kitaplığı
  • sendgrid-php – Resmi PHP kütüphanesi
  • sendgrid-python – Resmi Python kütüphanesi
  • sendgrid-ruby – Resmi Ruby kütüphanesi

SMTP

SMTP aracılığıyla gönderiyorsanız, bilmeniz gereken birkaç farklılık vardır. Kimlik doğrulaması yapmak için, SMTP kullanıcı adı olarak 'apikey' dizesini sağlayın ve parola olarak API anahtarınızı kullanın. Ardından ana bilgisayar adınızı smtp.sendgrid.net'e yönlendirin .

25, 2525 ve 587 numaralı bağlantı noktalarında şifrelenmemiş veya TLS aracılığıyla SMTP kullanarak bağlanabilirsiniz. Ayrıca 465 numaralı bağlantı noktasında SSL aracılığıyla da bağlanabilirsiniz. Barındırma sağlayıcılarında en az soruna yol açma eğiliminde olduğundan, genel olarak 587 numaralı bağlantı noktasını öneririz.

SMTP aracılığıyla gönderilen e-postayı özelleştirme mekanizması, X-SMTPAPI başlığımızdır. Bu başlık, ikameleri tanımlamanıza, toplu adres mektup birleştirme stili istekleri göndermenize ve göndermeniz için etkin olan kontrol filtrelerini (tıklama izleme gibi) sağlar.

HTTP

E-posta göndermek için ana uç nokta, Posta uç noktasıdır. Bu uç noktaya yönelik isteklerin kimliği, API anahtarınız bir taşıyıcı belirteci olarak sunulan bir yetkilendirme başlığı aracılığıyla doğrulanır. Belgelerimizde daha ayrıntılı bir örnek bulabilirsiniz.

Kişiselleştirmeler, içeriği özelleştirmek için ikame değerleri veya mesajları kullanıcı kimlikleri veya sipariş numaralarıyla ilişkilendirmek için custom_args gibi her mesaj için alıcıları ve meta verileri tanımlamanıza olanak tanır. Yaygın kullanım durumları için bir dizi kişiselleştirme örneği vardır. Ayrıca cURL örnek aramalarını da bulabilirsiniz.

Tıklama izleme gibi özellikler, izleme_settings ve mail_settings parametreleri aracılığıyla yapılandırılır. Ayrıca “send_at” parametresini kullanarak gönderimleri 72 saat öncesine kadar planlayabilirsiniz.

HTTP yoluyla gönderilen ekler, Mailgun'dan farklı şekilde işlenir. Mailgun, eklenecek dosyaları içeren çok parçalı/form verisi POST gerektirir. SendGrid ile içerik, Base64 olarak kodlanır ve MIME bilgilerinin yanı sıra doğrudan JSON yüküne gömülür, böylece tüm mesajınızı aynı veri yükünde tutar ve HTTP isteğinizi basitleştirir. Ekleri dahil etme hakkında daha fazla bilgiyi Dokümantasyon Sınıfımızın aşağıdaki bölümünde okuyabilirsiniz.

Web kancaları

SendGrid iki web kancası sağlar: gerçek zamanlı olayları göndermek için Olay Web kancası ve e-postaları almak ve bunlara programlı olarak yanıt vermek için Gelen Ayrıştırma Web kancası. Veri şekilleri ve yükleri, Mailgun'un sağladığından biraz farklıdır. Ayrıca, şu anda gelen mesajların farklı geri arama URL'lerine yönlendirilmesini desteklemiyoruz; API düzeyinden ziyade bu tür bir mantığı kodda ele almanız gerekecek.

E-posta olmayan API Uç Noktaları

E-posta göndermeyen API uç noktaları için API v3'e genel bakış bölümüne bakın. Çoğu durumda sezgisel HTTP yöntemlerini ve yanıt kodlarını kullanırız ve aramalar için hız sınırları uygularız. API v2 kullanımdan kaldırılmıştır, ancak onu desteklemeyi bırakacak bir zaman çizelgesi yoktur. Tüm yeni entegrasyonlar v3'ü tercih etmelidir. API v3 kimlik doğrulaması, Taşıyıcı belirteci olan bir kimlik doğrulama başlığı ile gerçekleştirilir.

Pazarlama Kampanyaları

Kişi listelerini yönetmek, şablonlar oluşturmak ve tasarlamak, farklı şablonları A/B testi yapmak ve kampanyaları planlamak için tam özellikli bir platformumuz var. Bunların hepsi, geliştirici olmayanlar için kullanımı kolay bir kullanıcı arayüzüne sarılmıştır. Ve elbette tüm bu özelliklere Pazarlama Kampanyaları API'miz aracılığıyla da erişebilirsiniz.

Birkaç SSS

S: İşlem e-postaları için şablonları destekliyor musunuz?

C: Evet—ve dinamikler! SendGrid'in işlem şablonları, Gidon sözdizimi için yerel desteğe sahiptir. Temel değiştirme ve ikamelere ek olarak, listeler üzerinde numaralandırma/yineleme kullanabilir, koşul ifadelerinden faydalanabilir ve daha fazlasını yapabilirsiniz. Daha fazlasını öğrenmek için buraya tıklayın.

S: E-postalarımı göndermeden test etmenin bir korumalı alanı veya bir yolu var mı?

C: HTTP yoluyla gönderirken korumalı alan modunu etkinleştirebilirsiniz. Test için kullanabileceğiniz bir “lavabo” adresi de vardır.

S: IP adresimi/gönderen itibarımı SendGrid'e aktarmak mümkün müdür?

C: Bir IP'yi veya itibarı taşıyamayız ancak yeni bir IP'yi sizin için otomatik olarak hazırlamaya yardımcı olabiliriz.

S: SendGrid, zorunlu TLS'yi destekliyor mu ?

C: Kesinlikle. Alıcı sunucuların TLS'yi desteklemesini gerektirebilir ve uygun olmayan sunuculara giden mesajları bırakabilirsiniz.

S: Alıcılarımın almak istedikleri e-posta türlerini tanımlamasına izin verebilir miyim?

C: Evet. Alıcılarınıza e-postaları üzerinde daha fazla kontrol sağlamak, insanların istediği e-postaları göndermenize olanak tanır, bu da herkes için daha iyidir. Daha fazla bilgi için abonelikten çıkma gruplarına göz atın.

SendGrid'e geçiş yapmakla ilgileniyorsanız, daha fazla bilgiyi sendgrid.com/pricing adresinde bulabilirsiniz.