VIP-менеджер¶

VIP-менеджер помогает владельцу канала управлять VIP-статусами без постоянной ручной рутины. Он может выдавать VIP за выбранную награду Twitch и за серию просмотров, снимать VIP по сроку, подсказывать неактивных VIP и защищать важных людей от автоматического снятия.

Используйте эту страницу, если VIP на канале должен быть понятной системой: кто получил статус, за что получил, на какой срок, что делать при заполненных слотах и кого нельзя трогать автоматически.

Нужна помощь разработчика?

Напишите mrgorkiy в Telegram. Укажите страницу, ожидаемый результат, что произошло и шаги для повторения. Можно приложить скриншот или короткое видео. Перед отправкой закройте токены, коды подтверждения и приватные ссылки OBS.

Когда он нужен¶

VIP-менеджер особенно полезен, если:

зрители покупают VIP за награду канала;
VIP выдаётся не навсегда, а на ограниченный срок;
VIP-слоты часто заканчиваются;
хочется видеть, кто из VIP давно не пишет в чат;
часть VIP нужно закрепить навсегда и не снимать автоматически;
владелец или модератор хочет быстро понять, почему VIP был выдан или снят.

Если VIP у вас выдаётся редко и только вручную, можно начать со списка VIP и белого списка, а авто-выдачу включить позже.

Перед настройкой¶

Перед работой с VIP-менеджером проверьте две вещи:

На странице Подписка канал подтверждён.
Подключён аккаунт владельца Twitch или бот назначен модератором канала.

Токен владельца с правом channel:manage:vips используется в первую очередь. Если его нет, PulseCaster пытается читать и менять VIP через чат-команды бота-модератора. Права на прогнозы Twitch к VIP-менеджеру не относятся.

Что это значит простыми словами

PulseCaster должен получить разрешение от владельца канала, чтобы видеть нужные действия Twitch и менять VIP-статусы от имени канала. Это не передаёт владение каналом.

Как устроена страница¶

Страница Управление VIP состоит из четырёх вкладок. Вверху всегда видно, подключён ли Twitch владельца и когда список VIP последний раз сверялся с Twitch.

Вкладка	Для чего нужна
Участники	список VIP со сроком, способом получения и активностью, поиск, фильтры, выдача, смена срока, снятие и белый список
Как выдаётся	срок по умолчанию, награда за баллы, VIP за серию просмотров и что делать при нехватке мест
Снятие и защита	снятие неактивных, белый список и состояние связи с Twitch
Журнал	история выдачи, продлений, смены срока, снятия, пропусков и ошибок

Настройки на вкладках Как выдаётся и Снятие и защита сохраняются кнопкой Сохранить в нижней панели. Пока есть несохранённые изменения, рядом с названием вкладки горит точка, а закрыть страницу браузер предупредит. Действия в списке (выдать, изменить срок, снять, белый список) применяются сразу.

1. Срок VIP по умолчанию¶

Блок Срок VIP по умолчанию задаёт срок для VIP, купленных за баллы, и для тех, кого вы назначили на Twitch в обход бота. Есть быстрые варианты (1 день, 3 дня, 7 дней, 14 дней, 1 месяц), Навсегда и Свой срок.

Новый срок действует только для будущих выдач. Когда вы меняете его и сохраняете, страница спросит, нужно ли применить срок и к текущим VIP. По умолчанию текущие сроки не меняются. VIP, полученные за серию просмотров, не затрагиваются никогда — у них срок по ступеням.

2. VIP за баллы канала¶

В блоке VIP за баллы канала выберите награду Twitch, которая должна выдавать VIP, или создайте новую кнопкой Создать награду: страница создаст её на Twitch и сразу назначит выдачей VIP. После покупки награды PulseCaster попробует выдать VIP покупателю.

Если нужной награды в списке нет:

проверьте, что аккаунт владельца подключён;
нажмите Обновить рядом со списком наград;
убедитесь, что награда существует на канале Twitch.

Чтобы перестать выдавать VIP за баллы, нажмите Отключить и сохраните настройки.

Если награду покупает тот, кто уже VIP, срок продлевается на срок по умолчанию. Если у него VIP навсегда, менять нечего: в журнале появится запись VIP для … не выдан — у человека уже бессрочный VIP, и при желании вы сможете вернуть баллы на Twitch.

Подарок другому пользователю¶

Переключатель Можно подарить VIP другому зрителю разрешает покупателю указать ник в тексте награды, например @username.

Зритель покупает выбранную VIP-награду.
Если в тексте есть ник, PulseCaster пытается выдать VIP этому человеку.
Если ник не указан или не найден, VIP получает сам покупатель.

Переключатель Спрашивать подтверждение подарка в чате добавляет защиту от случайной выдачи не тому человеку: бот уточнит у покупателя. Если ответа нет в течение трёх минут, VIP получит сам покупатель.

3. VIP за серию просмотров¶

Twitch считает серию просмотров — сколько стримов подряд зритель заходил на канал. Когда зритель нажимает «Поделиться» у своей серии, в чате появляется сообщение. По нему бот узнаёт число и выдаёт VIP по ступеням.

Бот видит только серии, которыми поделились

Twitch не позволяет боту спросить серию у зрителя напрямую. Если зритель серией не поделился, бот её не увидит и VIP не выдаст.

Ступень состоит из двух чисел: сколько стримов подряд и на сколько дней выдать VIP (0 — навсегда). Например: 5 стримов → 3 дня, 10 → 7 дней, 30 → навсегда. Кнопка Добавить типовые ступени создаёт такой набор, а дальше его можно изменить. Всего можно настроить до 12 ступеней.

Правила работы:

берётся самая высокая достигнутая ступень: при серии 12 и ступенях 5 и 10 зритель получит ступень 10;
одну и ту же ступень зритель получает один раз за серию;
если серия оборвалась и началась заново (число стало меньше прежнего), ступени снова доступны;
если зритель уже VIP со сроком, срок продлевается, а бессрочный VIP не меняется;
если свободных мест нет, действует настройка из блока ниже, а ступень не засчитывается — зритель сможет поделиться серией ещё раз, когда место освободится;
включить режим без ступеней нельзя: сначала добавьте хотя бы одну.

В списке такие VIP подписаны Серия просмотров с числом стримов, а в журнале видно, за какую серию выдан VIP.

Серия, которой зритель поделился в последний раз, показывается у каждого VIP в колонке Активность в чате: сколько стримов, когда он поделился, какая ступень уже получена и сколько стримов осталось до следующей. Это последнее число, которое увидел бот, а не данные Twitch в реальном времени, поэтому оно может отставать.

Каждое «поделился серией» записывается, даже если VIP не изменился: серия ниже первой ступени, ступень уже получена, серия началась заново. Эти записи не попадают в общий журнал: он остаётся про выдачи, продления и снятия. Их можно посмотреть в журнале по фильтру Серии — там все, кто поделился серией, а не только VIP. Выдача и продление VIP за серию, как и раньше, пишутся в общий журнал.

Что будет, если серия оборвалась¶

Бот узнаёт об обрыве только тогда, когда зритель делится новой серией, и сравнивает её с прошлой запомненной. Если новая серия меньше прежней, считается, что она началась заново, и ступени снова доступны с самого начала. Пример: у зрителя последняя серия 50, получена ступень 20, ступени настроены на 5, 10 и 20.

Новая серия	Что произойдёт
8	серия началась заново, зритель получает ступень 5
3	выдачи нет, бот просто запоминает серию 3 и пишет это в ленту `Серии`
10	зритель получает ступень 10 (одну, без ступени 5)

Ограничение: если после обрыва зритель успел набрать серию не меньше прежней запомненной и только тогда поделился, бот этого не заметит, и ступени останутся «уже полученными».

4. Если свободных VIP-мест нет¶

Twitch ограничивает число VIP. Блок Если свободных VIP-мест нет задаёт поведение, когда новый VIP нужен, а места уже нет.

Вариант	Что произойдёт	Когда выбирать
Сообщить мне в Telegram	владелец получит уведомление и решит сам	если не хотите автоматических замен
Снять самого давно молчащего	PulseCaster освободит место за счёт неактивного VIP	если VIP должен оставаться у активных зрителей
Ничего не делать	выдача не произойдёт, в журнал попадёт пропуск	если VIP временно нужно выдавать только вручную

Для варианта Снять самого давно молчащего укажите, сколько дней человек не должен писать, чтобы его можно было заменить. Например, при 3 дня бот не снимет того, кто писал сегодня или вчера.

Белый список не снимается

VIP из белого списка не участвуют в автоматической замене, даже если давно не писали.

5. Срок каждого VIP и автоматическое снятие¶

Срок хранится у каждого VIP отдельно и виден в списке: Навсегда, Осталось N дней, Срок истёк. Когда срок заканчивается, бот снимает VIP при ближайшей проверке — она идёт раз в 30 минут. Это работает независимо от срока по умолчанию: так истекают и VIP за баллы, и VIP за серию, и выданные вручную со сроком.

Снятие по неактивности включается отдельно на вкладке Снятие и защита: укажите, сколько дней без сообщений в чате считать уходом. Активностью считается только сообщение пользователя в чате. Простое присутствие на стриме или в списке чаттеров не сбрасывает срок неактивности. Время выдачи VIP используется как начальная отсрочка, чтобы новый VIP не был снят до истечения полного порога.

Если PulseCaster не может подтвердить актуальный состав VIP или получить сообщения из ClickHouse, автоматическое снятие по неактивности и автоматическая замена слота приостанавливаются. Ручное снятие остаётся доступным.

Если VIP уже был выдан раньше

Когда вы включаете срок по умолчанию, для уже существующих VIP отсчёт начинается только если вы отметите Применить и к текущим VIP в окне подтверждения.

6. Белый список¶

Белый список нужен для VIP, которых нельзя снимать автоматически — ни по сроку, ни по неактивности.

Добавляйте туда людей, чей VIP должен сохраняться независимо от сроков и активности:

соведущих и участников команды;
важных постоянных зрителей;
партнёров канала;
людей, которым VIP выдан вручную навсегда.

Добавить человека можно кнопкой со щитом в строке списка. Переключатель Не показывать белый список в команде !нетопвип убирает таких людей из команды, которая показывает неактивных VIP.

7. Список участников¶

Вкладка Участники показывает:

сколько VIP всего, сколько скоро закончатся, сколько без срока и сколько давно не пишут — карточки сверху работают как быстрые фильтры;
срок каждого VIP и его остаток;
когда и как человек получил VIP: за баллы (с названием награды), за серию просмотров (с числом стримов), вручную (кто выдал) или напрямую на Twitch;
время последнего сообщения и дату, после которой сработает автоснятие по неактивности;
последнюю серию просмотров, которой поделился зритель (если бот её видел);
поиск по нику, фильтры Скоро истекут, Навсегда, Белый список, Давно не пишут, сортировку и страницы.

Фильтр Давно не пишут показывает тех, кому грозит снятие по неактивности. По умолчанию порог — две трети порога автоснятия (при 14 днях — 9 дней), чтобы вы успели заметить людей, пока бот их не снял; без автоснятия — 30 дней. Порог можно выбрать вручную, когда фильтр открыт. Белый список в этот фильтр не входит.

Действия в строке:

Новый VIP — выдать VIP вручную: введите ник (можно вставить ссылку на канал), выберите срок и нажмите Выдать VIP. Если человек уже VIP, страница подскажет изменить срок в списке;
карандаш — изменить срок: продлить на несколько дней, выбрать дату окончания или сделать VIP бессрочным;
щит — добавить в белый список или убрать;
корзина — снять VIP на Twitch (с подтверждением).

Кнопка с круговой стрелкой сверяет список с Twitch заново. Дни неактивности и срок автоснятия рассчитывает сервер, поэтому список и фоновый VIP-менеджер используют одинаковое решение.

Команда в чате: `!vip`¶

Владелец канала и его модераторы могут выдать VIP и поменять срок прямо из чата:

Команда	Что произойдёт
`!vip @ник`	если человека нет в VIP — выдаст VIP навсегда; если он уже VIP — просто скажет, до какого числа
`!vip @ник 30d`	выдаст VIP на 30 дней; если человек уже VIP, срок станет «30 дней от сегодня»
`!vip @ник 1y2m3w4d`	срок из нескольких частей: `y` — год, `m` — месяц, `w` — неделя, `d` — день (подойдут и русские `г`, `м`, `н`, `д`)
`!vip @ник навсегда`	выдаст VIP без срока или сделает бессрочным уже выданный
`!vip`	любой зритель узнаёт, сколько осталось до снятия его VIP

Единицы можно писать в любом порядке, каждую — один раз; просто число (!vip @ник 30) считается днями. Месяц и год считаются по календарю, больше 10 лет поставить нельзя.

Команду с ником выполняют владелец канала (бот сверяет числовой Twitch ID автора) и модераторы канала (по бейджу модератора в вашем чате). Бейджи зрителей из других комнат общего чата (Shared Chat) бот не учитывает: модератор или стример соседнего канала в вашем чате остаётся для бота обычным зрителем.

Такая выдача попадает в список как Выдан вручную с пометкой, кто и как выдал («Выдал модератор @ник командой в чате»), а в журнале видно, кто вызвал команду: Кто: @ник (модератор, команда в чате). Команда доступна, пока на канале включены стандартные команды бота.

Сроки и снятие по неактивности работают вместе¶

Срок и неактивность — два независимых правила, VIP снимается по тому, что наступит раньше (белый список защищает от обоих). Поэтому можно, например, выдавать VIP за баллы навсегда, а за серию просмотров — на 10 дней, и при этом снимать всех, кто долго не пишет в чат.

8. Журнал действий¶

Вкладка Журнал показывает историю действий VIP-менеджера по дням. Фильтры: Выдачи, Сроки, Снятия, Серии (отдельная лента, см. выше), Проблемы, а также поиск по нику и причине.

В журнале удобно проверять:

кому выдали VIP и за что (баллы, серия просмотров, вручную);
как менялся срок: на сколько продлён, было и стало;
у кого VIP сняли и почему: истёк срок, давно не писал, освободили место, снят вручную или на Twitch;
кто запустил ручное действие;
была ли ошибка или пропуск.

Для снятия журнал показывает исторический снимок на момент события, а не текущую активность пользователя. Например, писал в день события означает, что последнее сообщение было в тот же день, когда VIP сняли. Если пользователь написал позже, старая запись не переписывается.

Если зритель спрашивает, почему VIP пропал, начинайте с журнала.

Проверка после настройки¶

Перед первым использованием пройдитесь по короткому чеклисту:

аккаунт владельца подключён, на странице нет блокировки;
выбрана правильная VIP-награда или выбор сброшен намеренно;
если включён VIP за серию просмотров, ступени понятны и зрители знают, что серией нужно поделиться в чате;
понятно, что делать при заполненных слотах;
срок VIP и порог неактивности не слишком агрессивные;
важные люди добавлены в белый список;
список VIP открывается и показывает актуальный состав;
журнал действий открывается без ошибок.

Если что-то не работает¶

Симптом	Где смотреть сначала
Награды не отображаются	подключение аккаунта владельца и кнопка `Обновить данные`
VIP не выдаётся после покупки награды	выбрана ли нужная награда и есть ли свободные VIP-слоты
VIP выдался покупателю, а не другому человеку	был ли указан корректный ник и включена ли покупка другому пользователю
VIP снялся не у того человека	журнал действий и белый список
VIP за серию не выдаётся	включён ли переключатель и есть ли ступени; поделился ли зритель серией в чате; нет ли записи о нехватке мест в журнале
Не получается выдать или снять VIP вручную	подключён ли аккаунт владельца и нет ли предупреждений на странице; точный ответ Twitch виден в сообщении об ошибке
Срок VIP закончился, а человек всё ещё в списке	бот проверяет сроки раз в 30 минут; белый список от снятия по сроку защищает
Состав VIP выглядит неполным	обратите внимание на предупреждение `Состав VIP подтвержден не полностью`
Авто-снятие приостановлено	проверьте предупреждения о составе VIP и источнике сообщений; до восстановления данных бот никого автоматически не снимет

Лучше начинать с мягких настроек: уведомлять владельца при заполненных слотах, поставить понятный срок VIP и сначала несколько стримов смотреть журнал. Когда поведение станет предсказуемым, можно включать автоматическую замену самого неактивного VIP.