LOLBOT
Все разделы документации
МОДУЛИ

Оповещения

Оповещения LOLBOT о начале эфиров Twitch и YouTube, новых видео, Shorts, записях и видео ВКонтакте и записях RSS-лент в канале Lolka: настройка правила, текст с переменными, тестовая отправка, месячный лимит и история доставки.

Что делает модуль#

Бот сообщает в канал вашего сервера о новых событиях на Twitch, YouTube и ВКонтакте и о новых записях сайтов с RSS-лентой:

ПлатформаСобытия
TwitchНачало эфира
YouTubeНовые публичные видео (включая Shorts) и начало запланированных эфиров
ВКонтактеНовые записи на стене и новые видео открытого сообщества или страницы
RSSНовые записи RSS- или Atom-ленты сайта: новости, блог, подкаст

Для каждого автора или ленты создаётся отдельное правило со своим каналом и текстом.

Где найти#

Кабинет → Модули → Оповещения. Список правил с поиском; настройка и история доставки открываются в отдельном окне.

Быстрый старт#

  1. Нажмите «Новое оповещение».
  2. Выберите Платформу и вставьте Ссылку на канал, например https://twitch.tv/имя или https://youtube.com/@имя. Для ВКонтакте — ссылку на открытое сообщество или страницу: https://vk.com/имя, https://vk.com/club123 или https://vkvideo.ru/@имя. Для RSS вставьте адрес ленты (https://example.com/feed) или просто страницу сайта: если сайт указывает свою ленту, бот найдёт её сам.
  3. Отметьте «О чём сообщать» и выберите Канал Lolka.
  4. Напишите Текст сообщения и проверьте предпросмотр.
  5. Отправьте тестовое оповещение — оно придёт в выбранный канал как настоящее сообщение.
  6. Включите «Включить оповещение после сохранения» и сохраните.

Совет. Для первого теста выберите закрытый тестовый канал: тестовое оповещение — это настоящее сообщение, его увидят все участники канала.

Настройки#

ПолеЧто делает
ПлатформаTwitch, YouTube, ВКонтакте или RSS-лента
Ссылка на каналКанал автора на платформе. Для ВКонтакте — «Ссылка на сообщество или страницу», для RSS — «Ссылка на ленту или сайт»
О чём сообщать«Начало эфира», «Видео и Shorts»; для ВКонтакте — «Записи на стене», «Новые видео»; для RSS — «Новые записи»
Канал LolkaТекстовый канал для оповещений
Упоминание ролиПока недоступно: упоминания ролей проходят проверку совместимости с Lolka
Текст сообщенияТекст с переменными
Подпись карточкиМелкий текст внизу карточки, например {platform} или название вашего проекта. По умолчанию пусто — подписи нет. Переменные те же, до 200 символов
Включить оповещение после сохраненияУчитываются только новые события после включения; старые публикации не рассылаются

Переменные в тексте:

ПеременнаяЗначение
{author}Имя автора или название сообщества; для RSS — название ленты
{title}Название эфира, видео или записи
{url}Ссылка на эфир, видео или запись
{platform}Twitch, YouTube, ВКонтакте или RSS

Статусы правила#

«Подключаем канал», «Подключён», «Ожидает включения», «Приостановлено». Статус «Ожидает подключения владельцем LOLBOT» значит, что платформа ещё не подключена на стороне LOLBOT — от вас ничего не требуется.

История доставки#

Результаты отправки каждого оповещения, в том числе тестовых: «В очереди», «Отправляется», «Отправлено», «Не отправлено», «Проверьте результат».

Месячный лимит#

У каждого сервера есть месячный лимит отправленных оповещений — отдельно для YouTube, Twitch, ВКонтакте и RSS. По умолчанию для YouTube и Twitch — 10 на Free и 40 на Premium, для ВКонтакте и RSS — 30 на Free и 150 на Premium. Команда LOLBOT может изменить эти значения.

  • Одна единица — одно отправленное оповещение (правило × событие). Тестовые отправки не учитываются.
  • Лимит обновляется 1-го числа в 00:00 по Москве.
  • Когда лимит исчерпан, оповещение не отправляется, причина видна в «Истории доставки». Правила не выключаются и продолжат работу после обновления лимита.

Запрос на сброс лимита#

Если команда LOLBOT принимает запросы, под исчерпанным лимитом появляется кнопка «Запросить сброс лимита». Её видят участники с правом «Изменение правил» в разделе «Оповещения». Укажите причину (необязательно) и отправьте запрос.

  • По каждой платформе одновременно может быть только один запрос.
  • Если запрос одобрен, счётчик за текущий месяц обнуляется и оповещения снова отправляются. Пропущенные за это время оповещения не досылаются.
  • Если запрос отклонён, повторно запросить сброс по этой платформе можно только в следующем месяце.
  • Когда команда LOLBOT не принимает запросы, кнопки нет. Лимит обновится автоматически.

Какие права нужны боту#

  • Просмотр канала и отправка сообщений в канале оповещений.

Free и Premium#

Оповещения — бесплатно: до 10 оповещений в месяц для YouTube и Twitch и до 30 для ВКонтакте и RSS.

Premium. До 40 оповещений в месяц для YouTube и Twitch — хватает на ежедневные эфиры одного автора — и до 150 для ВКонтакте и RSS.

Ограничения#

  • Время доставки зависит от того, как быстро платформа публикует данные. Мгновенная доставка не гарантируется.
  • После простоя бот восстанавливает только события не старше суток. Отдельные события, которые платформа не прислала и которых нет в последних публикациях, могут быть пропущены.
  • Анонсы, клипы, архивы эфиров и изменения названий не рассылаются. Отдельного фильтра Shorts нет.
  • Упоминания в тексте оповещения не срабатывают.
  • RSS-лента проверяется примерно раз в 15 минут. При первой проверке и после перерыва дольше суток бот запоминает уже опубликованные записи и не рассылает их. За одну проверку отправляется не больше 5 новых записей ленты.
  • На сервере может быть до 25 RSS-оповещений. Лента должна быть публичной, открываться без входа и весить не больше 2 МБ.
  • ВКонтакте проверяется примерно раз в 15 минут; за одну проверку отправляется не больше 5 новых записей и видео. Закрытые сообщества и профили VK сторонним приложениям не отдаёт — их отслеживать нельзя. На сервере может быть до 25 оповещений ВКонтакте.
  • Для ВКонтакте не отслеживаются эфиры, клипы, истории, комментарии и записи других людей на стене сообщества. Видео, которое было эфиром, тоже не рассылается.

Частые проблемы#

Оповещение не пришло. Проверьте, что правило включено и «Подключён», у бота есть права в канале, а месячный лимит не исчерпан. Посмотрите «Историю доставки».

«Проверьте результат». Связь прервалась во время отправки: сообщение могло появиться. Проверьте канал — бот не повторяет отправку сам, чтобы не создать дубль.

Старые видео не появились после включения. Так задумано: учитываются только события после включения правила.

«Сообщество закрыто» (ВКонтакте). VK не отдаёт записи закрытых и частных сообществ и закрытых профилей. Откройте сообщество или выберите другое.

«По ссылке нет RSS- или Atom-ленты». Откройте сайт и найдите ссылку на RSS (часто /feed, /rss или /rss.xml). Страница с лентой подходит, только если сайт указывает ленту в своём коде.

«Сайт с лентой ответил ошибкой» или «не ответил». Сайт недоступен или не пускает бота. LOLBOT повторит проверку сам; если ошибка не проходит, проверьте адрес ленты в браузере.