Chime.Channels.Email (Chime v0.1.0-dev)

Copy Markdown View Source

The :email channel: the notifier's Chime.Notifier.email/3, sent with the app's mailer (:mailer in Chime.Config).

The notifier gives the subject and the body. Chime gives the email:

  • its To:, the person's address and name (a person with no address is skipped, and the log says so);
  • its From:, the config's :email_from, unless the notifier set one;
  • unless the notification is required, the headers of one-click unsubscribe (RFC 8058), which Gmail and Yahoo ask of a sender of many emails: List-Unsubscribe with the address of the person's link, and List-Unsubscribe-Post. The same address is in the email's assigns as :unsubscribe_url, for a link in its footer, and the notifier's email can use Chime.unsubscribe_url/2. They need :mail_url and :secret_key_base in the config;
  • the link that opens the notification and reads it in the feed, from the feed's :url, in assigns as :link (Chime.link/2).

The mailer's id of the email ({:ok, %{id: id}}) is kept as the delivery's ref, to match the provider's events later.