واجهة برمجة تطبيقات روبي مفتوحة المصدر للتحقق من تتبع البريد الإلكتروني وحالة التسليم

البدء مع Postal

أسهل طريقة لتثبيت مكتبة Postal هي عبر RubyGems. يرجى استخدام الأمر التالي للتثبيت السهل.

 gem install 'postal-ruby'

إرسال بريد إلكتروني أساسي عبر Ruby API

توفر واجهات برمجة التطبيقات المفتوحة المصدر Postal دعمًا كاملاً لإرسال رسائل البريد الإلكتروني بطرق مختلفة. يمكن لمطوري Ruby إرسال رسائل البريد الإلكتروني بطرق متعددة، لتلبية مستويات مختلفة من التعقيد. Simple Hash مثالي للإرسال السريع مع المعلمات الأساسية. يمكن استخدام النص العادي وHTML لإرسال رسائل بريد إلكتروني متعددة الأجزاء. كما يدعم إرفاق الملفات بسهولة إلى رسائل البريد الإلكتروني الخاصة بك وما إلى ذلك. يوضح المثال التالي أبسط طريقة لإرسال بريد إلكتروني.

# 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}"

تحقق من تتبع البريد الإلكتروني وحالة التسليم

راقب فتحات البريد الإلكتروني والنقرات لتقييم فعالية حملاتك. توفر واجهات برمجة التطبيقات Postal وظائف كاملة لتتبع رسائل البريد الإلكتروني الخاصة بك داخل تطبيقات Ruby. بعد إرسال بريد إلكتروني، يمكنك استخدام message_id المعاد للتحقق من حالته الحالية. راقب فتحات البريد الإلكتروني والنقرات لتقييم فعالية حملاتك. يوضح المثال التالي كيفية التحقق من حالة تسليم رسالة البريد الإلكتروني باستخدام أوامر Ruby.

# 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

إرسال بريد إلكتروني غني بتنسيق HTML مع مرفق

غالبًا ما تتطلب رسائل البريد الإلكتروني الحديثة تنسيق HTML ومرفقات. تجعل واجهة برمجة تطبيقات البريد الإلكتروني المفتوحة المصدر Postal من السهل على مطوري البرمجيات إنشاء وإرسال رسائل بريد إلكتروني غنية بتنسيق HTML من تطبيقاتهم المكتوبة بلغة Ruby. من الممارسات الجيدة دائمًا تضمين نسخة نصية عادية لعملاء البريد الذين لا يدعمون HTML. يمكنك تمرير مصفوفة من كائنات File لإرفاق المستندات والصور، إلخ. إليك مثالًا مفيدًا جدًا يوضح كيف يمكن لمطوري البرمجيات إنشاء وإرسال رسائل بريد إلكتروني HTML مع مرفقات باستخدام واجهة برمجة تطبيقات Ruby.

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}"