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
[](https://f1devbin.github.io/telegram-bot-manager/)
-[](https://core.telegram.org/bots/api)
+[](https://core.telegram.org/bots/api)
[](https://github.com/f1devbin/telegram-bot-manager/actions/workflows/pages.yml)
[](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.menu.intro}}
+{{{t.ui.menu.miniAppHint}}}