Alerts: Slack and signed webhooks
Integrations & Data Sources
#alerts#slack#webhook#hmac#signature#notifications
Get notified about buyer requests, telemetry gaps, audit-chain failures, low coverage and new models.
How It Works Under the Hood
- •Disclosure requests are sent immediately. Other checks run on a daily schedule: no telemetry for 24 hours, audit chain break, coverage below 95%, and a new model in production.
- •Each event is delivered once per destination; failed deliveries are retried on the next run.
- •Webhooks receive JSON with X-SHDW-Event and X-SHDW-Signature: sha256=<hex HMAC-SHA256 of the raw body>, keyed with the destination's signing secret shown in the dashboard.
- •Destination URLs must be public HTTPS hosts; Slack destinations must be hooks.slack.com incoming webhooks.
How to Use It Step-by-Step
- 1Open Integrations → Alerts → Add destination, choose Slack or webhook and the events.
- 2Click Test to send a sample alert.
- 3For webhooks, verify the signature before trusting the payload.
Verify a webhook (Node.js)
import { createHmac, timingSafeEqual } from "node:crypto";
export function verifyShdwSignature(rawBody: string, header: string, secret: string) {
const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
return header.length === expected.length &&
timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}Related guides
- Python SDK, OpenTelemetry and LiteLLM
- Data completeness: reconcile with provider billing
- Developer console: pipeline health, drop rates and live events
- Carbon accounting export and cost/carbon savings
- Deployment and model coverage: clouds, private hosting and self-hosted models
- Partner accounts: SHDWsdk for every customer of your platform
- Interactive CLI Setup Wizard (npx @shdwsdk/sdk init / npx shdw-init)
- Non-Blocking Client Wrapper (shdw.wrapClient) & Fail-Silent Guarantee
