Home/Docs/Webhooks

Webhook Alerts

Get instant notifications when AgentSentry blocks a transaction, trips a circuit, or escalates for human review.

Telegram Setup

  1. 1. Message @BotFather on Telegram and create a new bot
  2. 2. Copy the bot token and add to your environment variables
  3. 3. Create a channel and add your bot as administrator
  4. 4. Get the chat ID using the getUpdates API
.env
TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
TELEGRAM_CHAT_ID=-1001234567890

Discord Setup

  1. 1. Open your Discord server settings
  2. 2. Go to Integrations and Webhooks
  3. 3. Create a new webhook and copy the URL
.env
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...

Alert Types

CIRCUIT_OPEN

Circuit breaker has tripped

CRITICAL
POLICY_VIOLATION

Transaction blocked by policy

HIGH
HIGH_VALUE_TRADE

Large transaction detected

MEDIUM
VELOCITY_WARNING

Unusual transaction frequency

MEDIUM

Was this page helpful? /