You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Telegram bot中实现Spin Wheel弹窗,求相关方法、示例及API文档

Telegram 「Spin Wheel」转盘弹窗实现说明

你搜索不到对应原生API的原因是:该转盘弹窗并非Telegram Bot API提供的官方标准组件,所有转盘相关的UI、交互逻辑都由开发者自定义开发,基于Telegram Web App能力实现弹窗唤起和数据通信。

核心依赖的Telegram API能力

  • Web App唤起能力:调用answerCallbackQuery方法,传入自定义开发的转盘页面地址,Telegram客户端会自动以弹窗形式打开对应页面,适配尺寸后即可实现截图中的效果
  • 跨端通信能力:Web页面引入Telegram官方Web App JS SDK,可实现转盘结果回传Bot、关闭弹窗等操作
  • 支付关联能力:如果需要付费参与抽奖,可先调用sendInvoice方法发起支付,收到支付成功回调后再唤起转盘页面即可

最小实现示例

Bot端(Python + python-telegram-bot v20+)

from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import ContextTypes

# 发送转盘入口按钮
async def send_spin_entry(update: Update, context: ContextTypes.DEFAULT_TYPE):
    keyboard = [[InlineKeyboardButton("🎯 开始抽奖", callback_data="open_spin")]]
    await update.message.reply_text("参与转盘抽奖赢奖励", reply_markup=InlineKeyboardMarkup(keyboard))

# 唤起转盘弹窗
async def open_spin_wheel(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.callback_query.answer(
        text="",
        # 替换为你自行部署的转盘Web页面地址
        url="https://自行部署的转盘页面地址",
        cache_time=0
    )

Web端转盘页面核心代码

<!DOCTYPE html>
<html>
<head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <!-- 引入Telegram官方Web App JS SDK -->
    <style>
        /* 自行编写转盘UI样式、转动动画逻辑 */
    </style>
</head>
<body>
    <!-- 转盘DOM结构、UI自行实现 -->
    <button id="spinBtn">转动转盘</button>
    <script>
        const tg = window.Telegram.WebApp;
        // 适配页面高度,隐藏Telegram默认顶部控件
        tg.expand();

        document.getElementById('spinBtn').addEventListener('click', () => {
            // 自行实现转盘转动、抽奖结果生成逻辑
            const result = {reward: "50积分", code: "success"};
            // 回传结果到Bot后端
            tg.sendData(JSON.stringify(result));
            // 关闭弹窗
            tg.close();
        })
    </script>
</body>
</html>

注意事项

  • 部署的转盘页面必须使用HTTPS协议,否则Telegram客户端无法正常加载
  • 抽奖逻辑建议在后端做二次校验,不要完全信任前端回传的结果,避免恶意刷取奖励
  • 弹窗尺寸会自动适配Web页面的视口设置,无需额外调用API调整

内容的提问来源于stack exchange,提问作者W.K.C

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.25 22:45:05