集成

Webhook

安装 an https endpoint you control

Webhook 渠道会为每条告警向你的 URL POST 一个 JSON 体，并用你只复制一次的密钥签名。信任请求体前请先验证签名。

1添加渠道

集成 › Webhook：输入 https URL，选择项目范围和要接收的告警。签名密钥（whsec_...）只显示一次：“请立即复制签名密钥。它不会再次显示。”

2验证签名

请求头 x-blipit-signature 是用你的密钥对原始请求体计算的十六进制 HMAC-SHA256。请使用恒定时间比较。

js
import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(rawBody, header, secret) {
  const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
  return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}

3读取请求体

问题告警如下所示。type 为 new_issue、regression、security 或 test；security 字段仅在安全告警中出现。

json
{
  "type": "new_issue",
  "project": { "id": 12, "name": "shop" },
  "issue": { "id": 981, "title": "TypeError: cart is undefined", "url": "https://app.blipit.io/issues/981", "level": "error", "event_count": 1 },
  "event": { "release": "2026.09.28", "environment": "production", "platform": "javascript" },
  "sent_at": "2026-09-28T09:15:00.000Z"
}

须知

  • 监控器变化以相同方式发送，type 为 monitor.down 或 monitor.up，通知类为 monitor.slow、monitor.fast 和 monitor.expiring。
  • 只接受公网地址上的 https URL；不跟随重定向。保存后使用测试按钮可看到一次 type: test 的送达。
  • 请尽快返回 2xx。送达失败会在渠道上显示为错误；Blipit 不会排队稍后重试。

遇到问题？发邮件至 support@blipit.io。每个项目的密钥和确切的 DSN 在 app.blipit.io 的“API 密钥”下。