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

Open Source Ruby‑API til at kontrollere e‑mailsporing og leveringsstatus

Postal er en fuldt udstyret mail-API og leveringsplatform designet til at håndtere både indgående og udgående e-mails for hjemmesider, apps og kontrollere e‑mailsporing og leveringsstatus.

Hvad er Postal Library?

I dagens digitale landskab er effektiv e‑mailkommunikation vigtigere end nogensinde. Uanset om du sender transaktionsmails, marketingkampagner eller rutinemeddelelser, er en pålidelig og skalerbar e‑mailleveringsplatform afgørende. Mens proprietære tjenester som SendGrid og Mailgun dominerer markedet, får en kraftfuld open‑source‑alternativ opmærksomhed: Postal. Postal Ruby‑gemmen er et fællesskabsvedligeholdt Ruby‑klientbibliotek, der giver en grænseflade til at bruge Postal e‑mailleveringsplatform. Den gør det muligt for Ruby (og Rails) applikationer at integrere med Postal via dets HTTP API. Den er designet med Ruby‑udviklere i tankerne. Den pakker ikke kun API‑endpoints; den leverer en objektorienteret grænseflade, der føles naturlig i en Ruby‑kontekst.

Postal er en komplet, fuldt udstyret, open-source mailleveringsplatform til hjemmesider og webservere. Tænk på det som din egen private SendGrid eller Mailgun, der kører på dine egne servere. Dette giver dig fuld kontrol over din e-mailafsendelse, data og omdømme. Udviklet med Ruby og understøttet af et robust sæt teknologier, er Postal designet til ydeevne, skalerbarhed og brugervenlighed. Det leverer en omfattende webgrænseflade til at administrere dine mailservere, se logfiler og spore ydeevne, samtidig med at det tilbyder et kraftfuldt API til problemfri integration med dine applikationer.

Previous Next

Kom i gang med Postal

Den nemmeste måde at installere Postal-biblioteket på er via RubyGems. Brug venligst følgende kommando for nem installation.

Installer Postal via Rubygems

 gem install 'postal-ruby'

Send en grundlæggende e-mail via Ruby API

Den open source Postal API har inkluderet fuldstændig support til at sende e‑mailbeskeder på forskellige måder. Ruby‑udviklere kan sende e‑mails på flere måder, der imødekommer forskellige kompleksitetsniveauer. Simple Hash er perfekt til hurtige afsendelser med grundlæggende parametre. Ren tekst og HTML kan bruges til at sende multipart‑e‑mails. Den understøtter også at vedhæfte filer ubesværet til dine e‑mailbeskeder og så videre. Følgende eksempel demonstrerer den enkleste måde at sende en e‑mail på.

Hvordan sender man en simpel e‑mail ved hjælp af 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}"

Tjek e-mailsporing og leveringsstatus

Overvåg åbninger og klik på e-mails for at vurdere effektiviteten af dine kampagner. Postal API'erne har leveret fuld funktionalitet til at spore dine e‑mailbeskeder i Ruby‑applikationer. Efter at have sendt en e‑mail kan du bruge den returnerede message_id til at tjekke dens aktuelle status. Overvåg åbninger og klik på e-mails for at vurdere effektiviteten af dine kampagner. Følgende eksempel viser, hvordan du kan kontrollere leveringsstatus for e‑mailbeskeder ved hjælp af Ruby‑kommandoer.

Hvordan kontrollerer man e‑mail‑beskedens leveringsstatus 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

Send en rig HTML-e-mail med en vedhæftning

Moderne e-mails kræver ofte HTML-formatering og vedhæftede filer. Den open source Postal e-mail API gør det nemt for softwareudviklere at oprette og sende Rich HTML Email-beskeder fra deres Ruby-applikationer. Det er en god praksis altid at inkludere en ren tekstversion for e-mailklienter, der ikke understøtter HTML. Du kan videregive et array af File-objekter for at vedhæfte dokumenter, billeder osv. Her er et meget nyttigt kodeeksempel, der viser, hvordan softwareudviklere kan oprette og sende HTML-e-mailbeskeder med vedhæftede filer ved hjælp af Ruby API.

Hvordan sender man en rig HTML‑e‑mail med en vedhæftet fil 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}"
 Dansk