1. Produkter
  2.   E-post
  3.   Ruby
  4.   Postal
 
  

Åpen kildekode Ruby-API for å sjekke e-postsporing og leveringsstatus

Postal er et fullverdig e-post-API og leveringsplattform designet for å håndtere både innkommende og utgående e-poster for nettsteder, apper og sjekke e-postsporing og leveringsstatus.

Hva er Postal-biblioteket?

I dagens digitale landskap er effektiv e-postkommunikasjon viktigere enn noen gang. Enten du sender transaksjonelle e-poster, markedsføringskampanjer eller rutinemessige varsler, er en pålitelig og skalerbar e-postleveringsplattform essensiell. Mens proprietære tjenester som SendGrid og Mailgun dominerer markedet, gjør et kraftig åpen kildekode-alternativ bølger: Postal. Postal Ruby-gemmen er et fellesskapsvedlikeholdt Ruby-klientbibliotek som gir et grensesnitt for å bruke Postal e-postleveringsplattform. Den lar Ruby (og Rails) applikasjoner integrere med Postal via dens HTTP API. Den er designet med Ruby-utviklere i tankene. Den pakker ikke bare API-endepunktene; den gir et objektorientert grensesnitt som føles naturlig i en Ruby-kontekst.

Postal er en komplett, fullt funksjonsrik, åpen kildekode e-postleveringsplattform for nettsteder og webservere. Tenk på den som din egen private SendGrid eller Mailgun, som kjører på dine egne servere. Dette gir deg full kontroll over e-postsending, data og omdømme. Utviklet med Ruby og støttet av et robust sett med teknologier, er Postal designet for ytelse, skalerbarhet og brukervennlighet. Den tilbyr et omfattende nettgrensesnitt for å administrere e-postserverne dine, vise logger og spore ytelse, samtidig som den gir et kraftig API for sømløs integrasjon med applikasjonene dine.

Previous Next

Kom i gang med Postal

Den enkleste måten å installere Postal-biblioteket på er via RubyGems. Vennligst bruk følgende kommando for enkel installasjon.

Installer Postal via Rubygems

 gem install 'postal-ruby'

Sende en enkel e-post via Ruby API

Den åpne kildekoden Postal API-er har inkludert full støtte for å sende e‑postmeldinger på ulike måter. Ruby‑utviklere kan sende e‑poster på flere måter, tilpasset ulike kompleksitetsnivåer. Simple Hash er perfekt for raske sendinger med grunnleggende parametere. Ren tekst og HTML kan brukes til å sende multipart‑e‑poster. Den støtter også å legge ved filer enkelt i e‑postmeldingene dine og så videre. Følgende eksempel demonstrerer den enkleste måten å sende en e‑post på.

Hvordan sende en enkel e-post ved hjelp av 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}"

Sjekk e-postsporing og leveringsstatus

Overvåk e‑poståpninger og klikk for å måle effektiviteten av kampanjene dine. Postal API‑ene har gitt full funksjonalitet for sporing av e‑postmeldingene dine i Ruby‑applikasjoner. Etter å ha sendt en e‑post, kan du bruke den returnerte message_id for å sjekke dens nåværende status. Overvåk e‑poståpninger og klikk for å måle effektiviteten av kampanjene dine. Følgende eksempel viser hvordan du sjekker leveringsstatus for e‑postmeldinger ved hjelp av Ruby‑kommandoer.

Hvordan sjekke leveringsstatus for e-postmeldinger via 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

Sende en rik HTML-e-post med vedlegg

Moderne e‑post krever ofte HTML‑formatering og vedlegg. Den åpne kildekode‑baserte Postal e‑post‑API gjør det enkelt for programvareutviklere å lage og sende rik HTML‑e‑post fra Ruby‑applikasjonene sine. Det er en god praksis å alltid inkludere en ren tekst‑versjon for e‑postklienter som ikke støtter HTML. Du kan sende inn et array av File‑objekter for å legge ved dokumenter, bilder osv. Her er et svært nyttig kodeeksempel som viser hvordan programvareutviklere kan lage og sende HTML‑e‑postmeldinger med vedlegg ved hjelp av Ruby‑API.

Hvordan sende en rik HTML-e-post med vedlegg via 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}"
 Norsk