玩转Telegram机器人：从自动回复到智能工具的中文使用教程

什么是Webhook？

Webhook是一种“反向API”模式。您提供一个公网可访问的URL（您的服务器地址），当用户向您的机器人发送消息时，Telegram服务器会将消息数据以HTTP POST请求的形式推送到这个URL。

这比让您的服务器不断向Telegram询问新消息（长轮询）更高效、更实时。

设置Webhook示例（Node.js）

以下是一个使用Node.js和Express框架设置Webhook的基本代码示例：

const express = require('express');
const axios = require('axios');
const app = express();
app.use(express.json());

const BOT_TOKEN = 'YOUR_BOT_TOKEN_HERE';
const WEBHOOK_URL = 'https://yourdomain.com/webhook';

// 设置Webhook端点
app.post('/webhook', (req, res) => {
    const message = req.body.message;
    console.log('收到消息:', message.text);
    // 在这里处理消息...
    res.sendStatus(200);
});

// 启动服务器后，调用Telegram API设置Webhook
app.listen(3000, async () => {
    console.log('服务器运行在端口3000');
    try {
        const response = await axios.get(`https://api.telegram.org/bot${BOT_TOKEN}/setWebhook?url=${WEBHOOK_URL}`);
        console.log('Webhook设置结果:', response.data);
    } catch (error) {
        console.error('设置Webhook失败:', error);
    }
});

增强交互性

Telegram机器人支持丰富的交互元素，让用户体验更佳。

• 自定义键盘 (ReplyKeyboardMarkup): 在聊天界面底部显示一组自定义按钮。
• 内联键盘 (InlineKeyboardMarkup): 直接附加在消息下方的按钮，点击后触发回调。
• 命令菜单 (Bot Commands): 通过 /setcommands 向BotFather设置，用户输入 / 时显示。

创建内联键盘示例 (Python-telegram-bot)

from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update
from telegram.ext import Updater, CommandHandler, CallbackQueryHandler, CallbackContext

def start(update: Update, context: CallbackContext) -> None:
    """发送带有内联键盘的欢迎消息"""
    keyboard = [
        [
            InlineKeyboardButton("选项 1", callback_data='1'),
            InlineKeyboardButton("选项 2", callback_data='2'),
        ],
        [InlineKeyboardButton("关于我们", callback_data='about')],
        [InlineKeyboardButton("打开网站", url='https://cuh-telegram.com.cn')],
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)
    update.message.reply_text('请选择一个选项：', reply_markup=reply_markup)

def button_callback(update: Update, context: CallbackContext) -> None:
    """处理内联键盘按钮的回调"""
    query = update.callback_query
    query.answer() # 确认收到回调
    data = query.data
    if data == '1':
        text = '您选择了选项 1！'
    elif data == '2':
        text = '您选择了选项 2！'
    elif data == 'about':
        text = '这是一个演示用的Telegram机器人。'
    else:
        text = '未知选项。'
    query.edit_message_text(text=text)

def main():
    updater = Updater("YOUR_BOT_TOKEN")
    dispatcher = updater.dispatcher
    dispatcher.add_handler(CommandHandler("start", start))
    dispatcher.add_handler(CallbackQueryHandler(button_callback))
    updater.start_polling()
    updater.idle()

if __name__ == '__main__':
    main()