Управление ботом из Telegram
Telegram-бот — кабинет в телефоне: включить бота, сменить название и игру стрима, пропустить песню, поправить модерацию — не открывая браузер. Сюда же приходят напоминания по каналу, разбор после эфира и кнопки быстрых действий на старте стрима.
Содержание
Коротко
- Привяжите Telegram в кабинете: Платформы → Telegram → Подключить.
- Всё управление — в меню /menu; ссылки для OBS — /obs, справка — /help.
- На старте эфира на Twitch бот сам присылает кнопки: название, игра, пропуск песни, очередь.
Что понадобится
- Telegram на телефоне или компьютере.
- Кабинет PLGamesBot. Название и игра меняются на Twitch — для них нужен кабинет с Twitch-каналом.
- Для вопросов PLGames AI — тариф Старт, для управления каналом словами — Про.
Настройка за 4 шага
Привяжите Telegram
В кабинете откройте Платформы → Telegram и нажмите Подключить, затем Запустить в открывшемся боте. Ответ «Telegram привязан к каналу…» значит, что всё готово. Один Telegram привязывается к одному каналу.
Откройте меню
Отправьте боту /menu. Сверху — тариф и состояние бота в чате, теми же словами, что в кабинете; ниже — разделы кнопками. Что в каком разделе — в таблице ниже.
Поменяйте название или игру
📡 Управление стримом → ✏️ Изменить название — и отправьте новое название. 🎮 Сменить игру — напишите игру; если точного совпадения нет, бот предложит до пяти категорий Twitch на выбор. Бот ответит «✅ Название обновлено» или «✅ Игра изменена на…».
Выберите, что присылать вам
📢 Уведомления → 📬 Уведомления мне: напоминания по каналу, разбор после эфира, сводки и советы, конец тарифа. Под каждым таким письмом есть кнопка 🔕 Не присылать такие; выключенное не пропадает, а тихо ложится в ленту кабинета.
Как это работает
Меню работает через тот же кабинет: что вы меняете в Telegram, сразу видно на сайте, и наоборот. Кнопка ▶️ Включить бота — тот же тумблер, что на главной кабинета; выключение бот переспросит.
Когда начинается эфир на Twitch, бот присылает «🔴 Стрим начался!» с кнопками ✏ Название, 🎮 Игра, ⏭ Скип и 📋 Очередь — они работают, даже если меню закрыто. После такого эфира на тарифе Старт и выше приходит его разбор.
🤖 AI: предложить названия придумывает варианты названия стрима на любом тарифе — в пределах AI-запросов тарифа, на Бесплатном их 5 в день. Та же кнопка — 💡 Сгенерировать название стрима в 🛡️ Модерация → 🤖 PLGames AI. 💬 Спросить PLGames AI на Старте отвечает на вопросы про канал и эфиры, а на Про ещё и выполняет просьбы словами: сменить игру или название, пропустить песню, поставить напоминание, запустить голосование или розыгрыш. Пока PLGames AI думает над ответом, другие ваши нажатия отвечают «Секунду — ещё выполняю прошлое действие».
Где бот ждёт от вас текст (таймаут, запрещённое слово, команда, тон ответов, приветствие), есть кнопка ◀️ Отмена: вернуться в раздел, ничего не меняя.
Меню открывается только в личке с ботом. В группе на /menu, /obs и /start бот отвечает одной строкой — куда написать: тариф, кнопки и ссылки с личным ключом там увидели бы все.
Меню засыпает через 30 минут без нажатий. Старые кнопки тогда отвечают «Эта кнопка уже не действует — откройте меню заново: /menu».
В браузере те же действия собраны в Пульте. Очередь и плеер описаны в настройке заказа музыки.
Что есть в меню /menu
| Раздел | Что можно сделать |
|---|---|
| ▶️ Включить бота, ⏸ Выключить бота | Включить или выключить бота в чате — как тумблер на главной кабинета. |
| 📊 В эфире или Не в эфире | Канал, идёт ли эфир, фолловеры; во время эфира — ещё зрители и игра. |
| 📡 Управление стримом | Название и игра на Twitch, пропуск песни, очередь заказов, AI: предложить названия, Спросить PLGames AI. |
| 🎵 Музыка | Включить или выключить команду !заказ и посмотреть, запущен ли плеер; в очереди — пропустить играющую, убрать заказ, очистить очередь. |
| 🛡️ Модерация | 🤖 PLGames AI: AI-модерация, ответы в чате, тон, отчёт после эфира (модерация, разговор, тон и отчёт — с тарифа Старт), названия стрима, память. В Twitch — фильтры спама, капса и ссылок и длина таймаута; что бот делает за повторные нарушения, задаётся в кабинете: «Модерация → Система предупреждений». 💬 Модерация Telegram — для ваших групп: запрещённые слова, фильтр ссылок, фильтр медиа (фото, видео, GIF, стикеры, голосовые, кружки, музыка, файлы) и приветствие новичков. Слова и ссылки проверяются и в подписи к фото или видео, а ссылка, спрятанная под словом, — тоже ссылка. 🚫 Фильтры слов — один список для чата Twitch и групп; ещё — журнал модерации. |
| ⚙️ Команды | Добавить свою команду, включить, выключить или удалить. Имя встроенной команды бота (!голос, !игра…) занять нельзя. |
| 📢 Уведомления | Оповещения о начале эфира: общий выключатель, шаблон, тест, выбор площадок (если их несколько), группы и каналы с ботом — тест, выключатель, удаление; каналы Discord и PLGames Voice; «📬 Уведомления мне». |
| 👥 Группы | Telegram-группы и каналы, куда добавлен бот, и включены ли в них оповещения; «ℹ️ Как подключить группу» — что бот делает в группе и где это включается. |
| 🎲 Мини-игры, 🏆 Уровни | Игры в чате (!рулетка, !шар, !кубик, !фортуна, !дуэль), уровни зрителей и объявления о новом уровне. |
| 📈 Статистика | Фолловеры, текущая игра и последние эфиры: пик зрителей и сообщения. |
| 📅 Расписание | Эфиры по дням недели; за 15 минут до эфира — напоминание в ваши группы и каналы. |
| 🚀 Что нового | Последние новости продукта — те же, что в кабинете. |
Если не работает
На /menu бот отвечает «Вы не авторизованы»
Этот Telegram не привязан к кабинету. Привяжите его: Платформы → Telegram → Подключить. Команда /start без кнопки предлагает войти через Twitch — это подходит, только если кабинет у вас на Twitch.
Кнопка отвечает «Эта кнопка уже не действует»
Меню уснуло: прошло больше 30 минут без нажатий или бот перезапускался. Отправьте /menu — откроется свежее.
Не получилось сменить название или игру
Бот пишет причину. Если Twitch отозвал наш доступ к каналу, в сообщении будет ссылка для повторного входа через Twitch — пройдите её, и название с игрой снова будут меняться.
«Спросить PLGames AI» отвечает, что PLGames AI доступен с тарифа Старт
Вопросы PLGames AI — с тарифа Старт, просьбы словами — на Про. На Бесплатном работают 🤖 AI: предложить названия и 💡 Сгенерировать название стрима — пять AI-запросов в день, общих на обе кнопки.
В группе на /menu бот пишет «Меню и настройки бота — в личных сообщениях»
Так и задумано: меню, /obs и /start работают только в личке с ботом. Откройте бота по ссылке из этого ответа и отправьте /menu там.
Бот не приветствует новичков в группе
Приветствию нужен текст: 🛡️ Модерация → 💬 Модерация Telegram → 📝 Приветствие новичков, выберите группу и напишите его; {user} — имя участника. Группа должна быть подключена — она видна в 👥 Группы.
Нажал «⏭ Скип», а бот пишет «Сейчас ничего не играет»
Плеер заказов не играет: он не запущен или очередь пуста. Ссылку на плеер для OBS пришлёт /obs.
Частые вопросы
Это тот же бот, что отвечает в чате Twitch?
Нет. В Telegram работает отдельный бот: он управляет кабинетом и присылает вам уведомления, а в чате Twitch отвечает plgames_bot. Привязка Telegram на чат не влияет.
Может ли кто-то ещё управлять моим ботом через Telegram?
Меню открывается только у Telegram-аккаунта, привязанного к каналу, а один Telegram привязывается к одному каналу. Помощнику лучше дать доступ к кабинету: Настройки → Команда — он войдёт своим Twitch-аккаунтом.
Можно ли управлять голосом?
Telegram-бот понимает текст: голосовые сообщения он не разбирает. Просьбу можно написать словами в «💬 Спросить PLGames AI» — на тарифе Про бот её выполнит.
Что бот присылает без моего запроса?
Напоминания по каналу — например, что бот без прав модератора или озвучка без плеера, разбор после эфира на тарифе Старт и выше, сводки и советы, напоминания о конце тарифа. Каждый вид выключается в «📬 Уведомления мне».
Что изменилось
- Уточнены описание и ссылки на связанные инструкции.
- «💬 Модерация Telegram» проверяет и подписи к фото и видео: запрещённое слово или ссылку больше не провести картинкой. Ссылка, спрятанная под словом, и адрес без «http» — тоже ссылки.
- 📝 Приветствие новичков в «💬 Модерация Telegram» работает: свой текст для каждой группы, {user} — имя участника (раньше кнопка отвечала «В разработке»). «Фильтр медиа» удаляет и стикеры, голосовые, кружки и музыку. 💡 Сгенерировать название стрима в разделе PLGames AI работает на Бесплатном — в пределах 5 AI-запросов в день. На экранах ввода есть ◀️ Отмена, «🔙 Вернуться» после таймаута и запрещённого слова больше не отвечает «Кнопка из другого раздела». /menu в группе не открывает меню, а подсказывает написать боту в личку. Кнопки называются «🤖 PLGames AI» и «💬 Спросить PLGames AI» — как в кабинете. «📢 Уведомления» показывает и группы и каналы, куда добавлен бот: у каждой — тест, выключатель оповещений и «🗑 Удалить» (бот выходит из группы). Стримите на нескольких площадках — там же выбор, о каких оповещать.
- Кнопка смены ключа ссылок для OBS — Обновить ключ в Настройки → Аккаунт, блок «Ключ ссылок для OBS»: ключ один на все ссылки, а кнопка стояла только на Своде.
- «⚙️ Команды» не дают назвать свою команду именем встроенной (!голос, !игра…): на такое имя отвечает сам бот, и раньше в чат уходили два ответа. Старые такие команды помечены ⚠️ и молчат — переименуйте их в кабинете на странице «Команды».
- Инструкция опубликована.
- Меню отвечает на каждое нажатие: «Пропустить играющую» и «Убрать из очереди» стали разными кнопками, а при сбое бот говорит, что не вышло.
- Кнопки на старте эфира работают и при закрытом меню; «Чат с AI» отвечает на вопросы с тарифа Старт.
Всё готово к настройке?Страница откроется в кабинете после входа через Twitch.
Открыть «Платформы → Telegram» →