通知渠道

约 1426 字大约 5 分钟

2025-05-04

指南简介

采用消息轮循方式接收消息，无需特殊设置即具有 Telegram 消息交互能力。
需要网络能正常连接 Telegram，如无法连接，请给 Symedia 添加代理。

配置指南

1. Telegram

通知渠道【图文】

创建机器人
获取机器人 HTTP API
获取 Tg ID
设置 Sy Tg 通知
测试
- 咱就是说，这个真的真的不需要图了吧？？？再不行，你看看上一步圈起来绿绿的 测试连接 按钮呢。
- 记得先保存，在按 测试连接 按钮。
结束

创建机器人

搜索 @BotFather 机器人
点击左下角菜单栏，选择最顶部的 /newbot
输入 Symedia 通知的名称或自己取名。

Yourself, [2024/11/24 21:37]
/newbot

BotFather,[2024/11/24 21:37]
Alright, a new bot. How are we going to call it? Please choose a name for your bot.

获取机器人 HTTP API

给自己的机器人起一个独一无二的 ID。注意: 以 bot 或 _bot 结尾。
记得复制保存 HTTP API，等下需要用到。

Yourself,[2024/11/24 21:37]
Symedia 通知

BotFather,[2024/11/24 21:37]
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.

Yourself, [2024/11/24 21:37]
symdeia_test_bot

BotFather,[2024/11/24 21:37]
Done! Congratulations on your new bot. You will find it at t.me/symdeia_test_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.

Use this token to access the HTTP API:
# 下面这行 API，复制它，等下要用
1234567891:ABCD-abcdefgHIJKLMNopqrstUVWXYZ
Keep your token secure and store it safely, it can be used by anyone to control your bot.

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

获取 Tg ID

搜索 @ChatIDHelperBot 或者 @userinfobot 等任意可以获取用户ID的机器人。
点击开始，然后等待机器人返回，复制第一行的 ID。

ChatID Helper Bot, [2024/11/24 21:39]

├ message id: 1234

🟢 From
├ Title: Yourself
├ Chat ID: 1234567890
└ Username: @Yourself

🔵 Chat
├ Title: Yourself
├ Chat ID: 1234567890
└ Username: Yourself

设置 Sy Tg 通知
- Bot Token: 设置 Telegram 机器人的 token。
  - 填写 @BotFather 获取到的 API。例如: 1234567891:ABCD-abcdefgHIJKLMNopqrstUVWXYZ。
- Chat ID（管理员白名单）: 设置可以接受消息通知的用户。群组或频道Chat ID。
  - 设置后，只有在管理员白名单的用户才可以关注你的机器人并操作命令功能。
  - 填写 @getidsbot 获取到的 ID。例如：1234567890。
- 用户白名单: 设置可使用 Telegram 机器人的用户 ID 清单，多个用户用 , 分割，不填写则所有用户都能使用。
  - 设置后，只有用户白名单中的 ID 对应用户，才能关注你的机器人发送消息。
  - 填写 @getidsbot 获取到的 ID。例如：1234567890。
测试
- 保存好设置后，进行测试连接，查看机器人是否给你发送通知。如果成功，会给你发送一条测试消息。
- 该通知在你创建的机器人对话框进行通知！按照上述例子，在第 2 步中，BotFather 发给你的消息能看到你机器人的链接。
- Done! Congratulations on your new bot. You will find it at t.me/symdeia_test_bot.。
- 例如: 下边的消息，由创建好的机器人 symdeia_test_bot 发送给你的。
```
Symedia 通知, [2024/11/24 21:41]
Symedia：这是一条测试消息
```
结束

更多设置支持项说明请看通知

2. 企业微信

部署通知代理服务器

首先在你的 VPS 上部署通知代理服务器，创建 docker-compose.yml 文件：

services:
   wxchat:
   container_name: wxchat
   restart: always
   ports:
     - 8090:80
   image: ddsderek/wxchat:latest

获取企业微信配置信息
在企业微信管理后台获取以下配置信息：
1. 企业 ID
  在企业微信管理后台可以查看到企业 ID：
2. 应用 ID
  先创建机器人应用，上传头像并设置好名称：
3. 应用密钥
  在应用详情页面可以查看到应用密钥：
4. Access Token
  获取 Access Token 的步骤：
5. 消息加密密钥
  在应用配置中可以查看到消息加密密钥：
6. URL（回调地址）
  企业微信回调地址填写格式：https://你的公网地址/api/v1/message/?token=symedia
  注意：请将 你的公网地址 替换为 Symedia 服务器的实际公网地址。
7. 结束
配置 Symedia
1. 配置 AccessToken 消息加密密钥
  在企业微信管理后台点击"随机获取"后，将获取到的 Token 和 EncodingAESKey 填入 Symedia 的 AccessToken 和 消息加密密钥 字段中。
2. 配置代理 URL
  代理 URL 填写上面部署好的容器的地址，格式为：http://IP:端口。例如：http://97.186.78.51:8090
3. 保存配置
  填写完毕后，先在 Symedia 中点击保存，然后再 在企业微信管理后台点击保存。如果显示回调成功，说明配置成功了。
4. 配置可信IP
  重要：记得将上面 VPS 的 IP 添加到应用的可信 IP 列表中。
5. 结束
配置完成检查
配置完成后，请仔细检查各项配置是否正确，特别注意是否存在多余的空格
使用企业微信机器人
1. 使用微信扫码添加企业微信机器人
2. 添加成功后，就可以通过企业微信接收 Symedia 的通知消息了
3. 结束
结束