Notifications and weekly digest

Hands-free on Max needs to be observable. The agent never makes a change you cannot see. Two notification surfaces keep you informed: in-app notifications, and the weekly digest email on Pro and Max.

In-app notifications

Every campaign-level event the agent triggers inserts a row in the agent_notifications table. The dashboard notifications panel (bell icon in the top nav) renders them in reverse-chronological order. Click any notification to jump to the session in the Optimize tab.

Notifications carry:

  • Title (short summary: "Agent applied 3 changes to your HVAC campaign")
  • Body (detail with action labels + rollback window)
  • Optimization session ID (clickable deep-link to the session)
  • Campaign ID (clickable to the campaign detail page)
  • Explainability class (informational, strategic, etc.)
  • Read state (mark as read with one click)

When notifications fire

  • Max hands-free changes. One per session summarizing what changed.
  • Auto-rollback. One per rollback explaining what was reverted, why (which window failed), and what metrics moved.
  • Circuit breaker trip. One when a user-level breaker disables Max hands-free (3+ rollbacks in 30d).

A broken landing page URL or broken conversion tracking shows up as an issue on the campaign's Optimize tab, not as a notification.

Notifications never fire for changes you made yourself (clicking Approve on a recommendation). The action was visible in the UI when you clicked, so double-notifying is noise.

Weekly digest email (Pro and Max)

Every Sunday at 13:00 UTC, Pro and Max users get an email covering the past 7 days:

  • Changes made this week: what Max hands-free applied or what you approved, each with where its measurement stands so far.
  • Results for earlier changes: final verdicts that came in this week (T+7d or T+14d).
  • Rolled back: changes undone this week, either automatically because the numbers got worse or by you.
  • Waiting for you: on Pro, every recommendation not yet run; on Max, the ones hands-free never makes by itself, such as budget changes and pausing a campaign.
  • Roll-up: spend, conversions and CPA against last week.

Max's email leads with what was already done; Pro's leads with what is waiting. Nothing is sent in a week with nothing to report, and never twice within 6 days.

Each change that can still be undone links to its campaign's Optimize tab, where the Undo button reverts it. The link only opens the page. Email security scanners open the links in a message before you do, so a link that undid a change on its own could undo one nobody asked to undo.

Next steps
Auto-rollback→
How undo and automatic rollback work
Hands-free mode (Max)→
When the agent acts at all