无需创建频道，通过个人 API 密钥直接发送通知。了解如何创建直达密钥、使用 webhook URL 以及发送包含标题、正文和链接的即时通知。

直达通知

直达通知让您通过简单的 webhook URL 发送个人提醒 — 无需设置频道、模板或订阅者。只需创建一个密钥，调用 URL，即可在设备上立即收到通知。

什么是直达通知？

频道非常适合可与他人共享的结构化模板通知。但有时您只需要一个快速的个人通知 — 构建完成、脚本执行完毕、传感器触发。直达通知正是为此设计的。

使用直达通知，您可以获得一个个人 API 密钥，对应一个唯一的 webhook URL。当您使用标题和正文调用该 URL 时，通知将直接发送给您，无需配置频道。

开始使用

1. 创建直达密钥

在 Echobell 应用中，点击频道列表顶部的直达。然后点击创建生成新的直达密钥，为其取一个描述性名称（如 "构建服务器"、"家庭实验室"、"交易机器人"）。

2. 复制 Webhook URL

每个直达密钥都有一个唯一的 webhook URL：

https://hook.echobell.one/d/{your-key-token}

您可以在应用的直达密钥详情视图中找到并复制此 URL。令牌默认隐藏以确保安全 — 点击即可显示。

3. 发送通知

使用包含 title 和 body 的 JSON 正文调用 webhook URL：

POST https://hook.echobell.one/d/YOUR_KEY_TOKEN
Content-Type: application/json

{
  "title": "构建完成",
  "body": "项目 X 构建成功，耗时 3 分 42 秒"
}

就是这么简单 — 您将立即收到通知。

发送请求

POST 请求（推荐）

发送包含通知内容的 JSON 正文：

POST https://hook.echobell.one/d/YOUR_KEY_TOKEN
Content-Type: application/json

{
  "title": "部署状态",
  "body": "v2.1.0 已部署到生产环境",
  "externalLink": "https://dashboard.example.com/deploys/latest"
}

GET 请求

您也可以通过查询字符串传递参数：

GET https://hook.echobell.one/d/YOUR_KEY_TOKEN?title=警报&body=CPU+使用率+95%25

请求字段

所有字段名不区分大小写 — title、Title 和 TITLE 的效果相同，无论是通过 JSON 正文还是查询字符串传递。

字段	类型	必填	描述
`title`	string	否	通知标题。省略时默认为 "Direct Notification"。
`body`	string	否	通知正文。
`externalLink`	string	否	在通知记录中显示的可点击链接。
`notificationType`	string	否	通知紧急程度。接受 `active`、`time-sensitive` 或 `calling`。默认为 `time-sensitive`。详见通知类型。

通知类型

您可以使用 notificationType 字段控制直达通知的紧急程度：

类型	描述
`active`	标准通知，正常投递。
`time-sensitive`	高优先级通知，可突破专注模式。这是默认值。
`calling`	类似来电的提醒，适用于紧急情况。需要有效的高级订阅。没有高级订阅时，会回落到 `time-sensitive`。

带通知类型的示例：

POST https://hook.echobell.one/d/YOUR_KEY_TOKEN
Content-Type: application/json

{
  "title": "服务器宕机",
  "body": "生产服务器无响应",
  "notificationType": "calling"
}

常见用例

Shell 脚本

curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"title": "迁移完成", "body": "数据库迁移已成功完成"}'

Python

import requests

requests.post(
    "https://hook.echobell.one/d/YOUR_KEY_TOKEN",
    json={
        "title": "训练完成",
        "body": f"模型准确率: {accuracy:.2%}",
        "externalLink": "https://wandb.ai/runs/abc123"
    }
)

管理直达密钥

多个密钥：可为不同用途创建多个密钥（CI 服务器、家庭自动化、定时任务等），通知记录会自动与触发它的密钥关联，方便识别每条通知的来源
重置令牌：如果密钥的 webhook URL 泄露，可在密钥详情视图中重置令牌，旧 URL 将立即失效
删除密钥：删除直达密钥将永久使其 webhook URL 失效

最佳实践

安全性：将直达密钥 URL 视为机密，使用环境变量存储令牌
组织管理：为密钥取描述性名称，每个服务使用单独的密钥
错误处理：始终检查 HTTP 响应状态以确保成功投递
及时清理：删除不再使用的密钥以减少安全风险

隐私和安全

直达密钥 URL 应被视为机密
仅发送必要的数据
通知内容存储在您的设备上
我们的服务器仅处理请求并路由通知

故障排除

如果直达通知未按预期工作：

验证 webhook URL 是否正确
检查密钥是否仍然存在（可能已被删除或重置令牌）
确保 Echobell 应用具有通知权限
确保 JSON 格式正确且设置了 Content-Type: application/json 请求头
使用 curl 测试以排除 HTTP 客户端问题

需要帮助？访问我们的支持中心或通过 echobell@weelone.com 联系我们。

直达通知 - 通过个人 API 密钥发送即时提醒