Что делает модуль#
Бот сообщает в канал вашего сервера о новых событиях на Twitch, YouTube и ВКонтакте и о новых записях сайтов с RSS-лентой:
| Платформа | События |
|---|---|
| Twitch | Начало эфира |
| YouTube | Новые публичные видео (включая Shorts) и начало запланированных эфиров |
| ВКонтакте | Новые записи на стене и новые видео открытого сообщества или страницы |
| RSS | Новые записи RSS- или Atom-ленты сайта: новости, блог, подкаст |
Для каждого автора или ленты создаётся отдельное правило со своим каналом и текстом.
Где найти#
Кабинет → Модули → Оповещения. Список правил с поиском; настройка и история доставки открываются в отдельном окне.
Быстрый старт#
- Нажмите «Новое оповещение».
- Выберите Платформу и вставьте Ссылку на канал, например
https://twitch.tv/имяилиhttps://youtube.com/@имя. Для ВКонтакте — ссылку на открытое сообщество или страницу:https://vk.com/имя,https://vk.com/club123илиhttps://vkvideo.ru/@имя. Для RSS вставьте адрес ленты (https://example.com/feed) или просто страницу сайта: если сайт указывает свою ленту, бот найдёт её сам. - Отметьте «О чём сообщать» и выберите Канал Lolka.
- Напишите Текст сообщения и проверьте предпросмотр.
- Отправьте тестовое оповещение — оно придёт в выбранный канал как настоящее сообщение.
- Включите «Включить оповещение после сохранения» и сохраните.
Совет. Для первого теста выберите закрытый тестовый канал: тестовое оповещение — это настоящее сообщение, его увидят все участники канала.
Настройки#
| Поле | Что делает |
|---|---|
| Платформа | 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 повторит проверку сам; если ошибка не проходит, проверьте адрес ленты в браузере.