1. Məhsullar
  2.   E-poçt
  3.   Ruby
  4.   Postal
 
  

E-poçt izləməsini və çatdırılma statusunu yoxlamaq üçün Açıq Mənbəli Ruby API

Postal, veb saytlar, tətbiqlər üçün həm daxil, həm də çıxan e-poçtları idarə etmək və e-poçt izləməsini və çatdırılma statusunu yoxlamaq üçün hazırlanmış tam funksional Poçt API və Çatdırılma Platformasıdır.

Postal Kitabxanası nədir?

Bu günün rəqəmsal mühitində effektiv e‑poçt ünsiyyəti əvvəldən daha vacibdir. İstər tranzaksiya e‑poçtları, marketinq kampaniyaları, istərsə də gündəlik bildirişlər göndərirsiniz, etibarlı və miqyaslana bilən e‑poçt çatdırma platforması vacibdir. SendGrid və Mailgun kimi kommersiya xidmətləri bazarı hakim olsa da, güclü açıq mənbə alternativi diqqət çəkir: Postal. Postal Ruby gem-i icma tərəfindən dəstəklənən Ruby müştəri kitabxanasıdır və Postal e‑poçt çatdırma platformasından istifadə üçün interfeys təqdim edir. Bu, Ruby (və Rails) tətbiqlərinə Postal-ı onun HTTP API‑si vasitəsilə inteqrasiya etməyə imkan verir. O, Ruby proqramçıları nəzərə alınaraq hazırlanıb. API son nöqtələrini sadəcə bükməkdən əlavə, Ruby kontekstində təbii hiss olunan obyekt‑oriyentasiya interfeysi təqdim edir.

Postal, veb saytlar və veb serverlər üçün tam, tam funksional, açıq mənbəli poçt çatdırma platformasıdır. Bunu öz serverlərinizdə işləyən özəl SendGrid və ya Mailgun kimi düşünün. Bu, e‑poçt göndərmə, məlumat və nüfuz üzərində tam nəzarət təmin edir. Ruby ilə hazırlanmış və güclü texnologiyalar dəstəyi ilə Postal, performans, genişlənə bilənlik və istifadənin asanlığı üçün dizayn edilmişdir. O, poçt serverlərinizi idarə etmək, qeydləri görmək və performansı izləmək üçün geniş veb interfeys təqdim edir, həmçinin tətbiqlərinizlə problemsiz inteqrasiya üçün güclü API təklif edir.

Previous Next

Postal ilə Başlamaq

Postal kitabxanasını quraşdırmağın ən asan yolu RubyGems vasitəsilədir. Asan quraşdırma üçün aşağıdakı əmri istifadə edin.

Postalı Rubygems vasitəsilə quraşdırın

 gem install 'postal-ruby'

Ruby API vasitəsilə Sadə E-poçt Göndərmək

Açıq mənbəli Postal API-ləri e-poçt mesajlarını müxtəlif yollarla göndərmək üçün tam dəstək əlavə edib. Ruby proqramçıları e-poçtları bir neçə şəkildə göndərə bilərlər, müxtəlif mürəkkəblik səviyyələrinə uyğun olaraq. Simple Hash əsas parametrlərlə sürətli göndərişlər üçün mükəmməldir. Plain text və HTML istifadə edərək çoxhissəli e-poçtlar göndərilə bilər. Həmçinin faylları asanlıqla e-poçt mesajlarınıza əlavə etməyə dəstək verir və s. Aşağıdakı nümunə e-poçt göndərməyin ən sadə yolunu göstərir.

Ruby API istifadə edərək Sadə E-poçt necə göndərilir?

# 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-poçt İzləməsini və Çatdırılma Statusunu Yoxlayın

E-poçtların açılmasını və kliklənməsini izləyərək kampaniyalarınızın effektivliyini ölçün. Postal API-ləri Ruby tətbiqlərində e-poçt mesajlarınızı izləmək üçün tam funksionallıq təmin edir. E-poçt göndərdikdən sonra, geri qaytarılan message_id-ni istifadə edərək onun cari statusunu yoxlaya bilərsiniz. E-poçtların açılmasını və kliklənməsini izləyərək kampaniyalarınızın effektivliyini ölçün. Aşağıdakı nümunə Ruby əmrləri ilə E-poçt Mesajının Çatdırılma Statusunu necə yoxlamağı göstərir.

Ruby API vasitəsilə E-poçt Mesajının Çatdırılma Statusunu necə yoxlamaq olar?

# 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

Qoşma ilə Zəngin HTML E-poçt Göndərmək

Müasir e-poçtlar tez-tez HTML formatlaşdırması və əlavə fayllar tələb edir. Açıq mənbəli Postal e-poçt API‑si proqramçılara Ruby tətbiqlərindən zəngin HTML e-poçt mesajları yaratmaq və göndərmək üçün asanlıq təmin edir. HTML‑i dəstəkləməyən e-poçt müştəriləri üçün həmişə sadə mətn versiyasını daxil etmək ən yaxşı təcrübədir. Sənədləri, şəkilləri və s. əlavə etmək üçün File obyektlərinin massivini ötürə bilərsiniz. Aşağıda Ruby API‑dən istifadə edərək proqramçılar üçün əlavə fayllı HTML e-poçt mesajları yaratmaq və göndərmək nümunəsi göstərilir.

Ruby API vasitəsilə Əlavəli Zəngin HTML E-poçt necə göndərilir?

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}"
 Azəri