QQNotifier

兼容 Telegram 接口协议的 Serverless QQBot Webhook

📍 接口根地址

所有 API 调用均基于以下基础路径:

https://qqnotifier.psu.monster/bot<Token>/sendMessage

其中 <Token> 为你在 CF Worker 环境变量 BOT_PROFILES 中定义的键名,见 部署说明

📖 API 使用指南

1. GET 方式同步调用

GEThttps://qqnotifier.psu.monster/bot<Token>/sendMessage?text=你好&image=URL

2. POST 方式调用

POSTContent-Type: application/json
{
  "text": "这是消息内容",
  "parse_mode": "markdown",
  "image": "https://example.com/pic.jpg"
}

📝 参数列表

text
消息主体文本。
image
图片 URL。
video
视频 URL。
audio
音频 URL。
parse_mode
设置为 markdown 启用 QQ Markdown 渲染。
chat_id
随便填。网关会自动使用预设的 open_id

注:text 与媒体参数(image/video/audio至少要提供一个即可发送。

注:经测试,markdown无法发送图片,故服务器会自动拆分发送。放弃了 embed、art 等完全无法正常使用的模式。

🛠️ 接入 Uptime Kuma 示例

关于 chat_id 的重要说明:
在 Uptime Kuma 或其他软件的 Telegram 设置中,chat_id 字段随便填写数字或字符即可(如 123)。网关会自动忽略此值,转而使用你预设好的 open_id 进行私信推送。

✨ 特性与限制

🚀 部署说明 (Cloudflare Workers)

  1. 新建一个 Cloudflare Worker。
  2. 将本代码复制并粘贴到编辑器中保存。
  3. Settings -> Variables 中添加环境变量:
    名称:BOT_PROFILES
    值(JSON 格式):
    {
      "你自己设定的Token": {
        "app_id": "机器人ID",
        "secret": "机器人密钥",
        "open_id": "你的OpenID"
      }
    }
请藏好 你自己设定的Token ,避免他人利用接口给你发送消息。

注:app_idsecret于QQ开放平台获取,open_id在线获取 OpenID

🔍 在线获取 OpenID

在这里输入你的机器人凭据,然后在QQ上给机器人发条消息即可捕获你的专属 OpenID。

等待操作...