Alerts & Notifications

When a test fails, Revenue Shield notifies you immediately through your configured channels. Every alert includes the information you need to diagnose the issue without logging into the dashboard first.

Notification Channels

Email

Email alerts are enabled by default and sent to the address associated with your Shopify account. You can add additional recipient addresses in Settings → Notifications.

Email alerts include:

• Test name and the specific step that failed
• Timestamp of the failure
• An inline screenshot of the failure state
• A link to the full video recording
• A link to the test run details in the dashboard

Slack

Connect Revenue Shield to your Slack workspace by providing an incoming webhook URL in Settings → Notifications → Slack. Alerts are posted to the channel associated with the webhook.

Slack alerts include:

• A formatted message with the test name and failure details
• A thumbnail screenshot attached to the message
• Direct links to the video recording and dashboard

Slack integration is available on all paid plans.

SMS

Add a phone number (with country code) in Settings → Notifications → SMS to receive text message alerts. SMS messages include a brief summary of the failure and a short link to the dashboard.

SMS is concise by design. For full evidence, follow the link to the dashboard or check the corresponding email or Slack alert.

Webhook

Growth and Agency plans can send JSON webhook alerts to your own automation endpoint. Configure the URL in Alerts → Webhook, then use the built-in Test button to verify the connection.

Webhook alerts are useful for routing incidents into internal systems or triggering merchant-owned automations like pausing ad campaigns when checkout breaks.

Supported webhook events:

• alert.test — Sent when you click the in-app Test button
• test.failed — Sent when a failure alert is triggered
• test.investigating — Sent when self-healing starts investigating
• test.healed — Sent when self-healing resolves the issue
• test.failed_to_heal — Sent when self-healing cannot resolve the issue

Alert Content

Every alert, regardless of channel, includes these data points:

• Test name — Which test failed (e.g., "Cart to Checkout")
• Failed step — The specific assertion or action that did not complete
• Timestamp — When the failure was detected, in your configured timezone
• Screenshot — A screenshot of the browser at the point of failure
• Video link — A direct URL to the full video recording of the test run
• Console errors — Any JavaScript errors captured during the run (included in email and dashboard)

Configuration Options

In Settings → Notifications, you can configure:

• Channels — Enable or disable each channel independently
• Recipients — Add multiple email addresses or phone numbers
• Slack webhook — Update the webhook URL or target channel at any time
• Webhook endpoint — Route JSON alerts into your incident or ad-pause workflow

Alert Behavior

Revenue Shield sends one alert per failed test per run. If three of your five tests fail in a single run, you receive three separate alerts, each with its own evidence. This ensures you can triage issues independently.

When a previously failing test passes again on a subsequent run, no automatic recovery notification is sent. You can verify resolution by checking the dashboard or triggering a manual run.

Webhook Payload Examples

Revenue Shield sends webhook requests as JSON POST requests with Content-Type: application/json and User-Agent: RevenueShield-Webhook/1.0.

Test payload:

{
  "source": "revenue_shield",
  "event": "alert.test",
  "status": "connected",
  "message": "Revenue Shield webhook alerts are working.",
  "sent_at": "2026-03-21T11:35:11Z"
}

Failure payload:

{
  "source": "revenue_shield",
  "event": "test.failed",
  "status": "failed",
  "shop_domain": "your-store.myshopify.com",
  "flow_name": "Cart to Checkout",
  "error_message": "Add to cart button missing",
  "screenshot_url": "https://...",
  "video_url": "https://...",
  "run_detail_url": "https://...",
  "sent_at": "2026-03-21T11:35:11Z"
}

Lifecycle payloads include the same top-level fields plus summary, classification, and reasoning when applicable.

Reducing Noise

Revenue Shield's self-healing system significantly reduces false alerts caused by benign UI changes. If a test fails due to a changed selector rather than a real checkout failure, the system corrects the test and re-runs it before alerting you. You are only notified about genuine failures.