1. Προϊόντα
  2.   ΗΛΕΚΤΡΟΝΙΚΗ ΔΙΕΥΘΥΝΣΗ
  3.   Ruby
  4.   Postal
 
  

Ανοιχτού Κώδικα Ruby API για Έλεγχο Παρακολούθησης Email & Κατάστασης Παράδοσης

Το Postal είναι Πλήρης API Αλληλογραφίας και Πλατφόρμα Παράδοσης Σχεδιασμένη για τη Διαχείριση Εισερχόμενων και Εξερχόμενων Emails για Ιστοσελίδες, Εφαρμογές και Έλεγχο Παρακολούθησης Email & Κατάστασης Παράδοσης.

Τι είναι η βιβλιοθήκη Postal;

Στο σημερινό ψηφιακό τοπίο, η αποτελεσματική επικοινωνία μέσω email είναι πιο κρίσιμη από ποτέ. Είτε στέλνετε συναλλακτικά email, καμπάνιες μάρκετινγκ ή καθημερινές ειδοποιήσεις, μια αξιόπιστη και κλιμακώσιμη πλατφόρμα παράδοσης email είναι απαραίτητη. Ενώ ιδιόκτητες υπηρεσίες όπως το SendGrid και το Mailgun κυριαρχούν στην αγορά, μια ισχυρή ανοιχτού κώδικα εναλλακτική κερδίζει έδαφος: το Postal. Το Postal Ruby gem είναι μια βιβλιοθήκη πελάτη Ruby που συντηρείται από την κοινότητα και παρέχει διεπαφή για τη χρήση της πλατφόρμας παράδοσης email Postal. Επιτρέπει στις εφαρμογές Ruby (και Rails) να ενσωματωθούν με το Postal μέσω του HTTP API του. Έχει σχεδιαστεί με τους προγραμματιστές Ruby στο μυαλό. Δεν περιορίζεται μόνο στην περιτύλιξη των τελικών σημείων του API· παρέχει μια αντικειμενοστραφή διεπαφή που αισθάνεται φυσική μέσα σε ένα περιβάλλον Ruby.

Το Postal είναι μια πλήρης, πλήρως εξοπλισμένη, ανοιχτού κώδικα πλατφόρμα παράδοσης αλληλογραφίας για ιστοσελίδες και διακομιστές web. Σκεφτείτε το ως το δικό σας ιδιωτικό SendGrid ή Mailgun, που λειτουργεί στους δικούς σας διακομιστές. Αυτό σας δίνει πλήρη έλεγχο στην αποστολή email, τα δεδομένα και τη φήμη σας. Αναπτυγμένο με Ruby και υποστηριζόμενο από ένα ισχυρό σύνολο τεχνολογιών, το Postal σχεδιάστηκε για απόδοση, κλιμακωσιμότητα και ευκολία χρήσης. Παρέχει ένα ολοκληρωμένο web interface για τη διαχείριση των διακομιστών αλληλογραφίας, την προβολή των καταγραφών και την παρακολούθηση της απόδοσης, ενώ προσφέρει ένα ισχυρό API για απρόσκοπτη ενσωμάτωση με τις εφαρμογές σας.

Previous Next

Ξεκινώντας με το Postal

Ο πιο εύκολος τρόπος για να εγκαταστήσετε τη βιβλιοθήκη Postal είναι μέσω του RubyGems. Παρακαλώ χρησιμοποιήστε την παρακάτω εντολή για εύκολη εγκατάσταση.

Εγκατάσταση Postal μέσω Rubygems

 gem install 'postal-ruby'

Αποστολή ενός βασικού email μέσω Ruby API

Οι ανοιχτού κώδικα Postal APIs έχουν συμπεριλάβει πλήρη υποστήριξη για αποστολή μηνυμάτων email με διάφορους τρόπους. Οι προγραμματιστές Ruby μπορούν να στέλνουν email με πολλούς τρόπους, προσαρμοσμένοι σε διαφορετικά επίπεδα πολυπλοκότητας. Το Simple Hash είναι ιδανικό για γρήγορες αποστολές με βασικές παραμέτρους. Το απλό κείμενο και το HTML μπορούν να χρησιμοποιηθούν για αποστολή multipart email. Υποστηρίζει επίσης την προσθήκη συνημμένων αρχείων χωρίς κόπο στα μηνύματα email σας κ.λπ. Το παρακάτω παράδειγμα δείχνει τον πιο απλό τρόπο αποστολής ενός email.

Πώς να στείλετε ένα απλό email χρησιμοποιώντας το 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}"

Έλεγχος παρακολούθησης email & κατάστασης παράδοσης

Παρακολουθήστε το άνοιγμα και τα κλικ των email για να αξιολογήσετε την αποτελεσματικότητα των εκστρατειών σας. Τα Postal APIs παρέχουν πλήρη λειτουργικότητα για την παρακολούθηση των email μηνυμάτων σας μέσα σε εφαρμογές Ruby. Μετά την αποστολή ενός email, μπορείτε να χρησιμοποιήσετε το επιστρεφόμενο message_id για να ελέγξετε την τρέχουσα κατάσταση του. Παρακολουθήστε το άνοιγμα και τα κλικ των email για να αξιολογήσετε την αποτελεσματικότητα των εκστρατειών σας. Το παρακάτω παράδειγμα δείχνει πώς να ελέγξετε την κατάσταση παράδοσης του μηνύματος email χρησιμοποιώντας εντολές Ruby.

Πώς να ελέγξετε την κατάσταση παράδοσης του μηνύματος email μέσω του 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

Αποστολή πλούσιου email HTML με συνημμένο

Τα σύγχρονα email συχνά απαιτούν μορφοποίηση HTML και συνημμένα. Το ανοιχτού κώδικα Postal email API καθιστά εύκολο για τους προγραμματιστές λογισμικού να δημιουργούν και να στέλνουν πλούσια μηνύματα HTML Email από τις εφαρμογές Ruby τους. Είναι καλή πρακτική να περιλαμβάνεται πάντα μια έκδοση απλού κειμένου για πελάτες email που δεν υποστηρίζουν HTML. Μπορείτε να περάσετε έναν πίνακα αντικειμένων File για να επισυνάψετε έγγραφα, εικόνες κ.λπ. Ακολουθεί ένα πολύ χρήσιμο παράδειγμα κώδικα που δείχνει πώς οι προγραμματιστές λογισμικού μπορούν να δημιουργήσουν και να στείλουν μηνύματα HTML email με συνημμένα χρησιμοποιώντας το Ruby API.

Πώς να στείλετε ένα πλούσιο email HTML με συνημμένο μέσω του 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}"
 Ελληνικά