Telegram机器人生成邀请二维码的代码实现：从调用API到生成图片全攻略

在社群运营中，邀请二维码是传播效率最高的工具之一。用户只需扫描二维码即可直接加入群组或订阅频道，省去了手动搜索和点击的步骤。对于Telegram机器人开发者来说，能否通过代码自动生成邀请二维码，是构建自动化社群管理系统的关键技能。本文将手把手教你如何通过Telegram Bot API获取邀请链接，并使用二维码库将其转换为图片，最终实现机器人一键生成可分享的二维码。

实现原理与前置条件

Telegram Bot API本身并不直接返回二维码图片，但提供了创建邀请链接的方法。我们可以获取到邀请链接后，使用第三方库（如Python的qrcode、Node.js的qrcode包）将链接编码为二维码图片。整个过程分为两步：创建邀请链接和生成二维码图片。

前置条件：

已创建Telegram Bot，并获取到Bot Token（通过@BotFather获取）。
Bot必须是目标群组或频道的管理员（至少拥有“邀请用户”权限）。
开发环境已安装所需依赖（如Python的python-telegram-bot或aiogram，以及qrcode库；Node.js则需安装telegraf和qrcode）。

方法一：使用exportChatInviteLink（适用于群组和频道）

exportChatInviteLink是最简单的方法，返回一个当前有效的邀请链接。注意：如果群组已设置“不允许通过链接加入”，此方法会失败。

Python示例（使用python-telegram-bot）

import qrcode
from telegram import Bot

bot = Bot(token="YOUR_BOT_TOKEN")

# 替换为你的群组或频道ID，例如 -1001234567890
chat_id = -1001234567890

# 生成邀请链接
invite_link = bot.export_chat_invite_link(chat_id=chat_id)
print("邀请链接:", invite_link)

# 生成二维码并保存
img = qrcode.make(invite_link)
img.save("invite_qr.png")
print("二维码已保存为 invite_qr.png")

Node.js示例（使用telegraf）

const { Telegraf } = require('telegraf');
const QRCode = require('qrcode');
const bot = new Telegraf('YOUR_BOT_TOKEN');

bot.telegram.exportChatInviteLink('-1001234567890')
  .then(async (link) => {
    console.log('邀请链接:', link);
    // 生成二维码并保存为文件
    await QRCode.toFile('invite_qr.png', link, { width: 400 });
    console.log('二维码已保存');
  })
  .catch(err => console.error(err));

方法二：使用createChatInviteLink（更灵活的配置）

createChatInviteLink允许设置链接的有效期、最大使用次数等参数，适合临时或限量邀请场景。

Python示例：创建限时邀请链接

import qrcode
from telegram import Bot
from datetime import timedelta

bot = Bot(token="YOUR_BOT_TOKEN")

# 创建1小时后过期，最多使用10次的邀请链接
data = bot.create_chat_invite_link(
    chat_id=-1001234567890,
    expire_date=timedelta(hours=1),
    member_limit=10
)

invite_link = data.invite_link
print("自定义邀请链接:", invite_link)

img = qrcode.make(invite_link)
img.save("limited_qr.png")

Node.js示例：创建限制活跃成员数

const { Telegraf } = require('telegraf');
const QRCode = require('qrcode');
const bot = new Telegraf('YOUR_BOT_TOKEN');

(async () => {
  const invite = await bot.telegram.createChatInviteLink(
    '-1001234567890',
    { expire_date: Math.floor(Date.now()/1000) + 3600, member_limit: 10 }
  );
  console.log('链接:', invite.invite_link);
  await QRCode.toFile('limited_qr.png', invite.invite_link, { width: 400 });
})();

进阶：在机器人对话中动态生成二维码

上面的示例是独立脚本，但实际开发中我们通常希望用户发送指令后，机器人直接返回二维码图片。下面以Python + aiogram为例，实现/invite命令生成二维码并发送给用户。

import io
import qrcode
from aiogram import Bot, Dispatcher, executor, types

TOKEN = "YOUR_BOT_TOKEN"
bot = Bot(token=TOKEN)
dp = Dispatcher(bot)

@dp.message_handler(commands=['invite'])
async def invite_command(message: types.Message):
    # 假设Bot是管理员，此处直接使用配置的群组ID
    chat_id = -1001234567890
    try:
        link = await bot.export_chat_invite_link(chat_id)
        # 生成二维码到内存
        img = qrcode.make(link)
        buf = io.BytesIO()
        img.save(buf, format='PNG')
        buf.seek(0)
        await bot.send_photo(chat_id=message.chat.id, photo=buf, caption=f"加入我们的群组\n")
    except Exception as e:
        await message.reply(f"生成失败: ")

if __name__ == '__main__':
    executor.start_polling(dp)

在Node.js中，同样可以监听命令并返回二维码Buffer：

const { Telegraf } = require('telegraf');
const QRCode = require('qrcode');
const { stream } = require('telegraf');

const bot = new Telegraf('YOUR_BOT_TOKEN');

bot.command('invite', async (ctx) => {
  try {
    const link = await bot.telegram.exportChatInviteLink('-1001234567890');
    const qrBuffer = await QRCode.toBuffer(link, { width: 400 });
    await ctx.replyWithPhoto({ source: qrBuffer }, { caption: `扫码入群：$` });
  } catch (err) {
    await ctx.reply('生成失败：' + err.message);
  }
});

bot.launch();

常见问题与实用建议

1. 为什么调用exportChatInviteLink会提示需要管理员权限？
Bot必须被设为群组/频道管理员，且拥有“邀请用户”权限。请检查Bot权限设置。

2. 邀请链接过期后二维码还能用吗？
不能。请确保在有效期内使用，或生成后定期更新二维码。

3. 二维码图片美化
qrcode库支持在二维码中间嵌入Logo、自定义颜色，提升美观度。例如Python中：

qr = qrcode.QRCode(error_correction=qrcode.constants.ERROR_CORRECT_H)
qr.add_data(invite_link)
qr.make()
img = qr.make_image(fill_color="black", back_color="white").convert('RGB')
# 在img上叠加Logo...

4. 批量生成
如果要为多个群组生成二维码，建议将群组ID放入配置文件中循环处理，并注意Telegram API的限频限制。

总结

通过本教程，你已经掌握了Telegram机器人生成邀请二维码的完整实现。无论是简单的exportChatInviteLink还是灵活的createChatInviteLink，结合二维码库，我们都能轻松打造扫码入群体验。未来你可以将此功能集成到你的社群管理机器人中，实现自动邀请、限量邀请等高级玩法。如果遇到任何问题，欢迎查阅Telegram Bot API官方文档继续深入。