> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alertdog.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook

> 通过自定义 Webhook 接收 AlertDog 监控报警消息，开发者友好的通知方式

简介：Webhook 是开发者友好的通知方式，支持将监控消息推送到你自定义的 HTTP 端点，实现与你的应用程序或工作流的深度集成。

# 操作步骤

## 第一步：获取 Webhook

在你喜欢的平台, 生成 Webhook URL 地址

## 第二步：创建 Webhook 通知渠道并配置

打开监控狗 **添加新渠道** -> **Webhook** -> **输入 Webhook URL** -> **确定**

<Frame>
  <img src="https://mintcdn.com/alertdog/RCBluHwjsDCzwhrG/images/notification-channels/webhook/webhook-url-config.png?fit=max&auto=format&n=RCBluHwjsDCzwhrG&q=85&s=c983def6d0bd377f78d8c6b44ec58f99" alt="AlertDog 中配置 Webhook URL" width="1436" height="717" data-path="images/notification-channels/webhook/webhook-url-config.png" />
</Frame>

## 第三步：完成添加

点击"确认"完成 Webhook 通知渠道配置

## Webhook 消息格式

AlertDog 会以 POST 方法向你的 Webhook URL 发送 JSON 格式的数据：

```json theme={null}
{
  "event": "monitor_triggered",
  "timestamp": "2025-01-15T10:30:00Z",
  "monitor": {
    "id": "monitor_123",
    "name": "BTC 地址监控",
    "type": "wallet"
  },
  "data": {
    // 监控相关数据
  }
}
```

## 安全配置

<Warning>
  建议启用签名验证，确保接收到的请求来自 AlertDog。你可以在URI配置时设置唯一字符。
</Warning>

使用说明：配置完成后，监控触发时 AlertDog 会向你的 Webhook URL 发送请求。你可以在自己的应用中处理这些请求，实现自定义的通知逻辑。

# 常见问题

<AccordionGroup>
  <Accordion title="Webhook URL 必须是 HTTPS 吗？">
    为了安全起见，我们强制使用 HTTPS。
  </Accordion>

  <Accordion title="Webhook 请求超时时间是多久？">
    Webhook 请求超时时间为 5 秒。如果你的服务器响应时间过长，可能导致请求失败。
  </Accordion>
</AccordionGroup>