https://github.com/easychen/telechan
message api for telegram bot 可供多人发送消息的 telegram 机器人 api ， 类似server酱的开源实现
https://github.com/easychen/telechan
Last synced: about 1 year ago
JSON representation
message api for telegram bot 可供多人发送消息的 telegram 机器人 api ， 类似server酱的开源实现
- Host: GitHub
- URL: https://github.com/easychen/telechan
- Owner: easychen
- License: mit
- Archived: true
- Created: 2021-04-18T14:16:22.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-07-10T09:41:22.000Z (almost 5 years ago)
- Last Synced: 2024-11-19T11:54:26.866Z (over 1 year ago)
- Language: TypeScript
- Homepage: telechan8.vercel.app
- Size: 30.3 KB
- Stars: 414
- Watchers: 9
- Forks: 295
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
⚠️⚠️⚠️ 由于近期 vercel 环境疑似做了调整，新部署的机器人识别命令会报错(原来创建的机器人不受影响)，我最近没空修改此项目，先 Archive 掉。着急使用的同学可以 fork & fix 先。
# TeleChan - message api for telegram bot
> 可供多人发送消息的 telegram 机器人 api ， 类似server酱的开源实现
## 🎈 本项目属于方糖推送生态。该生态包含项目如下：
- [Server酱Turbo](https://sct.ftqq.com)：支持企业微信、微信服务号、钉钉、飞书群机器人等多通道的在线服务，无需搭建直接使用，每天有免费额度
- [Wecom酱](https://github.com/easychen/wecomchan)：通过企业微信推送消息到微信的消息推送函数和在线服务方案，开源免费，可自己搭建。支持多语言
- [Tele酱](https://github.com/easychen/telechan)：可以通过 Vercel 免费部署，且部署后 API 在国内网络可访问的 Telegram 多账户消息推送机器人
## 直接试用我搭建的机器人
1. 添加 @TeleChan8Bot
2. 发送 /sendkey 获得 key 和 url
3. 通过 url 发送请求即可
## Example
1. add @TeleChan8Bot in telegram
2. `/sendkey` to get key & url
3. send request via url
## How to use
1. star and fork this repo
2. goto https://vercel.com/ create a new project, select the repo just created
3. add [BotFather](https://t.me/botfather) in telegram, create new bot and get `telegram api token`
4. set output dir to `dist` , set `BOT_TOKEN` to `telegram api token`, set `TCKEY` a random string 
5. deploy
6. send /sendkey command to the bot, you will get sendkey and api url
## API
Both HTTP `GET` or `POST` are OK
- sendkey,required
- text,required
- desp,optional
- markdown,optional
`text` and `desp` support [telegram markdown](https://core.telegram.org/bots/api#markdownv2-style) which is a very small subset of markdown without image support
### send function
```php
function tg_send( $text , $desp = '' , $key = '' )
{
$postdata = http_build_query( array( 'text' => $text, 'desp' => $desp ));
$opts = array('http' =>
array(
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
'content' => $postdata));
$context = stream_context_create($opts);
return $result = file_get_contents('telechan8.vercel.app/api/send?sendkey='.$key, false, $context);
}
```
## Thanks
Heavily modified base [Telegram Bot Boilerplate with Vercel's Serverless Functions](https://github.com/waptik/telegram-bot-boilerplate-now-serverless-api)
## 中文教程
[](https://www.bilibili.com/video/BV1S5411c7Vy/)
[安装视频@B站，欢迎关注作者](https://www.bilibili.com/video/BV1S5411c7Vy/)
参数说明：
- sendkey,required
- text,required
- desp,optional
- markdown,optional
仅支持部分 Markdown 语法，任何不兼容以下语法的的提交，都会导致 400 错误。[注意不支持图片](https://core.telegram.org/bots/api#markdownv2-style)，注意不支持图片，注意不支持图片：
```
*bold \*text*
_italic \*text_
__underline__
~strikethrough~
*bold _italic bold ~italic bold strikethrough~ __underline italic bold___ bold*
[inline URL](http://www.example.com/)
[inline mention of a user](tg://user?id=123456789)
`inline fixed-width code`
```
pre-formatted fixed-width code block
```
```python
pre-formatted fixed-width code block written in the Python programming language
```
```