Echobell Direct：无需频道配置的个人 Webhook 即时提醒

Echobell Direct 是一种个人提醒模式，完全跳过频道配置。创建一个 Direct 密钥，获得 Webhook URL，向其 POST title + body，即可在你的设备上立即收到通知。无需订阅者、无需模板、无需路由配置。

本文介绍 Direct 是什么、如何配置，以及何时使用它而非频道模式。

什么是 Echobell Direct？

每个 Direct 密钥会生成一个唯一的 Webhook URL（/d/{token}）。向该 URL 发送请求，通知立即送达你的设备。

以下情况适合使用 Direct：

脚本、定时任务或 CI 流水线的个人通知
每次请求自定义标题和正文，而非固定模板
快速配置，无需搭建完整频道

如果需要共享通知、可复用模板或条件投递，请改用频道 Webhook 模式。

三步完成配置

第一步：创建 Direct 密钥

打开 Echobell，在频道列表中点击 Direct，创建一个密钥。建议按所属服务命名（如 CI Server、Cron、AI Tasks）。

第二步：复制 Webhook URL

每个密钥对应一个格式如下的 URL：

https://hook.echobell.one/d/YOUR_KEY_TOKEN

将此 URL 视为密钥保管——任何持有它的人都可以向你发送通知。

第三步：发送第一条通知

curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'

完整字段参考：Direct API

紧急级别

Direct 支持 notificationType，可根据事件选择合适的紧急程度：

active — 常规更新
time-sensitive — 可穿透专注模式的重要告警
calling — 关键事件（需要有效的高级订阅；否则回落到 time-sensitive）

完整行为说明请见通知类型。

为通知附加上下文

在请求体中加入 externalLink，可为通知附上一个 URL——适合直接链接到部署日志、控制台或 Pull Request。

对于 AI 智能体和长时间异步任务，Direct 是任务完成时主动推送通知的最简方案，无需手动轮询。另请参考：WebhookMCP + Echobell。

Direct 与频道对比

	Direct	频道
接收对象	仅个人	可与团队共享
模板	每次请求自定义内容	可复用的固定模板
配置时间	不到一分钟	需要配置频道
条件	不支持	支持

当告警需要多人接收，或希望统一格式时，使用频道。模板文档 · 什么是 Echobell

安全最佳实践

将 Direct token 存储在环境变量或密钥管理器中，不要硬编码在代码里
每个服务创建独立密钥，方便单独撤销
发现 URL 可能泄露时立即轮换 token
calling 仅用于真实事故——滥用会导致告警疲劳

常见问题

Direct 只适合开发者吗？ 不是。任何能发 HTTP 请求的工具都可以使用它。

Direct 支持 GET 请求吗？ 支持，但推荐使用带 JSON 的 POST。

订阅过期后使用 calling 会怎样？ 自动回落到 time-sensitive。

从 Direct 指南开始。当你的工作流需要协作或模板时，频道是顺理成章的下一步。