1. Produkte
  2.   Email
  3.   Ruby
  4.   Postal
 
  

Open-Source Ruby‑API zum Prüfen von E-Mail-Tracking & Lieferstatus

Postal ist eine voll ausgestattete Mail-API und Zustellplattform, die entwickelt wurde, um sowohl eingehende als auch ausgehende E-Mails für Websites, Apps und das Prüfen von E-Mail-Tracking & Lieferstatus zu verarbeiten.

Was ist die Postal-Bibliothek?

Im heutigen digitalen Umfeld ist eine effektive E‑Mail‑Kommunikation wichtiger denn je. Egal, ob Sie transaktionale E‑Mails, Marketingkampagnen oder routinemäßige Benachrichtigungen versenden, eine zuverlässige und skalierbare E‑Mail‑Zustellplattform ist unerlässlich. Während proprietäre Dienste wie SendGrid und Mailgun den Markt dominieren, sorgt eine leistungsstarke Open‑Source‑Alternative für Aufsehen: Postal. Das Postal‑Ruby‑Gem ist eine von der Community gepflegte Ruby‑Client‑Bibliothek, die eine Schnittstelle zur Nutzung der Postal‑E‑Mail‑Zustellplattform bereitstellt. Es ermöglicht Ruby‑ (und Rails‑) Anwendungen, sich über die HTTP‑API in Postal zu integrieren. Es ist speziell für Ruby‑Entwickler konzipiert. Es wickelt nicht nur die API‑Endpunkte ab; es bietet eine objektorientierte Schnittstelle, die sich im Ruby‑Kontext natürlich anfühlt.

Postal ist eine komplette, voll ausgestattete, Open-Source-E-Mail-Zustellplattform für Websites und Webserver. Betrachten Sie sie als Ihr eigenes privates SendGrid oder Mailgun, das auf Ihren eigenen Servern läuft. Das gibt Ihnen die vollständige Kontrolle über das Senden von E-Mails, Daten und Reputation. Entwickelt mit Ruby und unterstützt von einem robusten Technologiestack, ist Postal für Leistung, Skalierbarkeit und Benutzerfreundlichkeit konzipiert. Es bietet eine umfassende Weboberfläche zur Verwaltung Ihrer Mail-Server, zur Ansicht von Protokollen und zur Leistungsüberwachung, und gleichzeitig eine leistungsstarke API für nahtlose Integration in Ihre Anwendungen.

Previous Next

Erste Schritte mit Postal

Der einfachste Weg, die Postal-Bibliothek zu installieren, ist über RubyGems. Bitte verwenden Sie den folgenden Befehl für eine einfache Installation.

Postal über Rubygems installieren

 gem install 'postal-ruby'

Senden einer einfachen E‑Mail über die Ruby‑API

Die Open-Source-Postal-APIs enthalten vollständige Unterstützung für das Senden von E-Mail-Nachrichten auf verschiedene Arten. Ruby-Entwickler können E-Mails auf mehrere Arten senden, die unterschiedlichen Komplexitätsstufen gerecht werden. Simple Hash ist perfekt für schnelle Sendungen mit grundlegenden Parametern. Klartext und HTML können verwendet werden, um mehrteilige E-Mails zu senden. Es unterstützt auch das mühelose Anhängen von Dateien an Ihre E-Mail-Nachrichten und so weiter. Das folgende Beispiel zeigt den einfachsten Weg, eine E-Mail zu senden.

Wie man eine einfache E‑Mail mit der Ruby‑API sendet?

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

E‑Mail-Tracking und Lieferstatus prüfen

Überwachen Sie das Öffnen von E-Mails und Klicks, um die Wirksamkeit Ihrer Kampagnen zu beurteilen. Die Postal-APIs bieten vollständige Funktionalität zum Verfolgen Ihrer E-Mail-Nachrichten in Ruby-Anwendungen. Nach dem Senden einer E-Mail können Sie die zurückgegebene message_id verwenden, um ihren aktuellen Status zu prüfen. Überwachen Sie das Öffnen von E-Mails und Klicks, um die Wirksamkeit Ihrer Kampagnen zu beurteilen. Das folgende Beispiel zeigt, wie Sie den Lieferstatus von E-Mail-Nachrichten mit Ruby-Befehlen überprüfen.

Wie man den Zustellstatus von E‑Mail‑Nachrichten über die Ruby‑API prüft?

# 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

Senden einer umfangreichen HTML‑E‑Mail mit Anhang

Moderne E-Mails erfordern häufig HTML-Formatierung und Anhänge. Die Open-Source-Postal-E-Mail-API erleichtert Softwareentwicklern das Erstellen und Senden von Rich-HTML-E-Mail-Nachrichten aus ihren Ruby-Anwendungen. Es ist eine bewährte Praxis, immer eine Nur-Text-Version für E-Mail-Clients bereitzustellen, die HTML nicht unterstützen. Sie können ein Array von File-Objekten übergeben, um Dokumente, Bilder usw. anzuhängen. Hier ist ein sehr nützliches Codebeispiel, das zeigt, wie Softwareentwickler HTML-E-Mail-Nachrichten mit Anhängen mithilfe der Ruby-API erstellen und senden können.

Wie man eine formatierte HTML‑E‑Mail mit Anhang über die Ruby‑API sendet?

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