qd-today / qd

QD [v20240210] —— HTTP请求定时任务自动执行框架 base on HAR Editor and Tornado Server
https://qd-today.github.io/qd/
MIT License
4.39k stars 565 forks source link

[Feature] 注册TgBot作为推送渠道的操作指南 #387

Closed Patrick-Ze closed 1 year ago

Patrick-Ze commented 1 year ago

Verify steps

Describe the Feature

目前签到框架网页对注册TgBot作为推送方式的指引中,相关字段含义可能不是很清晰 image

qiandao注册TgBot的字段说明

假设你已经创建了一个具有自定义域名的telegram bot API (如何创建这样一个域名&各个字段的含义可以搜索教程和telegram文档,此处略去不表):

https://tg.mydomain.com/bot1111111111:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/sendMessage?chat_id=222222222&text=HelloWorld

上面这个请求将会向222222222这个聊天发送一条HelloWorld消息。那么在注册TgBot的页面时:

因此最终填写形式形如:

1111111111:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA;222222222;tg.mydomain.com

(我看代码之前以为的TG_USERID是TgBot的ID,TG_TOKENAAAA……这段key)

Describe the solution

见上文。

Describe alternatives

我是查看了项目的源代码之后才知道如何填写的,我也愿意参与repo文档的更新,本来是想向github.io的文档提PR,但是好像github page是不公开编辑的,因此开了一个issue供有类似需要的同学参考步骤(或者大佬是否考虑把这个添加到FAQ里?)

Additional context

No response

a76yyyy commented 1 year ago

英文文档编辑 FAQ: https://github.com/qiandao-today/qiandao/blob/master/web/docs/guide/faq.md 中文 FAQ: https://github.com/qiandao-today/qiandao/blob/master/web/docs/zh_CN/guide/faq.md