1. Termékek
  2.   Email
  3.   Ruby
  4.   Postal
 
  

Nyílt forráskódú Ruby API az e-mail nyomon követésének és kézbesítési állapotának ellenőrzéséhez

A Postal egy teljes funkcionalitású e-mail API és kézbesítési platform, amelyet úgy terveztek, hogy kezelje a bejövő és kimenő e-maileket weboldalak, alkalmazások számára, valamint az e-mail nyomon követését és kézbesítési állapotát.

Mi a Postal Library?

A mai digitális környezetben a hatékony e-mail kommunikáció fontosabb, mint valaha. Akár tranzakciós e-maileket, marketingkampányokat vagy rutin értesítéseket küldünk, egy megbízható és skálázható e-mail kézbesítési platform elengedhetetlen. Míg a SendGrid és a Mailgunhez hasonló tulajdonosi szolgáltatások uralják a piacot, egy erőteljes nyílt forráskódú alternatíva hódít: a Postal. A Postal Ruby gem egy közösség által karbantartott Ruby klienskönyvtár, amely interfészt biztosít a Postal e-mail kézbesítési platform használatához. Lehetővé teszi, hogy Ruby (és Rails) alkalmazások integrálódjanak a Postal HTTP API-jával. Ruby fejlesztők számára készült. Nem csak az API végpontokat csomagolja be; objektum-orientált interfészt nyújt, amely természetesnek érződik egy Ruby környezetben.

Postal egy teljes, minden funkcióval ellátott, nyílt forráskódú e-mail kézbesítési platform weboldalak és webszerverek számára. Tekintse úgy, mint a saját privát SendGrid vagy Mailgun rendszerét, amely a saját szerverein fut. Ez teljes irányítást biztosít az e-mailek küldése, az adatok és a hírnév felett. Ruby-val fejlesztve és egy robusztus technológiai halmazt támogatva, a Postal a teljesítmény, a skálázhatóság és a könnyű használat érdekében lett tervezve. Átfogó webes felületet biztosít a levelezőszerverek kezeléséhez, a naplók megtekintéséhez és a teljesítmény nyomon követéséhez, miközben erőteljes API-t kínál az alkalmazások zökkenőmentes integrációjához.

Previous Next

Első lépések a Postal használatával

A Postal könyvtár legkönnyebb telepítési módja a RubyGems-en keresztül. Kérjük, használja a következő parancsot a egyszerű telepítéshez.

Postal telepítése Rubygems-en keresztül

 gem install 'postal-ruby'

Alap e-mail küldése Ruby API-n keresztül

Az nyílt forráskódú Postal API-k teljes támogatást nyújtanak az e‑mail üzenetek különféle módon történő küldéséhez. A Ruby fejlesztők többféleképpen küldhetnek e‑mailt, a különböző összetettségi szintekhez igazodva. A Simple Hash tökéletes a gyors küldéshez alapvető paraméterekkel. A sima szöveg és a HTML használható többrészes e‑mail küldésére. Emellett egyszerűen támogatja fájlok csatolását az e‑mail üzeneteidhez és így tovább. Az alábbi példa bemutatja a legegyszerűbb módot egy e‑mail küldésére.

Hogyan küldjünk egyszerű e-mailt a Ruby API-val?

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

E-mail nyomon követés és kézbesítési állapot ellenőrzése

Figyeld az e‑mail megnyitásait és kattintásait, hogy felmérd kampányaid hatékonyságát. A Postal API-k teljes funkcionalitást biztosítanak az e‑mail üzenetek nyomon követéséhez Ruby alkalmazásokon belül. Egy e‑mail elküldése után a visszakapott message_id-t használhatod annak aktuális állapotának ellenőrzésére. Figyeld az e‑mail megnyitásait és kattintásait, hogy felmérd kampányaid hatékonyságát. Az alábbi példa megmutatja, hogyan ellenőrizheted az e‑mail üzenet kézbesítési állapotát Ruby parancsokkal.

Hogyan ellenőrizhetjük az e-mail üzenet kézbesítési állapotát a Ruby API-n keresztül?

# 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

Gazdag HTML e-mail küldése melléklettel

A modern e-mailek gyakran igényelnek HTML formázást és mellékleteket. A nyílt forráskódú Postal e-mail API megkönnyíti a szoftverfejlesztők számára, hogy Ruby alkalmazásaikból gazdag HTML e-mail üzeneteket hozzanak létre és küldjenek. Legjobb gyakorlat, hogy mindig mellékeljenek egyszerű szöveges változatot azoknak az e-mail klienseknek, amelyek nem támogatják a HTML-t. Átadhat egy File objektumok tömbjét dokumentumok, képek stb. csatolásához. Itt egy nagyon hasznos kódrészlet, amely megmutatja, hogyan hozhatnak létre és küldhetnek HTML e-mail üzeneteket mellékletekkel a Ruby API használatával.

Hogyan küldjünk gazdag HTML e-mailt melléklettel a Ruby API-val?

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