1. Продукти
  2.   електронна поща
  3.   Ruby
  4.   Postal
 
  

Отворен код Ruby API за проверка на проследяването на имейли и статуса на доставката

Postal е пълнофункционален имейл API и платформа за доставка, създадена да обработва както входящи, така и изходящи имейли за уебсайтове, приложения и проверка на проследяването на имейли и статуса на доставката.

Какво е Postal Library?

В днешния дигитален пейзаж ефективната имейл комуникация е по-важна от всякога. Независимо дали изпращате транзакционни имейли, маркетингови кампании или рутинни известия, надеждна и мащабируема платформа за доставка на имейли е от съществено значение. Въпреки че собственически услуги като SendGrid и Mailgun доминират пазара, мощна отворена алтернатива привлича вниманието: Postal. Gem‑ът Postal Ruby е поддържана от общността Ruby клиентска библиотека, която предоставя интерфейс за използване на платформата за доставка на имейли Postal. Тя позволява на Ruby (и Rails) приложения да се интегрират с Postal чрез неговото HTTP API. Тя е създадена с мисъл за Ruby разработчиците. Не просто обвива API крайните точки; предоставя обектно‑ориентиран интерфейс, който се чувства естествен в Ruby контекст.

Postal е пълна, напълно функционална, с отворен код платформа за доставка на имейли за уебсайтове и уеб сървъри. Мислете за него като за ваш собствен частен SendGrid или Mailgun, работещ на вашите сървъри. Това ви дава пълен контрол върху изпращането на имейли, данните и репутацията ви. Разработен с Ruby и подкрепен от стабилна гама технологии, Postal е проектиран за производителност, мащабируемост и лесна употреба. Той предоставя цялостен уеб интерфейс за управление на вашите пощенски сървъри, преглед на логове и проследяване на производителността, като същевременно предлага мощен API за безпроблемна интеграция с вашите приложения.

Previous Next

Започване с Postal

Най-лесният начин за инсталиране на библиотеката Postal е чрез RubyGems. Моля, използвайте следната команда за лесна инсталация.

Инсталирайте Postal чрез Rubygems

 gem install 'postal-ruby'

Изпращане на базов имейл чрез Ruby API

Отвореният код на Postal API включва пълна поддръжка за изпращане на имейл съобщения по различни начини. Ruby разработчиците могат да изпращат имейли по множество начини, отговарящи на различни нива на сложност. Simple Hash е перфектен за бързи изпращания с основни параметри. Обикновен текст и HTML могат да се използват за изпращане на мултичастични имейли. Той също така поддържа лесно прикачване на файлове към вашите имейл съобщения и др. Следният пример демонстрира най‑опростения начин за изпращане на имейл.

Как да изпратите прост имейл, използвайки Ruby API?

# 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 предоставя пълна функционалност за проследяване на вашите имейл съобщения в Ruby приложения. След изпращане на имейл можете да използвате върнатия message_id, за да проверите текущия му статус. Наблюдавайте отварянето на имейли и кликванията, за да оцените ефективността на вашите кампании. Следният пример показва как да проверите състоянието на доставката на имейл съобщения, използвайки Ruby команди.

Как да проверите статуса на доставката на имейл съобщение чрез Ruby API?

# 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 email API улеснява софтуерните разработчици да създават и изпращат богати HTML имейл съобщения от техните Ruby приложения. Добра практика е винаги да се включва версия в чист текст за имейл клиенти, които не поддържат HTML. Можете да предадете масив от обекти File, за да прикачите документи, изображения и др. Ето много полезен пример с код, който показва как софтуерните разработчици могат да създават и изпращат HTML имейл съобщения с прикачени файлове, използвайки Ruby API.

Как да изпратите богато 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}"
 Български