API Ruby mã nguồn mở để Kiểm tra Theo dõi Email & Trạng Thái Giao Hàng

Bắt đầu với Postal

Cách dễ nhất để cài đặt thư viện Postal là thông qua RubyGems. Vui lòng sử dụng lệnh sau để cài đặt nhanh chóng.

 gem install 'postal-ruby'

Gửi email cơ bản qua Ruby API

Các API Postal mã nguồn mở đã bao gồm hỗ trợ đầy đủ cho việc gửi tin nhắn email theo nhiều cách khác nhau. Các nhà phát triển Ruby có thể gửi email theo nhiều cách, đáp ứng các mức độ phức tạp khác nhau. Simple Hash là lựa chọn hoàn hảo cho việc gửi nhanh với các tham số cơ bản. Văn bản thuần và HTML có thể được sử dụng để gửi email đa phần. Nó cũng hỗ trợ đính kèm tệp một cách dễ dàng vào tin nhắn email của bạn và các tính năng khác. Ví dụ sau đây minh họa cách đơn giản nhất để gửi một email.

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

Kiểm tra theo dõi email & trạng thái giao hàng

Theo dõi việc mở và nhấp vào email để đánh giá hiệu quả của các chiến dịch của bạn. Các API Postal đã cung cấp đầy đủ chức năng để theo dõi các tin nhắn email trong các ứng dụng Ruby. Sau khi gửi một email, bạn có thể sử dụng message_id trả về để kiểm tra trạng thái hiện tại của nó. Theo dõi việc mở và nhấp vào email để đánh giá hiệu quả của các chiến dịch của bạn. Ví dụ sau đây cho thấy cách kiểm tra Trạng thái Giao nhận Tin nhắn Email bằng các lệnh 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

Gửi email HTML phong phú kèm tệp đính kèm

Email hiện đại thường yêu cầu định dạng HTML và tệp đính kèm. API email mã nguồn mở Postal giúp các nhà phát triển phần mềm dễ dàng tạo và gửi các tin nhắn Email HTML phong phú từ các ứng dụng Ruby của họ. Thực hành tốt là luôn bao gồm một phiên bản văn bản thuần cho các khách hàng email không hỗ trợ HTML. Bạn có thể truyền một mảng các đối tượng File để đính kèm tài liệu, hình ảnh, v.v. Dưới đây là một mẫu mã rất hữu ích, cho thấy cách các nhà phát triển phần mềm có thể tạo và gửi các tin nhắn email HTML có đính kèm bằng API 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}"