Promise Tracker - Email Alert Triggers (For Follow a Promise)

[RalphOwah]

Promise Tracker - Email Alert Triggers (For Follow a Promise)

User Story
As a user who has followed a specific promise,
I want to receive an automatic email alert whenever there’s a change in that promise’s status,
so that I can stay informed about its progress without having to visit the website manually.

Acceptance Criteria

1. Trigger Events

• The system automatically sends an email notification to all followers of a specific promise when its status changes (for example, from “Not Started” to “In Progress”, or from “In Progress” to “Completed”).
• The email alert should be triggered and sent within five minutes of the update being published.
• In a later phase (post-MVP), additional triggers can be added e.g for when a new petition related to that specific promise is created.

2. Email Content
   Each alert email must include:

• The subject line should clearly indicate the event, such as “Promise Tracker Update: 'The Promise Title"
• Email body
  Here is the latest update on about "The promise title"
  The promise updated status
  e.g. “Promise Update: Now In Progress”
  Click the link to for more details (re-direct link to view the specific promise on the Promise Tracker platform.)

3. Delivery Method

• The system uses Mailchimp to send these alert emails.
• When a status change event occurs, the Promise Tracker backend sends an API call or webhook to Mailchimp that includes:
• The promise ID, title, and new status.
• The list of follower email addresses subscribed to that specific promise.
• The target Mailchimp campaign or automation ID.
• Mailchimp handles the actual email delivery, unsubscribe management, and basic analytics (open rates, click rates, bounces).

4. Data Privacy

• Every email must contain a visible unsubscribe link to opt out from that specific promise.
• Unsubscribing from one promise does not affect other followed promises.