XuLaLa.Tech

Telegram 是一个广受欢迎的即时通讯应用，支持开发者通过 Telegram Bot API 创建功能丰富的机器人。Cloudflare Workers 是一项无服务器计算服务，具有高性能、低延迟和易部署等优点。本文将详细介绍如何结合 Cloudflare Workers 和 Telegram Bot API，搭建一个功能简单但可以不断扩展的 Telegram 私聊机器人。

• 1. 一、前置条件
  • 1.1. I. 创建 Telegram 帐户
  • 1.2. II. 注册 Cloudflare 账户
  • 1.3. III. 准备工具与环境
  • 1.4. IV. 基本编程知识
  2. 二、创建 Telegram 机器人
  • 2.1. I. 使用 BotFather 创建机器人
  • 2.2. II. 获取机器人 API 的权限
  3. 三、 在 Cloudflare Workers 部署服务
  • 3.1. I. 创建 Worker 服务
  • 3.2. II. 编写 Worker 代码
  • 3.3. III. 部署 Worker

  4. 四、配置 Telegram Webhook5. 五、扩展功能：增强机器人的交互能力

  • 5.1. I. 处理更多命令
  • 5.2. II. 集成第三方 API
  • 5.3. III. 支持多媒体消息
  6. 六、 部署与优化
  • 6.1. I. 安全性
  • 6.2. II. 性能优化
  • 6.3. III. 日志与监控
  7. 七、总结

一、前置条件

在开始构建机器人之前，我们需要一些基本的准备工作：

I. 创建 Telegram 帐户

如果你尚未拥有 Telegram 帐户，请先下载 Telegram 应用并完成注册。这是与 BotFather 互动以及测试机器人的必要条件。

II. 注册 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 创建机器人

1. 打开 Telegram 应用，在搜索栏中输入 BotFather，点击进入对话。
2. 输入 /newbot 命令开始创建新机器人。
3. 按提示依次输入机器人的名称（显示名）和用户名（必须以 bot 结尾，如 MyFirstBot）。

4. BotFather 会生成一个唯一的 Token，格式如下：

   123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

   这是你与 Telegram API 通信的唯一凭据，请妥善保存。

   

II. 获取机器人 API 的权限

创建完成后，你可以使用 BotFather 提供的命令对机器人进行管理。例如：

• /setdescription 设置机器人的描述。
• /setcommands 配置预定义命令列表。

这些命令能够提升用户体验，为后续功能开发打下基础。

三、 在 Cloudflare Workers 部署服务

Cloudflare Workers 提供了无服务器架构，适合托管轻量级的服务逻辑。以下是部署 Worker 的完整过程。

I. 创建 Worker 服务

1. 登录 后，点击 Workers 标签。
2. 点击 Create a Service 按钮，填写服务名称（如 telegram-bot-worker）。
3. 选择 “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

四、配置 Telegram Webhook

机器人需要通过 Webhook 接收 Telegram 的消息推送。配置步骤如下：

1. 使用 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 地址。

2. 配置成功后，Telegram 会将所有用户消息推送到 Webhook 地址。

3. 验证：

   • 打开机器人对话框，发送一条消息。
   • 如果配置正确，机器人会通过 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 提供了强大的功能扩展空间。无论是个人项目还是企业应用，这种解决方案都可以满足你的需求。尝试将机器人与其他系统集成，探索更多可能性吧！