diff --git a/CHANGELOG.md b/CHANGELOG.md index 3e48c7a..e5080d3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## 3.2.0 — 2026-11-11 + +### Changed +- Updated to Telegram Bot API 10.4: new `widget_query` and `shared_widget_query` update types in the `allowed_updates` picker. + +### Added +- Menu button tab explains where the main Mini App is configured (@BotFather) and how to check that it is enabled. + ## 3.1.0 — 2026-11-04 ### Added diff --git a/README.md b/README.md index 323101d..27152f2 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Telegram Bot Manager — online webhook & bot settings tool [![Live demo](https://img.shields.io/badge/demo-online-2481cc?logo=telegram)](https://f1devbin.github.io/telegram-bot-manager/) -[![Bot API](https://img.shields.io/badge/Bot%20API-10.3-2481cc)](https://core.telegram.org/bots/api) +[![Bot API](https://img.shields.io/badge/Bot%20API-10.4-2481cc)](https://core.telegram.org/bots/api) [![Deploy](https://github.com/f1devbin/telegram-bot-manager/actions/workflows/pages.yml/badge.svg)](https://github.com/f1devbin/telegram-bot-manager/actions/workflows/pages.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE) diff --git a/docs/social-preview.png b/docs/social-preview.png index 9d7b5e4..19e1508 100644 Binary files a/docs/social-preview.png and b/docs/social-preview.png differ diff --git a/package.json b/package.json index 92e227d..827d026 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "telegram-bot-manager", - "version": "3.1.0", + "version": "3.2.0", "private": true, "description": "Free online Telegram Bot Manager: set, check and delete webhooks, edit commands, profile, menu button and admin rights right in your browser.", "type": "module", diff --git a/src/assets/img/og-image.png b/src/assets/img/og-image.png index df0497f..5439aeb 100644 Binary files a/src/assets/img/og-image.png and b/src/assets/img/og-image.png differ diff --git a/src/assets/js/data.js b/src/assets/js/data.js index 4316389..0f7ba62 100644 --- a/src/assets/js/data.js +++ b/src/assets/js/data.js @@ -1,5 +1,5 @@ // Telegram Bot API reference data. Keep in sync with https://core.telegram.org/bots/api -export const BOT_API_VERSION = '10.3'; +export const BOT_API_VERSION = '10.4'; export const DEFAULT_API_BASE = 'https://api.telegram.org'; @@ -25,6 +25,8 @@ export const UPDATE_GROUPS = [ { type: 'message_reaction', optIn: true }, { type: 'message_reaction_count', optIn: true }, { type: 'stopped_message_generation' }, + { type: 'widget_query' }, + { type: 'shared_widget_query' }, ], }, { diff --git a/src/i18n/en.json b/src/i18n/en.json index 5a66aee..20bfcfb 100644 --- a/src/i18n/en.json +++ b/src/i18n/en.json @@ -126,6 +126,7 @@ "menu": { "title": "Menu button", "intro": "The button next to the message field in private chats: opens the command list or your Web App (Mini App).", + "miniAppHint": "The main Mini App (the “Open” button in the bot profile) can be set up only in @BotFather → /mybots → Bot Settings → Configure Mini App; extra Mini Apps with their own links are created with /newapp. Whether the main Mini App is enabled is shown under “Capabilities” on the left.", "chatId": "Private chat ID (optional)", "chatIdPlaceholder": "Empty = default for all chats", "typeDefault": "Default", @@ -412,6 +413,8 @@ "message_reaction": "Reactions by users", "message_reaction_count": "Anonymous reaction counts", "stopped_message_generation": "User stopped message generation", + "widget_query": "Widget queries", + "shared_widget_query": "Shared widget queries", "my_chat_member": "Bot added, removed or blocked", "chat_member": "Member status changes", "chat_join_request": "Join requests", diff --git a/src/i18n/es.json b/src/i18n/es.json index aa9ccab..d76e9d6 100644 --- a/src/i18n/es.json +++ b/src/i18n/es.json @@ -126,6 +126,7 @@ "menu": { "title": "Botón de menú", "intro": "El botón junto al campo de texto en los chats privados: abre la lista de comandos o tu Web App (Mini App).", + "miniAppHint": "La Mini App principal (el botón «Open» del perfil del bot) solo se configura en @BotFather → /mybots → Bot Settings → Configure Mini App; las Mini Apps adicionales con enlace propio se crean con /newapp. Si la Mini App principal está activada se ve a la izquierda, en «Capacidades».", "chatId": "ID del chat privado (opcional)", "chatIdPlaceholder": "Vacío = por defecto para todos los chats", "typeDefault": "Por defecto", @@ -412,6 +413,8 @@ "message_reaction": "Reacciones de usuarios", "message_reaction_count": "Recuentos de reacciones anónimas", "stopped_message_generation": "El usuario detuvo la generación", + "widget_query": "Consultas de widgets", + "shared_widget_query": "Consultas de widgets compartidos", "my_chat_member": "Bot añadido, eliminado o bloqueado", "chat_member": "Cambios de estado de miembros", "chat_join_request": "Solicitudes de acceso", diff --git a/src/i18n/pt.json b/src/i18n/pt.json index 5588cee..bd98229 100644 --- a/src/i18n/pt.json +++ b/src/i18n/pt.json @@ -126,6 +126,7 @@ "menu": { "title": "Botão de menu", "intro": "O botão ao lado do campo de mensagem em chats privados: abre a lista de comandos ou seu Web App (Mini App).", + "miniAppHint": "O Mini App principal (o botão “Open” no perfil do bot) só pode ser configurado no @BotFather → /mybots → Bot Settings → Configure Mini App; Mini Apps adicionais com link próprio são criados com /newapp. Se o Mini App principal está ativado aparece à esquerda, em “Recursos”.", "chatId": "ID do chat privado (opcional)", "chatIdPlaceholder": "Vazio = padrão para todos os chats", "typeDefault": "Padrão", @@ -412,6 +413,8 @@ "message_reaction": "Reações de usuários", "message_reaction_count": "Contagens de reações anônimas", "stopped_message_generation": "Usuário interrompeu a geração", + "widget_query": "Consultas de widgets", + "shared_widget_query": "Consultas de widgets compartilhados", "my_chat_member": "Bot adicionado, removido ou bloqueado", "chat_member": "Mudanças de status de membros", "chat_join_request": "Pedidos de entrada", diff --git a/src/i18n/ru.json b/src/i18n/ru.json index b9e46cd..f532fe3 100644 --- a/src/i18n/ru.json +++ b/src/i18n/ru.json @@ -126,6 +126,7 @@ "menu": { "title": "Кнопка меню", "intro": "Кнопка рядом с полем ввода в личных чатах: открывает список команд или ваше Web App (Mini App).", + "miniAppHint": "Главное Mini App (кнопка «Open» в профиле бота) настраивается только в @BotFather → /mybots → Bot Settings → Configure Mini App; дополнительные Mini App со своими ссылками создаются командой /newapp. Включено ли главное Mini App, видно слева в блоке «Возможности».", "chatId": "ID личного чата (необязательно)", "chatIdPlaceholder": "Пусто = по умолчанию для всех чатов", "typeDefault": "По умолчанию", @@ -161,20 +162,61 @@ "point3": "Показывает ошибки вебхука с подсказками, как их исправить", "featuresTitle": "Всё, чего нет в BotFather, — в одном месте", "features": [ - { "icon": "🌐", "title": "Управление вебхуком", "text": "setWebhook с секретным токеном, allowed_updates, max_connections, фиксированным IP и самоподписанным сертификатом. Безопасное удаление вебхука и очистка очереди." }, - { "icon": "🩺", "title": "Проверка getWebhookInfo", "text": "Очередь обновлений, последняя ошибка доставки и ошибки синхронизации в вашем часовом поясе — с подсказками по SSL, DNS, таймаутам и HTTP-ошибкам." }, - { "icon": "📜", "title": "Редактор команд", "text": "setMyCommands в виде простого текста с проверкой — для каждой области (личные чаты, группы, админы, конкретный чат) и языка." }, - { "icon": "📝", "title": "Профиль и аватар", "text": "Имя бота, короткое и полное описание на любом языке. Загрузка фото или видеоаватара и его удаление." }, - { "icon": "📱", "title": "Кнопка меню", "text": "Переключайте кнопку меню между командами и вашим Mini App (Web App) — для всех чатов или для одного." }, - { "icon": "🛡", "title": "Права администратора", "text": "Права по умолчанию для групп и каналов, включая новые права из Bot API {botApiVersion}." }, - { "icon": "🧰", "title": "Инструменты разработчика", "text": "Сырые JSON-ответы, журнал запросов и готовая команда curl для каждого действия." }, - { "icon": "🌍", "title": "5 языков, тёмная тема", "text": "English, Русский, Español, Português и 简体中文. Светлая и тёмная темы, удобно на телефоне." } + { + "icon": "🌐", + "title": "Управление вебхуком", + "text": "setWebhook с секретным токеном, allowed_updates, max_connections, фиксированным IP и самоподписанным сертификатом. Безопасное удаление вебхука и очистка очереди." + }, + { + "icon": "🩺", + "title": "Проверка getWebhookInfo", + "text": "Очередь обновлений, последняя ошибка доставки и ошибки синхронизации в вашем часовом поясе — с подсказками по SSL, DNS, таймаутам и HTTP-ошибкам." + }, + { + "icon": "📜", + "title": "Редактор команд", + "text": "setMyCommands в виде простого текста с проверкой — для каждой области (личные чаты, группы, админы, конкретный чат) и языка." + }, + { + "icon": "📝", + "title": "Профиль и аватар", + "text": "Имя бота, короткое и полное описание на любом языке. Загрузка фото или видеоаватара и его удаление." + }, + { + "icon": "📱", + "title": "Кнопка меню", + "text": "Переключайте кнопку меню между командами и вашим Mini App (Web App) — для всех чатов или для одного." + }, + { + "icon": "🛡", + "title": "Права администратора", + "text": "Права по умолчанию для групп и каналов, включая новые права из Bot API {botApiVersion}." + }, + { + "icon": "🧰", + "title": "Инструменты разработчика", + "text": "Сырые JSON-ответы, журнал запросов и готовая команда curl для каждого действия." + }, + { + "icon": "🌍", + "title": "5 языков, тёмная тема", + "text": "English, Русский, Español, Português и 简体中文. Светлая и тёмная темы, удобно на телефоне." + } ], "howTitle": "Как это работает", "steps": [ - { "title": "Вставьте токен бота", "text": "Скопируйте токен у @BotFather и нажмите «Подключить»." }, - { "title": "Проверьте состояние", "text": "Вебхук, очередь обновлений, ошибки и возможности бота — на одном экране." }, - { "title": "Измените настройки", "text": "Отредактируйте и сохраните — каждое действие напрямую вызывает официальный метод Bot API." } + { + "title": "Вставьте токен бота", + "text": "Скопируйте токен у @BotFather и нажмите «Подключить»." + }, + { + "title": "Проверьте состояние", + "text": "Вебхук, очередь обновлений, ошибки и возможности бота — на одном экране." + }, + { + "title": "Измените настройки", + "text": "Отредактируйте и сохраните — каждое действие напрямую вызывает официальный метод Bot API." + } ], "securityTitle": "Ваш токен остаётся у вас", "security": [ @@ -186,14 +228,38 @@ "guidesTitle": "Инструкции", "faqTitle": "Частые вопросы", "faq": [ - { "q": "Безопасно ли вводить здесь токен бота?", "a": "Страница полностью статическая, бэкенда нет. Токен используется только в вашем браузере для вызова Telegram Bot API и больше никуда не отправляется. Можно проверить открытый код или развернуть свою копию. Если токен утёк, отзовите его в @BotFather → /revoke." }, - { "q": "Как проверить вебхук Telegram-бота?", "a": "Подключите бота и откройте вкладку «Вебхук». Она вызывает getWebhookInfo и показывает URL, количество ожидающих обновлений, последнюю ошибку доставки со временем и подсказку, как её исправить." }, - { "q": "Как удалить вебхук и перейти на getUpdates?", "a": "Откройте «Вебхук» → «Опасная зона» → «Удалить вебхук». При желании удалите ожидающие обновления. После этого бот снова может получать обновления через getUpdates (long polling) — иначе Telegram отвечает «409 Conflict: can't use getUpdates method while webhook is active»." }, - { "q": "Почему копятся обновления, а бот не отвечает?", "a": "Telegram не может доставить обновления на ваш вебхук. Посмотрите последнюю ошибку: проблемы с SSL, ошибки DNS, таймауты или HTTP 4xx/5xx от вашего сервера. Исправьте сервер, затем при необходимости очистите очередь." }, - { "q": "Что такое allowed_updates?", "a": "Список типов обновлений, которые получает бот. По умолчанию приходит всё, кроме chat_member, message_reaction и message_reaction_count. Чтобы получать их, выберите типы явно." }, - { "q": "Можно ли задать разные команды для групп или других языков?", "a": "Да. На вкладке «Команды» выберите область (все личные чаты, все группы, администраторы, конкретный чат или участник) и язык. Telegram показывает каждому пользователю самый подходящий список." }, - { "q": "При подключении пишет «Ошибка сети». Что делать?", "a": "Ваша сеть, расширение браузера или страна может блокировать api.telegram.org. Откройте «Дополнительно: сервер API» и укажите свой прокси (в репозитории есть бесплатный шаблон для Cloudflare Workers) или локальный сервер Bot API." }, - { "q": "Это бесплатно? Можно развернуть у себя?", "a": "Да, бесплатно, лицензия MIT. Сделайте форк репозитория и включите GitHub Pages или выполните npm run build и загрузите папку dist на любой статический хостинг." } + { + "q": "Безопасно ли вводить здесь токен бота?", + "a": "Страница полностью статическая, бэкенда нет. Токен используется только в вашем браузере для вызова Telegram Bot API и больше никуда не отправляется. Можно проверить открытый код или развернуть свою копию. Если токен утёк, отзовите его в @BotFather → /revoke." + }, + { + "q": "Как проверить вебхук Telegram-бота?", + "a": "Подключите бота и откройте вкладку «Вебхук». Она вызывает getWebhookInfo и показывает URL, количество ожидающих обновлений, последнюю ошибку доставки со временем и подсказку, как её исправить." + }, + { + "q": "Как удалить вебхук и перейти на getUpdates?", + "a": "Откройте «Вебхук» → «Опасная зона» → «Удалить вебхук». При желании удалите ожидающие обновления. После этого бот снова может получать обновления через getUpdates (long polling) — иначе Telegram отвечает «409 Conflict: can't use getUpdates method while webhook is active»." + }, + { + "q": "Почему копятся обновления, а бот не отвечает?", + "a": "Telegram не может доставить обновления на ваш вебхук. Посмотрите последнюю ошибку: проблемы с SSL, ошибки DNS, таймауты или HTTP 4xx/5xx от вашего сервера. Исправьте сервер, затем при необходимости очистите очередь." + }, + { + "q": "Что такое allowed_updates?", + "a": "Список типов обновлений, которые получает бот. По умолчанию приходит всё, кроме chat_member, message_reaction и message_reaction_count. Чтобы получать их, выберите типы явно." + }, + { + "q": "Можно ли задать разные команды для групп или других языков?", + "a": "Да. На вкладке «Команды» выберите область (все личные чаты, все группы, администраторы, конкретный чат или участник) и язык. Telegram показывает каждому пользователю самый подходящий список." + }, + { + "q": "При подключении пишет «Ошибка сети». Что делать?", + "a": "Ваша сеть, расширение браузера или страна может блокировать api.telegram.org. Откройте «Дополнительно: сервер API» и укажите свой прокси (в репозитории есть бесплатный шаблон для Cloudflare Workers) или локальный сервер Bot API." + }, + { + "q": "Это бесплатно? Можно развернуть у себя?", + "a": "Да, бесплатно, лицензия MIT. Сделайте форк репозитория и включите GitHub Pages или выполните npm run build и загрузите папку dist на любой статический хостинг." + } ] }, "guides": { @@ -347,6 +413,8 @@ "message_reaction": "Реакции пользователей", "message_reaction_count": "Счётчики анонимных реакций", "stopped_message_generation": "Остановка генерации сообщения", + "widget_query": "Запросы из виджетов", + "shared_widget_query": "Запросы из общих виджетов", "my_chat_member": "Бот добавлен, удалён или заблокирован", "chat_member": "Изменение статуса участников", "chat_join_request": "Заявки на вступление", @@ -385,13 +453,34 @@ "deleted": "Команды удалены." }, "scopes": { - "default": { "label": "По умолчанию", "hint": "Используется, если к пользователю не подходит более узкая область." }, - "all_private_chats": { "label": "Все личные чаты", "hint": "Все личные чаты с ботом." }, - "all_group_chats": { "label": "Все группы", "hint": "Все группы и супергруппы." }, - "all_chat_administrators": { "label": "Админы всех групп", "hint": "Администраторы всех групп и супергрупп." }, - "chat": { "label": "Конкретный чат", "hint": "Один чат по ID или @username (каналы не поддерживаются)." }, - "chat_administrators": { "label": "Админы чата", "hint": "Администраторы одного конкретного чата." }, - "chat_member": { "label": "Участник чата", "hint": "Один пользователь в одном конкретном чате." } + "default": { + "label": "По умолчанию", + "hint": "Используется, если к пользователю не подходит более узкая область." + }, + "all_private_chats": { + "label": "Все личные чаты", + "hint": "Все личные чаты с ботом." + }, + "all_group_chats": { + "label": "Все группы", + "hint": "Все группы и супергруппы." + }, + "all_chat_administrators": { + "label": "Админы всех групп", + "hint": "Администраторы всех групп и супергрупп." + }, + "chat": { + "label": "Конкретный чат", + "hint": "Один чат по ID или @username (каналы не поддерживаются)." + }, + "chat_administrators": { + "label": "Админы чата", + "hint": "Администраторы одного конкретного чата." + }, + "chat_member": { + "label": "Участник чата", + "hint": "Один пользователь в одном конкретном чате." + } }, "menu": { "saved": "Кнопка меню сохранена." diff --git a/src/i18n/zh.json b/src/i18n/zh.json index 799ee3f..f66d0ab 100644 --- a/src/i18n/zh.json +++ b/src/i18n/zh.json @@ -126,6 +126,7 @@ "menu": { "title": "菜单按钮", "intro": "私聊中输入框旁的按钮:打开命令列表或你的 Web App(小程序)。", + "miniAppHint": "主小程序(机器人资料页中的“Open”按钮)只能在 @BotFather → /mybots → Bot Settings → Configure Mini App 中设置;带独立链接的其他小程序通过 /newapp 创建。主小程序是否已启用,可在左侧“功能”中查看。", "chatId": "私聊 ID(可选)", "chatIdPlaceholder": "留空 = 所有聊天的默认设置", "typeDefault": "默认", @@ -161,20 +162,61 @@ "point3": "显示 Webhook 错误并给出修复提示", "featuresTitle": "BotFather 做不到的,这里一站搞定", "features": [ - { "icon": "🌐", "title": "Webhook 管理", "text": "setWebhook 支持 Secret Token、allowed_updates、max_connections、固定 IP 和自签名证书。安全地删除 Webhook 或丢弃待处理更新。" }, - { "icon": "🩺", "title": "getWebhookInfo 检查", "text": "以本地时间显示待处理更新、最近的投递错误和同步错误,并针对 SSL、DNS、超时和 HTTP 错误给出提示。" }, - { "icon": "📜", "title": "命令编辑器", "text": "以纯文本编辑 setMyCommands 并自动校验,支持不同范围(私聊、群组、管理员、指定聊天)和语言。" }, - { "icon": "📝", "title": "资料和头像", "text": "以任意语言设置机器人名称、简短描述和描述。上传或删除照片或视频头像。" }, - { "icon": "📱", "title": "菜单按钮", "text": "在命令列表和你的小程序(Web App)之间切换菜单按钮,可全局设置,也可针对单个聊天。" }, - { "icon": "🛡", "title": "管理员权限", "text": "群组和频道的默认管理员权限,包括 Bot API {botApiVersion} 中的最新权限。" }, - { "icon": "🧰", "title": "开发者工具", "text": "原始 JSON 响应、请求日志,以及每个操作可直接复制的 curl 命令。" }, - { "icon": "🌍", "title": "5 种语言,深色模式", "text": "English、Русский、Español、Português 和简体中文。浅色和深色主题,支持手机。" } + { + "icon": "🌐", + "title": "Webhook 管理", + "text": "setWebhook 支持 Secret Token、allowed_updates、max_connections、固定 IP 和自签名证书。安全地删除 Webhook 或丢弃待处理更新。" + }, + { + "icon": "🩺", + "title": "getWebhookInfo 检查", + "text": "以本地时间显示待处理更新、最近的投递错误和同步错误,并针对 SSL、DNS、超时和 HTTP 错误给出提示。" + }, + { + "icon": "📜", + "title": "命令编辑器", + "text": "以纯文本编辑 setMyCommands 并自动校验,支持不同范围(私聊、群组、管理员、指定聊天)和语言。" + }, + { + "icon": "📝", + "title": "资料和头像", + "text": "以任意语言设置机器人名称、简短描述和描述。上传或删除照片或视频头像。" + }, + { + "icon": "📱", + "title": "菜单按钮", + "text": "在命令列表和你的小程序(Web App)之间切换菜单按钮,可全局设置,也可针对单个聊天。" + }, + { + "icon": "🛡", + "title": "管理员权限", + "text": "群组和频道的默认管理员权限,包括 Bot API {botApiVersion} 中的最新权限。" + }, + { + "icon": "🧰", + "title": "开发者工具", + "text": "原始 JSON 响应、请求日志,以及每个操作可直接复制的 curl 命令。" + }, + { + "icon": "🌍", + "title": "5 种语言,深色模式", + "text": "English、Русский、Español、Português 和简体中文。浅色和深色主题,支持手机。" + } ], "howTitle": "使用方法", "steps": [ - { "title": "粘贴机器人 Token", "text": "从 @BotFather 复制 Token,然后点击“连接”。" }, - { "title": "查看状态", "text": "Webhook、待处理更新、错误和机器人功能一目了然。" }, - { "title": "修改设置", "text": "编辑并保存——每个操作都直接调用官方 Bot API 方法。" } + { + "title": "粘贴机器人 Token", + "text": "从 @BotFather 复制 Token,然后点击“连接”。" + }, + { + "title": "查看状态", + "text": "Webhook、待处理更新、错误和机器人功能一目了然。" + }, + { + "title": "修改设置", + "text": "编辑并保存——每个操作都直接调用官方 Bot API 方法。" + } ], "securityTitle": "Token 只属于你", "security": [ @@ -186,14 +228,38 @@ "guidesTitle": "教程", "faqTitle": "常见问题", "faq": [ - { "q": "在这里输入机器人 Token 安全吗?", "a": "页面是完全静态的,没有后端。Token 只在你的浏览器中用于调用 Telegram Bot API,不会发送到其他任何地方。你可以审查开源代码或部署自己的副本。如果怀疑 Token 泄露,请在 @BotFather → /revoke 中撤销。" }, - { "q": "如何检查 Telegram 机器人的 Webhook?", "a": "连接机器人并打开 Webhook 选项卡。它会调用 getWebhookInfo,显示 URL、待处理更新数量、最近一次投递错误及其时间,并给出修复提示。" }, - { "q": "如何删除 Webhook 并改用 getUpdates?", "a": "打开 Webhook → 危险操作 → 删除 Webhook,可选择同时丢弃待处理更新。之后机器人即可通过 getUpdates(长轮询)接收更新——否则 Telegram 会返回“409 Conflict: can't use getUpdates method while webhook is active”。" }, - { "q": "为什么待处理更新越来越多,机器人却不回复?", "a": "Telegram 无法将更新投递到你的 Webhook。查看最近的错误:SSL 问题、DNS 错误、超时,或服务器返回的 HTTP 4xx/5xx。修复服务器后,可按需丢弃队列中的更新。" }, - { "q": "allowed_updates 是什么?", "a": "机器人接收的更新类型列表。默认接收除 chat_member、message_reaction 和 message_reaction_count 之外的所有类型。如需接收这三种,请显式选择。" }, - { "q": "可以为群组或其他语言设置不同的命令吗?", "a": "可以。在“命令”选项卡中选择范围(所有私聊、所有群组、管理员、指定聊天或成员)和语言。Telegram 会为每个用户显示最匹配的列表。" }, - { "q": "连接时提示“网络错误”,怎么办?", "a": "你的网络、浏览器扩展或所在地区可能屏蔽了 api.telegram.org。打开“高级:API 服务器”,使用自己的代理(仓库中提供免费的 Cloudflare Workers 模板)或本地 Bot API 服务器。" }, - { "q": "免费吗?可以自行部署吗?", "a": "免费,采用 MIT 许可证。Fork 仓库并启用 GitHub Pages,或运行 npm run build 并将 dist 文件夹上传到任意静态托管。" } + { + "q": "在这里输入机器人 Token 安全吗?", + "a": "页面是完全静态的,没有后端。Token 只在你的浏览器中用于调用 Telegram Bot API,不会发送到其他任何地方。你可以审查开源代码或部署自己的副本。如果怀疑 Token 泄露,请在 @BotFather → /revoke 中撤销。" + }, + { + "q": "如何检查 Telegram 机器人的 Webhook?", + "a": "连接机器人并打开 Webhook 选项卡。它会调用 getWebhookInfo,显示 URL、待处理更新数量、最近一次投递错误及其时间,并给出修复提示。" + }, + { + "q": "如何删除 Webhook 并改用 getUpdates?", + "a": "打开 Webhook → 危险操作 → 删除 Webhook,可选择同时丢弃待处理更新。之后机器人即可通过 getUpdates(长轮询)接收更新——否则 Telegram 会返回“409 Conflict: can't use getUpdates method while webhook is active”。" + }, + { + "q": "为什么待处理更新越来越多,机器人却不回复?", + "a": "Telegram 无法将更新投递到你的 Webhook。查看最近的错误:SSL 问题、DNS 错误、超时,或服务器返回的 HTTP 4xx/5xx。修复服务器后,可按需丢弃队列中的更新。" + }, + { + "q": "allowed_updates 是什么?", + "a": "机器人接收的更新类型列表。默认接收除 chat_member、message_reaction 和 message_reaction_count 之外的所有类型。如需接收这三种,请显式选择。" + }, + { + "q": "可以为群组或其他语言设置不同的命令吗?", + "a": "可以。在“命令”选项卡中选择范围(所有私聊、所有群组、管理员、指定聊天或成员)和语言。Telegram 会为每个用户显示最匹配的列表。" + }, + { + "q": "连接时提示“网络错误”,怎么办?", + "a": "你的网络、浏览器扩展或所在地区可能屏蔽了 api.telegram.org。打开“高级:API 服务器”,使用自己的代理(仓库中提供免费的 Cloudflare Workers 模板)或本地 Bot API 服务器。" + }, + { + "q": "免费吗?可以自行部署吗?", + "a": "免费,采用 MIT 许可证。Fork 仓库并启用 GitHub Pages,或运行 npm run build 并将 dist 文件夹上传到任意静态托管。" + } ] }, "guides": { @@ -347,6 +413,8 @@ "message_reaction": "用户表情回应", "message_reaction_count": "匿名表情回应计数", "stopped_message_generation": "用户停止了消息生成", + "widget_query": "小部件查询", + "shared_widget_query": "共享小部件查询", "my_chat_member": "机器人被添加、移除或屏蔽", "chat_member": "成员状态变化", "chat_join_request": "入群申请", @@ -385,13 +453,34 @@ "deleted": "命令已删除。" }, "scopes": { - "default": { "label": "默认", "hint": "没有更具体的范围适用于用户时使用。" }, - "all_private_chats": { "label": "所有私聊", "hint": "与机器人的所有私聊。" }, - "all_group_chats": { "label": "所有群组", "hint": "所有群组和超级群组。" }, - "all_chat_administrators": { "label": "所有群管理员", "hint": "所有群组和超级群组的管理员。" }, - "chat": { "label": "指定聊天", "hint": "通过 ID 或 @username 指定一个聊天(不支持频道)。" }, - "chat_administrators": { "label": "指定聊天的管理员", "hint": "某一个聊天的管理员。" }, - "chat_member": { "label": "指定聊天的成员", "hint": "某一个聊天中的一个用户。" } + "default": { + "label": "默认", + "hint": "没有更具体的范围适用于用户时使用。" + }, + "all_private_chats": { + "label": "所有私聊", + "hint": "与机器人的所有私聊。" + }, + "all_group_chats": { + "label": "所有群组", + "hint": "所有群组和超级群组。" + }, + "all_chat_administrators": { + "label": "所有群管理员", + "hint": "所有群组和超级群组的管理员。" + }, + "chat": { + "label": "指定聊天", + "hint": "通过 ID 或 @username 指定一个聊天(不支持频道)。" + }, + "chat_administrators": { + "label": "指定聊天的管理员", + "hint": "某一个聊天的管理员。" + }, + "chat_member": { + "label": "指定聊天的成员", + "hint": "某一个聊天中的一个用户。" + } }, "menu": { "saved": "菜单按钮已保存。" diff --git a/src/templates/index.html b/src/templates/index.html index 0c0f48e..323809c 100644 --- a/src/templates/index.html +++ b/src/templates/index.html @@ -261,6 +261,7 @@

{{t.ui.commands.title}}

{{t.ui.menu.title}}

{{t.ui.menu.intro}}

+

{{{t.ui.menu.miniAppHint}}}