ओपन सोर्स रूबी एपीआई ईमेल ट्रैकिंग और डिलीवरी स्थिति जांचने के लिए

Postal के साथ शुरुआत

Postal लाइब्रेरी को स्थापित करने का सबसे आसान तरीका RubyGems के माध्यम से है। आसान स्थापना के लिए कृपया निम्नलिखित कमांड का उपयोग करें।

 gem install 'postal-ruby'

Ruby API के माध्यम से बुनियादी ईमेल भेजना

ओपन सोर्स Postal APIs ने विभिन्न तरीकों से ईमेल संदेश भेजने के लिए पूर्ण समर्थन शामिल किया है। रूबी डेवलपर्स कई तरीकों से ईमेल भेज सकते हैं, जो विभिन्न जटिलता स्तरों को पूरा करते हैं। 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 APIs ने रूबी एप्लिकेशनों के भीतर आपके ईमेल संदेशों को ट्रैक करने के लिए पूर्ण कार्यक्षमता प्रदान की है। ईमेल भेजने के बाद, आप लौटाए गए message_id का उपयोग करके उसकी वर्तमान स्थिति जांच सकते हैं। ईमेल ओपन और क्लिक को मॉनिटर करके अपने अभियानों की प्रभावशीलता को मापें। निम्नलिखित उदाहरण दिखाता है कि रूबी कमांड्स का उपयोग करके ईमेल संदेश डिलीवरी स्थिति कैसे जांचें।

# 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 ईमेल API सॉफ़्टवेयर डेवलपर्स के लिए अपने रूबी एप्लिकेशन से रिच HTML ईमेल संदेश बनाना और भेजना आसान बनाता है। यह एक सर्वोत्तम प्रथा है कि हमेशा एक प्लेन टेक्स्ट संस्करण शामिल किया जाए उन ईमेल क्लाइंट्स के लिए जो HTML का समर्थन नहीं करते। आप फ़ाइल ऑब्जेक्ट्स की एक एरे पास करके दस्तावेज़, छवियां आदि संलग्न कर सकते हैं। यहाँ एक बहुत उपयोगी कोड उदाहरण है जो दिखाता है कि सॉफ़्टवेयर डेवलपर्स रूबी API का उपयोग करके अटैचमेंट के साथ HTML ईमेल संदेश कैसे बना और भेज सकते हैं।

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