使用 Node.js 开发 Telegram Bot 完整指南

前言

Telegram Bot 是一种自动化程序，可以在 Telegram 平台上与用户进行交互。通过 Telegram Bot API，我们可以创建功能强大的机器人，从简单的问答系统到复杂的自动化工具。本文将详细介绍如何使用 Node.js 从零开始开发一个 Telegram Bot。

什么是 Telegram Bot？

Telegram Bot 是运行在 Telegram 平台上的第三方应用程序，它可以：

自动回复消息：响应用户的文本、图片、文件等
提供交互式界面：使用按钮、内联键盘等组件
执行自动化任务：定时发送消息、监控数据、管理群组等
集成外部服务：连接 API、数据库、支付系统等

常见应用场景：

客服机器人
通知推送系统
投票和问卷调查
游戏和娱乐
群组管理工具

依赖安装

在开始之前，确保你的 Node.js 环境已安装并配置好。接下来，按照以下步骤创建并设置你的 Telegram Bot 项目：

1. 创建 Telegram Bot

打开 Telegram，搜索 @BotFather。
发送 /newbot 命令，按照提示创建一个新 Bot。
获取到 API Token，记录下来。

2. 初始化 Node.js 项目

在你的终端中，执行以下命令来初始化新的 Node.js 项目：

bash 复制代码

mkdir my-telegram-bot
cd my-telegram-bot
npm init -y

3. 安装必要的库

安装 node-telegram-bot-api 库，用于与 Telegram Bot API 交互：

bash 复制代码

npm install node-telegram-bot-api

编写 Bot 逻辑

在项目根目录下创建一个 bot.js 文件，并添加以下代码：

javascript 复制代码

// 引入库
const TelegramBot = require('node-telegram-bot-api');

// 使用你的 Bot API Token
const token = 'YOUR_TELEGRAM_BOT_TOKEN'; // 替换为实际的 Token
const bot = new TelegramBot(token, { polling: true });

// 监听 /start 命令
bot.onText(/\/start/, (msg) => {
    const chatId = msg.chat.id;
    bot.sendMessage(chatId, '欢迎使用我的 Telegram Bot！');
});

// 监听 /help 命令
bot.onText(/\/help/, (msg) => {
    const chatId = msg.chat.id;
    bot.sendMessage(chatId, '可以使用以下命令:\n/start - 启动 Bot\n/help - 获取帮助');
});

// 监听文本消息并回复
bot.on('message', (msg) => {
    const chatId = msg.chat.id;
    const userMessage = msg.text;

    // 回复用户发送的消息
    bot.sendMessage(chatId, `你说: ${userMessage}`);
});

// 错误处理
bot.on('polling_error', (error) => {
    console.error(`Polling error: ${error.code}`); // 打印错误信息
});

启动 Bot

在终端中运行以下命令启动你的 Bot：

bash 复制代码

node bot.js

测试 Bot

在 Telegram 中找到你的 Bot，发送 /start 命令，Bot 应该会回复欢迎信息。
发送 /help 命令，Bot 会提供可用命令的列表。
发送任意文本消息，Bot 会回复你发送的内容。

总结

通过以上步骤，你成功创建了一个基本的 Telegram Bot。这个 Bot 能够响应用户的命令和消息。你可以根据需求扩展更多功能，如命令处理、状态管理、外部 API 调用等。希望这篇指南能帮助你快速入门 Telegram Bot 开发！