Webhooks & alerts

Reports shouldn't live in a dashboard you forget to open. Point a project's webhook at Slack (via a relay), GitHub, Linear, or your own endpoint, and every report pings you where the team already works.

Configure a webhook#

In the dashboard, open a project's settings and set a webhook URL plus a signing secret. The secret lets your receiver prove the request came from Testosaurus.

Delivery#

• Method: JSON POST to your URL.
• Signature: every delivery carries an x-testosaurus-signature header. Verify it with your signing secret before trusting the body.
• Payload: the report as JSON: title, severity, category, summary, and the tester's context.

{
  "title": "Checkout button does nothing on Safari",
  "severity": "high",
  "category": "bug",
  "summary": "Tapping Pay does nothing in Safari; works in Chrome.",
  "context": { "url": "/checkout", "browser": "Safari 18.2" }
}

High-severity email alerts#

For reports rated high or critical, Testosaurus can also send an email alert to the project's contact address. Enable or disable it per project in settings. Lower severities stay in the dashboard and the webhook.

Ideas#

• Slack incoming webhook: post every report to a #feedback channel.
• GitHub issue: open a draft issue per high-severity report, tagged with the category.
• Your own pipeline: filter, dedupe, and forward with your secret check first.