如何使用Cloudflare Workers搭建Telegram私聊机器人？
Telegram 是一个广受欢迎的即时通讯应用，支持开发者通过 Telegram Bot API 创建功能丰富的机器人。Cloudflare Workers 是一项无服务器计算服务，具有高性能、低延迟和易部署等优点。本文将详细介绍如何结合 Cloudflare Workers 和 Telegram Bot API，搭建一个功能简单但可以不断扩展的 Telegram 私聊机器人。
一、前置条件
在开始构建机器人之前，我们需要一些基本的准备工作：
I. 创建 Telegram 帐户
如果你尚未拥有 Telegram 帐户，请先下载 Telegram 应用并完成注册。这是与 BotFather 互动以及测试机器人的必要条件。
II. 注册 Cloudflare 账户
访问 Cloudflare 官网，注册一个账户。如果已有账户，直接登录即可。在 Cloudflare 平台中，我们将利用 Workers 服务托管机器人逻辑。
III. 准备工具与环境
- Node.js 环境：虽然 Worker 不需要本地运行代码，但调试和模拟请求时，Node.js 会非常有用。
- 文本编辑器：如 VS Code，用于编写代码。
- Postman 或 cURL：方便测试 Telegram 的 API 和 Webhook 配置。
IV. 基本编程知识
本教程主要使用 JavaScript。如果你对 JavaScript 和 HTTP 请求有一定了解，将更容易理解后续内容。
二、创建 Telegram 机器人
Telegram 的 Bot API 提供了丰富的功能，可以让机器人接收消息、处理命令并与用户交互。以下是创建机器人的详细步骤：
I. 使用 BotFather 创建机器人
- 打开 Telegram 应用，在搜索栏中输入 BotFather，点击进入对话。
- 输入
/newbot命令开始创建新机器人。 - 按提示依次输入机器人的名称（显示名）和用户名（必须以
bot结尾，如MyFirstBot）。 -
BotFather 会生成一个唯一的 Token，格式如下：
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11这是你与 Telegram API 通信的唯一凭据，请妥善保存。
II. 获取机器人 API 的权限
创建完成后，你可以使用 BotFather 提供的命令对机器人进行管理。例如：
/setdescription设置机器人的描述。/setcommands配置预定义命令列表。
这些命令能够提升用户体验，为后续功能开发打下基础。
三、 在 Cloudflare Workers 部署服务
Cloudflare Workers 提供了无服务器架构，适合托管轻量级的服务逻辑。以下是部署 Worker 的完整过程。
I. 创建 Worker 服务
- 登录 Cloudflare Dashboard 后，点击 Workers 标签。
- 点击 Create a Service 按钮，填写服务名称（如
telegram-bot-worker）。 - 选择 “HTTP handler” 模板，它是为 HTTP 请求处理预设的模板。
II. 编写 Worker 代码
Worker 代码的核心逻辑包括接收 Telegram 的 Webhook 请求、解析用户消息并响应。
const TELEGRAM_API = "https://api.telegram.org/bot";
const BOT_TOKEN = "<YOUR_BOT_TOKEN>"; // 替换为你的 Bot Token
async function handleRequest(request) {
const url = new URL(request.url);
const path = url.pathname;
if (path === "/webhook") {
// 解析 Telegram 推送的 Webhook 数据
const update = await request.json();
// 提取消息内容
const chatId = update.message.chat.id;
const text = update.message.text;
// 根据用户消息生成响应内容
let responseText;
if (text === "/start") {
responseText = "欢迎使用我的机器人！试试发送其他消息吧。";
} else {
responseText = `你发送的内容是：${text}`;
}
// 发送回复消息
await fetch(`${TELEGRAM_API}${BOT_TOKEN}/sendMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
chat_id: chatId,
text: responseText,
}),
});
return new Response("ok"); // 响应 Telegram 的请求
}
return new Response("Not Found", { status: 404 }); // 非 /webhook 请求返回 404
}
addEventListener("fetch", event => {
event.respondWith(handleRequest(event.request));
});III. 部署 Worker
点击 Deploy 部署服务。部署成功后会生成一个 URL，例如：https://tg-bot-worker.example.workers.dev/webhook。
四、配置 Telegram Webhook
机器人需要通过 Webhook 接收 Telegram 的消息推送。配置步骤如下：
-
使用 cURL 或 Postman 调用以下 API：
curl -X POST "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook" \ -d "url=<WEBHOOK_URL>"<BOT_TOKEN>替换为你的机器人 Token。<WEBHOOK_URL>替换为 Worker 部署的 Webhook 地址。
-
配置成功后，Telegram 会将所有用户消息推送到 Webhook 地址。
-
验证：
- 打开机器人对话框，发送一条消息。
- 如果配置正确，机器人会通过 Webhook 收到消息并自动回复。
五、扩展功能：增强机器人的交互能力
为了让机器人更实用，可以为其添加更多功能：
I. 处理更多命令
通过检测消息内容实现不同的命令：
if (text === "/help") {
responseText = "你可以尝试发送以下命令：\n/start - 启动机器人\n/help - 查看帮助";
}II. 集成第三方 API
使用 API 提供天气、新闻等信息。例如，通过 OpenWeather API 查询天气：
const weatherApi = `https://api.openweathermap.org/data/2.5/weather?q=London&appid=<YOUR_API_KEY>`;
const weatherResponse = await fetch(weatherApi);
const weatherData = await weatherResponse.json();
responseText = `伦敦当前天气：${weatherData.weather[0].description}`;III. 支持多媒体消息
支持发送图片、视频或文档：
await fetch(`${TELEGRAM_API}${BOT_TOKEN}/sendPhoto`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
chat_id: chatId,
photo: "https://example.com/image.jpg",
caption: "这是一个示例图片",
}),
});六、 部署与优化
I. 安全性
- 确保 BOT_TOKEN 不被泄露。
- 校验 Webhook 请求的来源以防止恶意请求。
II. 性能优化
- 缓存常用的静态数据，减少 API 调用。
- 使用 Cloudflare Workers 的 KV 存储保存会话状态或配置信息。
III. 日志与监控
通过 Cloudflare 的日志功能或第三方工具（如 Sentry）监控运行状态，快速发现并解决问题。
七、总结
通过本教程，你已经掌握了利用 Cloudflare Workers 搭建 Telegram 私聊机器人的基本方法。无服务器架构让部署和维护变得更加轻松，而 Telegram Bot API 提供了强大的功能扩展空间。无论是个人项目还是企业应用，这种解决方案都可以满足你的需求。尝试将机器人与其他系统集成，探索更多可能性吧！