E-posta Takibini ve Teslim Durumunu Kontrol Etmek için Açık Kaynak Ruby API'si
Postal, web siteleri ve uygulamalar için gelen ve giden e-postaları yönetmek ve E-posta Takibini ve Teslim durumunu kontrol etmek üzere tasarlanmış tam özellikli Mail API ve Teslim Platformudur.
Postal Kütüphanesi nedir?
Bugünün dijital ortamında, etkili e-posta iletişimi her zamankinden daha kritik. İster işlem e-postaları, pazarlama kampanyaları ya da rutin bildirimler gönderiyor olun, güvenilir ve ölçeklenebilir bir e-posta teslim platformu şart. SendGrid ve Mailgun gibi tescilli hizmetler piyasayı domine ederken, güçlü bir açık kaynak alternatifi dalga yaratıyor: Postal. Postal Ruby gem'i, topluluk tarafından sürdürülen bir Ruby istemci kütüphanesidir ve Postal e-posta teslim platformunu kullanmak için bir arayüz sağlar. Ruby (ve Rails) uygulamalarının Postal ile HTTP API'si üzerinden bütünleşmesini mümkün kılar. Ruby geliştiricileri düşünülerek tasarlanmıştır. Sadece API uç noktalarını sarmakla kalmaz; Ruby bağlamında doğal hissettiren nesne yönelimli bir arayüz sunar.
Postal, web siteleri ve web sunucuları için tam, özelliklerle dolu, açık kaynaklı bir e-posta teslim platformudur. Kendi sunucularınızda çalışan özel bir SendGrid veya Mailgun gibi düşünün. Bu, e-posta gönderiminiz, verileriniz ve itibarınız üzerinde tam kontrol sağlar. Ruby ile geliştirilmiş ve sağlam bir teknoloji setiyle desteklenmiş olan Postal, performans, ölçeklenebilirlik ve kullanım kolaylığı için tasarlanmıştır. Mail sunucularınızı yönetmek, günlükleri görüntülemek ve performansı izlemek için kapsamlı bir web arayüzü sunar ve uygulamalarınızla sorunsuz entegrasyon için güçlü bir API sağlar.
Postal ile Başlarken
Postal kütüphanesini kurmanın en kolay yolu RubyGems aracılığıyladır. Kolay kurulum için lütfen aşağıdaki komutu kullanın.
Postal'ı Rubygems aracılığıyla kurun
gem install 'postal-ruby'Ruby API'si ile Temel Bir E-posta Gönderme
Açık kaynak Postal API'leri, e-posta mesajlarını çeşitli şekillerde göndermek için tam destek içermektedir. Ruby geliştiricileri, farklı karmaşıklık seviyelerine uygun olarak e-postaları birden fazla şekilde gönderebilir. Simple Hash, temel parametrelerle hızlı gönderimler için mükemmeldir. Düz metin ve HTML, çok parçalı e-postalar göndermek için kullanılabilir. Ayrıca dosyaları e-posta mesajlarınıza zahmetsizce eklemeyi de destekler ve benzeri. Aşağıdaki örnek, bir e-posta göndermenin en basit yolunu göstermektedir.
Ruby API'sı kullanarak Basit bir E-posta Nasıl Gönderilir?
# Create a client instance
client = Postal::Client.new
# Send a message using a hash of parameters
message = client.send_message(
from: 'noreply@yourdomain.com',
to: 'customer@example.com',
subject: 'Welcome to Our Service!',
body: 'Thank you for signing up. We are excited to have you on board.'
)
# The response contains the message ID, which you can use for tracking
puts "Message sent! ID: #{message.message_id}"
E-posta Takibini ve Teslim Durumunu Kontrol Edin
Kampanyalarınızın etkinliğini ölçmek için e-posta açılmalarını ve tıklamaları izleyin. Postal API'leri, Ruby uygulamaları içinde e-posta mesajlarınızı izlemek için tam işlevsellik sağlar. Bir e-posta gönderdikten sonra, dönen message_id'yi kullanarak mevcut durumunu kontrol edebilirsiniz. Kampanyalarınızın etkinliğini ölçmek için e-posta açılmalarını ve tıklamaları izleyin. Aşağıdaki örnek, Ruby komutlarıyla E-posta Mesajı Teslim Durumunu nasıl kontrol edeceğinizi gösterir.
Ruby API'sı aracılığıyla E-posta Mesajı Teslim Durumu Nasıl Kontrol Edilir?
# Assume you've stored the message_id from the send operation
stored_message_id = '01G5XYZABCDEF1234567890'
# Get the message details from Postal
message_details = client.get_message(stored_message_id)
# Check the delivery status
puts "Message Status: #{message_details.status}"
# Inspect the raw message (as received by the destination server)
puts "Raw Message: #{message_details.raw_message}"
# Check if the email has been opened
if message_details.opens.any?
puts "The email was opened #{message_details.opens.count} time(s)."
end
Ekli Zengin HTML E-posta Gönderme
Modern e-postalar genellikle HTML biçimlendirmesi ve ekler gerektirir. Açık kaynaklı Postal e-posta API'si, yazılım geliştiricilerin Ruby uygulamalarından Zengin HTML E-posta mesajları oluşturup göndermesini kolaylaştırır. HTML desteklemeyen e-posta istemcileri için her zaman bir düz metin sürümü eklemek en iyi uygulamadır. Belgeleri, resimleri vb. eklemek için bir dizi File nesnesi aktarabilirsiniz. İşte, yazılım geliştiricilerin Ruby API kullanarak ekli HTML e-posta mesajları oluşturup gönderebileceğini gösteren çok faydalı bir kod örneği.
Ruby API'sı kullanarak Ekli Zengin HTML E-posta Nasıl Gönderilir?
client = Postal::Client.new
message = client.send_message(
from: 'orders@yourdomain.com',
to: 'customer@example.com',
subject: 'Your Order Confirmation #12345',
html_body: File.read('path/to/order_confirmation.html'), # Load HTML from a file
plain_body: 'Thank you for your order. Your order number is #12345.', # Fallback text
attachments: [
File.open('/path/to/invoice_12345.pdf') # Attach a file
]
)
puts "Rich email sent with attachment! ID: #{message.message_id}"