How it works
paubox_rails registers :paubox as an ActionMailer delivery method. Your mailer classes are standard Rails mailers; the gem intercepts delivery and routes each message through the Paubox Email API, ensuring every email is encrypted and HIPAA compliant.
Set the delivery method
Globally (all environments)::letter_opener, :test, or another local delivery method.
Create a mailer
Mailers work exactly as documented in the Rails ActionMailer guide:app/views/patient_mailer/ as usual (appointment_reminder.html.erb, appointment_reminder.text.erb).
Deliver email
Per-message options
To allow delivery without TLS for a specific message, setallow_non_tls on the message that mail() returns. Passing it in delivery_method_options has no effect.
force_secure_notification is not applied to messages sent through ActionMailer. To use it, send a Paubox::Message with Paubox::Client#send_mail; see the Ruby SDK email client.
Attachments
Attach files using standard ActionMailer attachment helpers:Scheduled send
Schedule messages for future delivery usingPaubox::Client directly. The scheduled send methods are provided by the Paubox Ruby gem, which paubox_rails depends on.
scheduled_at must be an ISO 8601 UTC datetime string in the future and within 30 days.
Tracking IDs
After a synchronous send, the Paubox tracking ID is on the message:Paubox::Client.new.email_disposition(delivery.source_tracking_id). With deliver_later, the ID is set on the message inside the job, so the caller doesn’t see it.