![\"Tencent](\"https://edgeone.ai/media/34fe3a45-492d-4ea4-ae5d-ea1087ca7b4b.png\")
\n\n\n\n## 第一步：创建 Telegram 机器人 (公共教程)\n\n在部署之前，您首先需要一个 Telegram Bot。\n\n1. **关注 BotFather**: 在 Telegram 中搜索并关注官方的 [BotFather](https://t.me/BotFather)。\n2. **创建机器人**: \n * 向 BotFather 发送 `/newbot` 命令。\n * 根据提示，依次输入机器人的显示名称（例如 `我的消息助手`）和用户名（必须以 `bot` 结尾，例如 `my_message_assistant_bot`）。\n \n3. **获取 Token**: 创建成功后，BotFather 会发送一条包含 **API Token** 的消息。请务必保存好这个 Token，它在后续部署中是必需的。\n \n4. **设置命令**: 为了方便获取 `chat_id`，需要为机器人设置一个命令。\n * 向 BotFather 发送 `/mybots`，然后选择你刚刚创建的机器人。\n * 点击 `Edit Bot` -> `Edit Commands`。\n * 输入 `token - 获取个人 Token` 并发送。\n \n\n---\n\n## 第二步：选择平台进行部署\n\n您可以选择 Vercel 或 腾讯云 EdgeOne 进行部署，两者择一即可。\n\n### 选项 A：通过 Vercel 部署\n\nVercel 提供免费、快速的 Serverless 函数托管服务。\n\n1. **一键部署**: 点击项目顶部的 **Deploy with Vercel** 按钮。\n2. **设置环境变量**: 在 Vercel 的项目创建页面，你需要配置以下环境变量：\n * `token`: **【必填】** 填入上一步获取的机器人 API Token。\n * `sign_key`: **【建议】** 用于加密 `chat_id` 的密钥，不设置默认为 `abc`。建议设置为一个复杂的随机字符串。\n * `key`: **【建议】** 设置 Webhook 时的管理密钥，防止他人调用。请设置为一个复杂的随机字符串。\n * `url`: **【可选】** 你的 Webhook 回调地址。如果不设置，后续需要手动指定。Webhook 最终地址为 `https://<你的Vercel域名>/api/webhook`。\n \n3. **获取个人 Token**:\n * 部署完成后，在浏览器中访问 `https://<你的Vercel域名>/api/setWebhook?key=<你设置的key>` 来设置回调。\n * 然后与你的机器人对话，发送 `/token` 命令，机器人会返回一长串加密的个人 Token。\n4. **发送消息**:\n * 现在你可以通过请求 `https://<你的Vercel域名>/api/index?token=<你的个人Token>&message=你好` 来给自己发送消息。\n\n### 选项 B：通过 EdgeOne Page Functions 部署\n\nEdgeOne 是腾讯云推出的边缘一体化安全与加速平台，其 Page Functions 功能同样可以托管本项目。\n\n1. **一键部署 (推荐)**:\n * 点击项目顶部的 **使用 EdgeOne Pages 部署** 按钮。\n * 授权后，在项目创建页面，EdgeOne 会自动为你填充大部分配置。\n * 在 **环境变量** 部分，填入 `token` 和 `sign_key`。\n * **重要**: 部署启动后，请立即进入项目 \"设置\" -> \"环境变量\" 页面，**手动添加**第三个环境变量 `key`。\n * **环境变量说明**:\n * `token`: **【必填】** 你的 Telegram Bot Token。\n * `sign_key`: **【必填】** 加密 `chat_id` 用的密钥。\n * `key`: **【必填】** 设置 Webhook 用的管理密钥。\n2. **手动部署**:\n * Fork 本项目到你的 GitHub 账户。\n * 在 EdgeOne 控制台新建 Pages 项目，关联你 Fork 的仓库。\n * **输出目录** 填写 `edge_deploy`。\n * 手动添加上述三个环境变量。\n3. **获取个人 Token**:\n * 部署成功后，在浏览器中访问 `https://<你的Pages域名>/setWebhook?key=<你设置的key>` 设置回调。\n * 与你的机器人对话，发送 `/token` 命令，获取个人 Token。\n4. **发送消息**:\n * 通过访问 `https://<你的Pages域名>/sendMessage?token=<你的个人Token>&message=你好` 发送消息。\n * API 详情可参考 `edge_deploy/edge.html`。\n\n## Vercel 版本\n\nTG 消息推送机器人,基于 vercel 函数 和 Edgeone 边缘函数 搭建的TG消息推送机器人，无需服务器。\n\n## 搭建教程\n### Deploy to Vercel\n[](https://vercel.com/new/git/external?repository-url=https%3A%2F%2Fgithub.com%2Fanhao%2FTgMessage&env=token,sign_key,key&project-name=tg-message&repo-name=tg-message&demo-title=TG%20Message&demo-url=https%3A%2F%2Ftg-message.vercel.app%2F)\n[](https://dashboard.pandastack.io/deploy?repo=anhao/TgMessage&type=static&buildCmd=npm+run+build&outputDir=dist)\n### 建立 TG 机器人\n\n1.首先关注 [BotFather](https://t.me/BotFather)\n\n2. 创建机器人,关注 BotFather 之后,发送 `/newboot` 开始创建 Bot 第一次输入机器人名称,第二次输入机器人 `username` 需要以 `bot` 结尾\n \n\n**3.获取机器人 token**\n\n创建成功之后会发送一条消息给你，里面就包含了 `token`\n\n\n\n**设置机器人 Command**\n设置获取 token 命令 首先给 BotFather 发送 `/mybots`,然后点击你刚才创建的机器人,再点击 `Edit Bot`, 继续点击 `Edit Commands`。 然后输入\n\n```\ntoken - 获取token\n```\n\n这样就设置好了一个 `commands`\n\n\n\n\n\n\n\n## 部署到 Vercel\n\n点击首页的 Deploy 跳到 vercel\n\n\n输入项目名，然后确认\n\n\n\n确认之后会直接部署到 vercel\n\n### 设置环境变量\n\nvercel 部署好了之后，然后设置环境变量\n\n在控制台点击你创建好的项目，然后点击设置，添加环境变量\n\n\n\n```\n需要设置4个环境变量，1个是必填的\n\ntoken: bot 机器人的token\nsign_key: 加密 chat_id 需要用到，不设置默认为 abc\nurl: webhook 回调地址, 不设置的话请求 setWebhook 时需要手动加参数， webhook url 地址为：https://你的域名/webhook\nkey: 设置 webhook 的请求参数\n```\n\n\n\n上面的环境变量设置好了之后，可能不会立马生效，你可以重新构建一下函数\n\n\n\n### 设置回调\n设置 webhook ，可以直接通过浏览器请求来设置\n\nwebhook地址为：`https://你的域名/webhook`\n\n浏览器窗口打开：`https://你的域名/setwebhook?key=环境变量设置的KEY&url=你的webhook地址`\n\n`code` 返回 200 就是设置成功了~\n"
},
{
"path": "api/Bot.php",
"content": "token = $_ENV['token'];\n $this->key = $_ENV['sign_key'] ?? 'abc';\n }\n\n public function request($method, $data)\n {\n $curl = curl_init();\n\n curl_setopt_array($curl, array(\n CURLOPT_URL => sprintf('https://api.telegram.org/bot%s/%s', $this->token, $method),\n CURLOPT_RETURNTRANSFER => true,\n CURLOPT_ENCODING => '',\n CURLOPT_MAXREDIRS => 10,\n CURLOPT_TIMEOUT => 0,\n CURLOPT_FOLLOWLOCATION => true,\n CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_POSTFIELDS => $data,\n ));\n $response = curl_exec($curl);\n curl_close($curl);\n return json_decode($response, true);\n }\n\n public function sendMessage($data): array\n {\n return $this->request('sendMessage', $data);\n }\n\n public function setWebHook($data)\n {\n return $this->request('setWebhook', $data);\n }\n\n public function encryption($chat_id): string\n {\n return base64_encode($this->key . $chat_id);\n }\n\n public function decryption($text): string\n {\n return substr(base64_decode($text), strlen($this->key));\n }\n\n /**\n * @param string $key\n * @return Bot\n */\n public function setKey(string $key): Bot\n {\n $this->key = $key;\n return $this;\n }\n\n /**\n * @param string $token\n * @return Bot\n */\n public function setToken(string $token): Bot\n {\n $this->token = $token;\n return $this;\n }\n}"
},
{
"path": "api/index.php",
"content": " 422, 'message' => 'token 不能为空']);\n} else {\n // 发送消息\n $chat_id = $bot->decryption($token);\n $ret = $bot->sendMessage(['text' => $message, 'chat_id' => $chat_id]);\n if ($ret['ok']) {\n echo json_encode(['code' => 200, 'message' => 'success']);\n } else {\n echo json_encode(['code' => 422, 'message' => $ret['description']]);\n }\n}"
},
{
"path": "api/setWebHook.php",
"content": " 422, 'message' => '设置秘钥错误']);\n} else {\n //开始设置回调url\n $url = $_REQUEST['url'] ?? $_ENV['url'];\n require_once 'Bot.php';\n $data = ['url' => $url];\n $bot = new Bot();\n $ret = $bot->setWebHook($data);\n if ($ret['ok']) {\n echo json_encode(['code' => 200, 'message' => '设置成功']);\n } else {\n echo json_encode(['code' => 422, 'message' => $ret['description']]);\n }\n}"
},
{
"path": "api/webhook.php",
"content": "sendMessage(['text' => $bot->encryption($chat_id), 'chat_id' => $chat_id]);\n}\necho json_encode(['code' => 200, 'message' => 'success']);"
},
{
"path": "edge_deploy/edge.html",
"content": "\n\n\n \n \n\n你的边缘函数触发地址, 例如：
\nhttps://your-domain.com/
/token 获取你的专属 Token.token, sign_key, key.| 字段名称 | \n类型 | \n必填 | \n备注 | \n
|---|---|---|---|
| token | \nstring | \nY | \n从机器人获取的 Token | \n
| message | \nstring | \nY | \n要发送的消息内容 | \n
请求示例:
\nGET /sendMessage?token=YOUR_TOKEN&message=Hello+World\n| 字段名称 | \n类型 | \n必填 | \n备注 | \n
|---|---|---|---|
| key | \nstring | \nY | \n你在环境变量中设置的 key | \n
| url | \nstring | \nN | \n可选, 自定义 webhook 地址, 默认为当前函数地址 + /webhook | \n
请求示例:
\nGET /setWebhook?key=YOUR_ADMIN_KEY\n此接口用于接收来自 Telegram 的 POST 请求，通常无需手动调用。
\n\n\n{\"code\":200,\"message\":\"success\"}\n\n \n\n
/token 获取 token | 字段名称 | \n字段说明 | \n类型 | \n必填 | \n备注 | \n
|---|---|---|---|---|
| token | \n\n | string | \nY | \ntoken | \n
| message | \n\n | string | \nY | \n要发送的消息内容 | \n
{\"code\":200,\"message\":\"success\"}\n