1. Produktai
  2.   El. paštas
  3.   Ruby
  4.   Postal
 
  

Atviro kodo Ruby API el. laiškų sekimo ir pristatymo būsenos patikrinimui

Postal yra pilno funkcionalumo pašto API ir pristatymo platforma, sukurta tvarkyti tiek gaunamus, tiek siunčiamus el. laiškus svetainėms, programoms ir patikrinti el. laiškų sekimą bei pristatymo būseną.

Kas yra Postal biblioteka?

Šiandien skaitmeninėje aplinkoje efektyvi el. laiškų komunikacija yra svarbesnė nei bet kada. Nesvarbu, ar siunčiate transakcinius el. laiškus, rinkodaros kampanijas ar įprastus pranešimus, patikima ir mastelio galinti el. laiškų pristatymo platforma yra būtina. Nors tokios nuosavybinės paslaugos kaip SendGrid ir Mailgun dominuoja rinką, galinga atviro kodo alternatyva sulaukia dėmesio: Postal. Postal Ruby gem yra bendruomenės prižiūrima Ruby kliento biblioteka, suteikianti sąsają naudojimui su Postal el. laiškų pristatymo platforma. Ji leidžia Ruby (ir Rails) programoms integruotis su Postal per jo HTTP API. Ji sukurta Ruby kūrėjams. Ji ne tik supakuoja API galinius taškus; ji suteikia objektų orientuotą sąsają, kuri natūraliai jaučiasi Ruby kontekste.

Postal yra pilna, visapusiška, atviro kodo el. pašto pristatymo platforma svetainėms ir interneto serveriams. Pagalvokite apie ją kaip apie savo privatų SendGrid arba Mailgun, veikiantį jūsų serveriuose. Tai suteikia visišką kontrolę jūsų el. pašto siuntimui, duomenims ir reputacijai. Sukurta naudojant Ruby ir remiama patikimos technologijų bazės, Postal skirta našumui, mastelio didinimui ir paprastam naudojimui. Ji suteikia išsamų žiniatinklio sąsają, leidžiančią valdyti jūsų pašto serverius, peržiūrėti žurnalus ir stebėti našumą, tuo pačiu siūlydama galingą API sklandžiai integracijai su jūsų programomis.

Previous Next

Pradžia su Postal

Paprasčiausias būdas įdiegti Postal biblioteką – per RubyGems. Prašome naudoti šią komandą lengvam įdiegimui.

Įdiekite Postal per Rubygems

 gem install 'postal-ruby'

Paprasto el. laiško siuntimas per Ruby API

Atviro kodo Postal API įtraukė visapusišką palaikymą el. laiškų siuntimui įvairiais būdais. Ruby kūrėjai gali siųsti el. laiškus keliais būdais, atsižvelgdami į skirtingus sudėtingumo lygius. Simple Hash yra puikus greitam siuntimui su pagrindiniais parametrais. Tekstas be formatavimo ir HTML gali būti naudojami siųsti daugelio dalių el. laiškus. Tai taip pat palaiko lengvai prisegti failus prie jūsų el. laiškų ir pan. Toliau pateiktas pavyzdys demonstruoja paprasčiausią būdą išsiųsti el. laišką.

Kaip siųsti paprastą el. laišką naudojant 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}"

Patikrinkite el. laiškų sekimą ir pristatymo būseną

Stebėkite el. laiškų atidarymus ir paspaudimus, kad įvertintumėte savo kampanijų efektyvumą. Postal API suteikia visapusišką funkcionalumą el. laiškų sekimui Ruby programose. Išsiuntus el. laišką, galite naudoti grąžintąjį message_id, kad patikrintumėte jo dabartinę būseną. Stebėkite el. laiškų atidarymus ir paspaudimus, kad įvertintumėte savo kampanijų efektyvumą. Toliau pateiktas pavyzdys rodo, kaip patikrinti el. laiško pristatymo būseną naudojant Ruby komandas.

Kaip patikrinti el. laiško pristatymo būseną per 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

Raiškaus HTML el. laiško siuntimas su priedu

Šiuolaikiniai el. laiškai dažnai reikalauja HTML formatavimo ir priedų. Atviro kodo Postal el. laiškų API leidžia programinės įrangos kūrėjams lengvai kurti ir siųsti turtingus HTML el. laiškų pranešimus iš jų Ruby programų. Geriausia praktika – visada įtraukti paprasto teksto versiją el. laiškų klientams, kurie nepalaiko HTML. Galite perduoti File objektų masyvą, kad prisegtumėte dokumentus, paveikslėlius ir t.t. Čia pateikiamas labai naudingas kodo pavyzdys, rodantis, kaip programinės įrangos kūrėjai gali kurti ir siųsti HTML el. laiškų pranešimus su priedais naudojant Ruby API.

Kaip siųsti turtingą HTML el. laišką su priedu per 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}"
 Lietuvių