Avoimen lähdekoodin Ruby-API sähköpostin seurannan ja toimitustilan tarkistamiseen

Postal on täysimittainen postin API- ja toimitusalusta, joka on suunniteltu käsittelemään sekä saapuvia että lähteviä sähköposteja verkkosivustoille, sovelluksille ja tarkistamaan sähköpostin seuranta- ja toimitustilan.

Mikä on Postal-kirjasto?

Nykyisessä digitaalisessa maisemassa tehokas sähköpostiviestintä on tärkeämpää kuin koskaan. Olipa kyseessä transaktio‑sähköpostit, markkinointikampanjat tai rutiininomaiset ilmoitukset, luotettava ja skaalautuva sähköpostin toimitusalusta on välttämätön. Vaikka omistettuja palveluita kuten SendGrid ja Mailgun hallitsevat markkinoita, voimakas avoimen lähdekoodin vaihtoehto tekee vaikutuksen: Postal. Postal Ruby -gem on yhteisön ylläpitämä Ruby‑asiakasohjelmakirjasto, joka tarjoaa käyttöliittymän Postal‑sähköpostin toimitusalustan käyttämiseen. Se mahdollistaa Ruby‑ (ja Rails‑) sovellusten integroinnin Postalin HTTP‑API:n kautta. Se on suunniteltu Ruby‑kehittäjille mielessä. Se ei pelkästään kääri API‑päätepisteitä; se tarjoaa oliopohjaisen käyttöliittymän, joka tuntuu luonnolliselta Ruby‑kontekstissa.

Postal on täydellinen, monipuolinen, avoimen lähdekoodin postin toimitusalusta verkkosivustoille ja web-palvelimille. Ajattele sitä omana yksityisenä SendGrid- tai Mailgun-palvelunasi, joka toimii omilla palvelimillasi. Tämä antaa sinulle täyden hallinnan sähköpostin lähettämiseen, tietoihin ja maineeseen. Rubyllä kehitetty ja vahvan teknologiapaketin tukema Postal on suunniteltu suorituskykyyn, skaalautuvuuteen ja helppokäyttöisyyteen. Se tarjoaa kattavan web-käyttöliittymän postipalvelimiesi hallintaan, lokien tarkasteluun ja suorituskyvyn seurantaan, samalla kun se tarjoaa tehokkaan API:n saumattomaan integraatioon sovelluksiesi kanssa.

Previous Next

Postalin aloitus

Helpoin tapa asentaa Postal-kirjasto on RubyGemsin kautta. Käytä seuraavaa komentoa helppoa asennusta varten.

Asenna Postal Rubygemsin kautta

 gem install 'postal-ruby'

Perusviestin lähettäminen Ruby API:n avulla

Avoimen lähdekoodin Postal API:t sisältävät täyden tuen sähköpostiviestien lähettämiseen eri tavoin. Ruby-kehittäjät voivat lähettää sähköposteja monin tavoin, vastaten erilaisiin monimutkaisuustasoihin. Simple Hash on täydellinen nopeisiin lähetyksiin perusparametreilla. Pelkkää tekstiä ja HTML:ää voidaan käyttää moniosaisiin sähköposteihin. Se tukee myös tiedostojen liittämistä vaivattomasti sähköpostiviesteihisi ja niin edelleen. Seuraava esimerkki näyttää yksinkertaisimman tavan lähettää sähköposti.

Kuinka lähettää yksinkertainen sähköposti Ruby API:ta käyttäen?

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

Tarkista sähköpostin seuranta ja toimitustila

Seuraa sähköpostien avauksia ja klikkauksia arvioidaksesi kampanjoidesi tehokkuutta. Postal API:t tarjoavat täyden toiminnallisuuden sähköpostiviestien seurannalle Ruby-sovelluksissa. Sähköpostin lähettämisen jälkeen voit käyttää palautettua message_id:tä tarkistaaksesi sen nykyisen tilan. Seuraa sähköpostien avauksia ja klikkauksia arvioidaksesi kampanjoidesi tehokkuutta. Seuraava esimerkki näyttää, miten tarkistaa sähköpostiviestin toimitustila Ruby-komentoja käyttäen.

Kuinka tarkistaa sähköpostiviestin toimitustila Ruby API:n kautta?

# 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

Rikkaan HTML-sähköpostin lähettäminen liitteellä

Modernit sähköpostit vaativat usein HTML-muotoilua ja liitteitä. Avoimen lähdekoodin Postal-sähköpostirajapinta tekee ohjelmistokehittäjille helppoa luoda ja lähettää rikastettuja HTML-sähköpostiviestejä Ruby-sovelluksistaan. On parasta käytäntö aina sisällyttää tavallinen tekstiversio sähköpostiasiakkaille, jotka eivät tue HTML:ää. Voit antaa taulukon File-objekteja liittääksesi asiakirjoja, kuvia jne. Tässä on erittäin hyödyllinen koodiesimerkki, joka näyttää, miten ohjelmistokehittäjät voivat luoda ja lähettää HTML-sähköpostiviestejä liitteineen Ruby-API:n avulla.

Kuinka lähettää rikas HTML-sähköposti liitteellä Ruby API:n avulla?

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