ইমেইল ট্র্যাকিং এবং ডেলিভারি স্ট্যাটাস পরীক্ষা করার জন্য ওপেন সোর্স রুবি এপিআই

পোস্টাল দিয়ে শুরু করা

Postal লাইব্রেরি ইনস্টল করার সবচেয়ে সহজ উপায় হল RubyGems এর মাধ্যমে। সহজ ইনস্টলেশনের জন্য দয়া করে নিম্নলিখিত কমান্ডটি ব্যবহার করুন।

 gem install 'postal-ruby'

রুবি API ব্যবহার করে একটি মৌলিক ইমেল পাঠানো

ওপেন সোর্স Postal API গুলো ইমেইল বার্তা বিভিন্ন পদ্ধতিতে পাঠানোর জন্য সম্পূর্ণ সমর্থন অন্তর্ভুক্ত করেছে। রুবি ডেভেলপাররা বিভিন্ন জটিলতার স্তরের জন্য উপযোগীভাবে একাধিক পদ্ধতিতে ইমেইল পাঠাতে পারেন। 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 API গুলো রুবি অ্যাপ্লিকেশনের মধ্যে আপনার ইমেইল বার্তা ট্র্যাক করার জন্য সম্পূর্ণ কার্যকারিতা প্রদান করে। ইমেইল পাঠানোর পরে, আপনি ফেরত প্রাপ্ত 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}"