Open Source Ruby API เพื่อตรวจสอบการติดตามอีเมลและสถานะการจัดส่ง

เริ่มต้นใช้งาน Postal

วิธีที่ง่ายที่สุดในการติดตั้งไลบรารี Postal คือผ่าน RubyGems. โปรดใช้คำสั่งต่อไปนี้สำหรับการติดตั้งอย่างง่าย.

 gem install 'postal-ruby'

ส่งอีเมลพื้นฐานผ่าน Ruby API

Postal APIs แบบโอเพนซอร์สได้รวมการสนับสนุนเต็มรูปแบบสำหรับการส่งข้อความอีเมลในหลายวิธี นักพัฒนา 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 APIs มีฟังก์ชันการทำงานครบถ้วนสำหรับการติดตามข้อความอีเมลของคุณภายในแอปพลิเคชัน 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 และไฟล์แนบ API อีเมล Postal แบบโอเพนซอร์สทำให้ผู้พัฒนาซอฟต์แวร์สร้างและส่งข้อความอีเมล HTML ที่มีรูปแบบ Rich จากแอปพลิเคชัน Ruby ของพวกเขาได้อย่างง่ายดาย การปฏิบัติที่ดีที่สุดคือควรรวมเวอร์ชันข้อความธรรมดาไว้เสมอสำหรับไคลเอนต์อีเมลที่ไม่รองรับ HTML คุณสามารถส่งอาร์เรย์ของอ็อบเจ็กต์ File เพื่อแนบเอกสาร รูปภาพ ฯลฯ นี่คือตัวอย่างโค้ดที่มีประโยชน์มากซึ่งแสดงวิธีที่ผู้พัฒนาซอฟต์แวร์สามารถสร้างและส่งข้อความอีเมล HTML พร้อมไฟล์แนบโดยใช้ Ruby API.

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