1. Produse
  2.   E-mail
  3.   Ruby
  4.   Postal
 
  

API Ruby open source pentru verificarea urmăririi e-mailurilor și a stării livrării

Postal este un API de poștă complet și o platformă de livrare concepute pentru a gestiona atât e-mailurile primite, cât și cele trimise pentru site-uri web, aplicații și verificarea urmăririi e-mailurilor și a stării livrării.

Ce este Biblioteca Postal?

În peisajul digital de astăzi, comunicarea eficientă prin e-mail este mai crucială ca niciodată. Indiferent dacă trimiți e-mailuri tranzacționale, campanii de marketing sau notificări de rutină, o platformă de livrare a e-mailurilor fiabilă și scalabilă este esențială. În timp ce servicii proprietare precum SendGrid și Mailgun domină piața, o alternativă puternică open-source face valuri: Postal. Gem-ul Postal Ruby este o bibliotecă client Ruby menținută de comunitate care oferă o interfață pentru utilizarea platformei de livrare a e-mailurilor Postal. Permite aplicațiilor Ruby (și Rails) să se integreze cu Postal prin API-ul său HTTP. Este concepută având în vedere dezvoltatorii Ruby. Nu se limitează doar la învelirea punctelor finale ale API-ului; oferă o interfață orientată pe obiecte care se simte naturală în contextul Ruby.

Postal este o platformă completă, cu funcționalități complete, open-source de livrare a e-mailurilor pentru site-uri web și servere web. Gândește-te la ea ca la propriul tău SendGrid sau Mailgun privat, care rulează pe serverele tale. Aceasta îți oferă control total asupra trimiterii e-mailurilor, datelor și reputației. Dezvoltată cu Ruby și susținută de un set robust de tehnologii, Postal este concepută pentru performanță, scalabilitate și ușurință în utilizare. Oferă o interfață web cuprinzătoare pentru gestionarea serverelor de mail, vizualizarea jurnalelor și monitorizarea performanței, oferind în același timp un API puternic pentru integrare fără probleme cu aplicațiile tale.

Previous Next

Începerea cu Postal

Cea mai simplă modalitate de a instala biblioteca Postal este prin RubyGems. Vă rugăm să utilizați comanda următoare pentru o instalare facilă.

Instalați Postal prin Rubygems

 gem install 'postal-ruby'

Trimiterea unui e-mail de bază prin API Ruby

API-urile open source Postal au inclus suport complet pentru trimiterea mesajelor de e‑mail în diverse moduri. Dezvoltatorii Ruby pot trimite e‑mailuri în mai multe moduri, adaptându-se la diferite niveluri de complexitate. Simple Hash este perfect pentru trimitere rapidă cu parametri de bază. Textul simplu și HTML pot fi folosite pentru a trimite e‑mailuri multipart. De asemenea, suportă atașarea fișierelor fără efort la mesajele tale de e‑mail și altele. Exemplul următor demonstrează cea mai simplă modalitate de a trimite un e‑mail.

Cum să trimiți un e-mail simplu folosind API-ul Ruby?

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

Verificați urmărirea e-mailurilor și starea livrării

Monitorizați deschiderile și clicurile e‑mailurilor pentru a evalua eficacitatea campaniilor dumneavoastră. API-urile Postal oferă funcționalitate completă pentru urmărirea mesajelor de e‑mail în aplicațiile Ruby. După trimiterea unui e‑mail, puteți folosi message_id‑ul returnat pentru a verifica starea curentă. Monitorizați deschiderile și clicurile e‑mailurilor pentru a evalua eficacitatea campaniilor dumneavoastră. Exemplul următor arată cum să verificați starea livrării mesajului de e‑mail utilizând comenzi Ruby.

Cum să verifici starea livrării mesajului de e-mail prin API-ul 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

Trimiterea unui e-mail HTML bogat cu atașament

E‑mailurile moderne necesită adesea formatare HTML și atașamente. API‑ul de e‑mail open source Postal facilitează dezvoltatorilor software crearea și trimiterea de mesaje Rich HTML Email din aplicațiile lor Ruby. Este o bună practică să incluzi întotdeauna o versiune text simplă pentru clienții de e‑mail care nu suportă HTML. Poți transmite un tablou de obiecte File pentru a atașa documente, imagini etc. Iată un exemplu de cod foarte util care arată cum dezvoltatorii software pot crea și trimite mesaje de e‑mail HTML cu atașamente utilizând Ruby API.

Cum să trimiți un e-mail HTML bogat cu atașament prin API-ul 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}"
 Română