---
title: "Echobell Direct：无需频道配置的个人 Webhook 即时提醒"
date: 2026-03-05
description: "Echobell Direct 为你提供一个个人 Webhook URL，可从脚本、CI 作业和自动化工具直接发送即时通知——无需频道或模板配置。"
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
---

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

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

## 什么是 Echobell Direct？

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

以下情况适合使用 Direct：

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

如果需要共享通知、可复用模板或条件投递，请改用[频道 Webhook 模式](/en/docs/webhook)。

## 三步完成配置

### 第一步：创建 Direct 密钥

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

### 第二步：复制 Webhook URL

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

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

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

### 第三步：发送第一条通知

```bash
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](/en/docs/direct)

## 紧急级别

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

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

完整行为说明请见[通知类型](/en/docs/notification)。

## 为通知附加上下文

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

对于 AI 智能体和长时间异步任务，Direct 是任务完成时主动推送通知的最简方案，无需手动轮询。另请参考：[WebhookMCP + Echobell](/en/blog/get-notified-with-webhook-mcp)。

## Direct 与频道对比

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

当告警需要多人接收，或希望统一格式时，使用频道。[模板文档](/en/docs/template) · [什么是 Echobell](/en/docs/what-is-echobell)

## 安全最佳实践

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

## 常见问题

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

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

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

---

从 [Direct 指南](/en/docs/direct) 开始。当你的工作流需要协作或模板时，[频道](/en/docs/webhook)是顺理成章的下一步。

## 相关

- [Direct API 文档](/en/docs/direct) — 完整字段参考和示例
- [WebhookMCP + Echobell](/en/blog/get-notified-with-webhook-mcp) — 使用 Direct 接收 AI 任务完成通知
- [如何让关键告警突破 iOS 专注模式](/en/blog/how-to-bypass-ios-focus-mode-for-critical-alerts) — 选择合适的通知紧急级别
- [Zapier Webhook 通知](/en/blog/zapier-webhook-notifications-to-phone) — 面向非开发者的自动化工作流
- [通知类型](/en/docs/notification) — 普通、时间敏感和来电通知的行为说明