Slack & Discord Webhooks

TealTiger can send real-time alerts when governance events occur — policy violations, budget thresholds, high-risk decisions, or circuit breaker trips. Route them to Slack, Discord, Teams, or any webhook endpoint.

Quick Start

import { TealEngine } from 'tealtiger';

const engine = new TealEngine({
  policies: { /* ... */ },
  webhooks: {
    slack: {
      url: process.env.SLACK_WEBHOOK_URL,
      events: ['decision.denied', 'budget.threshold', 'circuit.open'],
    }
  }
});

from tealtiger import TealEngine

engine = TealEngine({
    "policies": {},
    "webhooks": {
        "slack": {
            "url": os.environ["SLACK_WEBHOOK_URL"],
            "events": ["decision.denied", "budget.threshold", "circuit.open"],
        }
    }
})

Slack

Step 1: Create a Slack Webhook

Go to api.slack.com/apps and create a new app
Enable Incoming Webhooks
Add a webhook to your desired channel
Copy the webhook URL

Step 2: Configure TealTiger

const engine = new TealEngine({
  policies: {
    budget: { maxCostPerDay: 100.00 },
    security: { detectPII: true },
  },
  webhooks: {
    slack: {
      url: process.env.SLACK_WEBHOOK_URL,
      channel: '#ai-governance',
      events: ['decision.denied', 'budget.threshold', 'circuit.open'],
      // Only alert on high-risk events
      filter: {
        minRiskScore: 70,
      },
      // Rate limit: max 10 alerts per minute
      rateLimit: {
        maxPerMinute: 10,
      },
    }
  }
});

engine = TealEngine({
    "policies": {
        "budget": {"maxCostPerDay": 100.00},
        "security": {"detectPII": True},
    },
    "webhooks": {
        "slack": {
            "url": os.environ["SLACK_WEBHOOK_URL"],
            "channel": "#ai-governance",
            "events": ["decision.denied", "budget.threshold", "circuit.open"],
            "filter": {
                "minRiskScore": 70,
            },
            "rateLimit": {
                "maxPerMinute": 10,
            },
        }
    }
})

Slack Message Format

TealTiger sends rich Slack messages with Block Kit formatting:

{
  "blocks": [
    {
      "type": "header",
      "text": { "type": "plain_text", "text": "🚨 Policy Violation Detected" }
    },
    {
      "type": "section",
      "fields": [
        { "type": "mrkdwn", "text": "*Decision:*\nDENY" },
        { "type": "mrkdwn", "text": "*Risk Score:*\n85/100" },
        { "type": "mrkdwn", "text": "*Reason:*\nBUDGET_EXCEEDED" },
        { "type": "mrkdwn", "text": "*Policy:*\nbudget.daily.v1" }
      ]
    },
    {
      "type": "context",
      "elements": [
        { "type": "mrkdwn", "text": "Provider: openai | Model: gpt-4 | Cost: $0.12" }
      ]
    }
  ]
}

Discord

Step 1: Create a Discord Webhook

Go to your Discord server settings
Navigate to Integrations → Webhooks
Click New Webhook, choose a channel, and copy the URL

Step 2: Configure TealTiger

const engine = new TealEngine({
  policies: { /* ... */ },
  webhooks: {
    discord: {
      url: process.env.DISCORD_WEBHOOK_URL,
      events: ['decision.denied', 'budget.threshold'],
      username: 'TealTiger Bot',
    }
  }
});

engine = TealEngine({
    "policies": {},
    "webhooks": {
        "discord": {
            "url": os.environ["DISCORD_WEBHOOK_URL"],
            "events": ["decision.denied", "budget.threshold"],
            "username": "TealTiger Bot",
        }
    }
})

Discord Message Format

TealTiger sends Discord embeds:

{
  "username": "TealTiger Bot",
  "embeds": [{
    "title": "🚨 Policy Violation Detected",
    "color": 15158332,
    "fields": [
      { "name": "Decision", "value": "DENY", "inline": true },
      { "name": "Risk Score", "value": "85/100", "inline": true },
      { "name": "Reason", "value": "BUDGET_EXCEEDED", "inline": true },
      { "name": "Policy", "value": "budget.daily.v1", "inline": true }
    ],
    "footer": { "text": "TealTiger Governance" },
    "timestamp": "2026-03-22T10:30:00Z"
  }]
}

Microsoft Teams

const engine = new TealEngine({
  policies: { /* ... */ },
  webhooks: {
    teams: {
      url: process.env.TEAMS_WEBHOOK_URL,
      events: ['decision.denied', 'budget.threshold'],
    }
  }
});

engine = TealEngine({
    "policies": {},
    "webhooks": {
        "teams": {
            "url": os.environ["TEAMS_WEBHOOK_URL"],
            "events": ["decision.denied", "budget.threshold"],
        }
    }
})

Custom Webhook

Send alerts to any HTTP endpoint.

const engine = new TealEngine({
  policies: { /* ... */ },
  webhooks: {
    custom: [{
      url: 'https://your-api.example.com/tealtiger-alerts',
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.WEBHOOK_TOKEN}`,
        'Content-Type': 'application/json',
      },
      events: ['decision.denied', 'budget.threshold', 'circuit.open'],
      // Retry on failure
      retry: {
        maxRetries: 3,
        backoffMs: 1000,
      },
    }]
  }
});

engine = TealEngine({
    "policies": {},
    "webhooks": {
        "custom": [{
            "url": "https://your-api.example.com/tealtiger-alerts",
            "method": "POST",
            "headers": {
                "Authorization": f"Bearer {os.environ['WEBHOOK_TOKEN']}",
                "Content-Type": "application/json",
            },
            "events": ["decision.denied", "budget.threshold", "circuit.open"],
            "retry": {
                "maxRetries": 3,
                "backoffMs": 1000,
            },
        }]
    }
})

Custom Webhook Payload

{
  "event": "decision.denied",
  "timestamp": "2026-03-22T10:30:00.000Z",
  "decision": {
    "action": "DENY",
    "reason_codes": ["BUDGET_EXCEEDED"],
    "risk_score": 85,
    "policy_id": "budget.daily.v1",
    "mode": "ENFORCE"
  },
  "context": {
    "provider": "openai",
    "model": "gpt-4",
    "estimated_cost": 0.12,
    "correlation_id": "req-abc-123"
  }
}

Available Events

Event	Description	When it fires
`decision.denied`	A request was blocked	Policy denies a request
`decision.transformed`	A request was modified	PII redacted, model downgraded, etc.
`budget.threshold`	Budget threshold reached	80%, 90%, 100% of budget consumed
`budget.exceeded`	Budget limit hit	Daily/monthly budget exceeded
`circuit.open`	Circuit breaker tripped	Provider failure threshold reached
`circuit.close`	Circuit breaker recovered	Provider recovered after cooldown
`pii.detected`	PII found in request	Sensitive data detected
`injection.detected`	Prompt injection attempt	Potential prompt injection blocked

Configuration Options

Option	Type	Default	Description
`url`	string	required	Webhook endpoint URL
`events`	string[]	all events	Which events to send
`filter.minRiskScore`	number	`0`	Only alert above this risk score
`filter.modes`	string[]	all modes	Only alert for these policy modes
`rateLimit.maxPerMinute`	number	`60`	Max alerts per minute
`retry.maxRetries`	number	`3`	Retry attempts on failure
`retry.backoffMs`	number	`1000`	Initial backoff between retries

Next Steps

Datadog / Splunk

SIEM integration via OTLP

OpenTelemetry

Core telemetry export

Audit Schema

Full audit event format

All Integrations

View all integrations

Getting Started

Core Concepts

Governance Domains

Policy Authoring

Architecture

Integrations

Deployment

API Reference

Cookbook

Compliance & GRC

Guides

Reference

Versions

Playground

Dashboard

Blog

Quick Start

Slack

Step 1: Create a Slack Webhook

Step 2: Configure TealTiger

Slack Message Format

Discord

Step 1: Create a Discord Webhook

Step 2: Configure TealTiger

Discord Message Format

Microsoft Teams

Custom Webhook

Custom Webhook Payload

Available Events

Configuration Options

Next Steps

Datadog / Splunk

OpenTelemetry

Audit Schema

All Integrations

​Quick Start

​Slack

​Step 1: Create a Slack Webhook

​Step 2: Configure TealTiger

​Slack Message Format

​Discord

​Step 1: Create a Discord Webhook

​Step 2: Configure TealTiger

​Discord Message Format

​Microsoft Teams

​Custom Webhook

​Custom Webhook Payload

​Available Events

​Configuration Options

​Next Steps

Datadog / Splunk

OpenTelemetry

Audit Schema

All Integrations

Quick Start

Slack

Step 1: Create a Slack Webhook

Step 2: Configure TealTiger

Slack Message Format

Discord

Step 1: Create a Discord Webhook

Step 2: Configure TealTiger

Discord Message Format

Microsoft Teams

Custom Webhook

Custom Webhook Payload

Available Events

Configuration Options

Next Steps