Донат-платформы¶

Подключите донат-платформу один раз, чтобы PulseCasterBot автоматически получал новые донаты и использовал их в отчётах, финальных титрах и правилах канала.

Поддерживаются:

DonationAlerts — официальное подключение или URL OBS-виджета;
MemeAlerts — официальное подключение или URL OBS-виджета;
DonatePay — API-ключ;
DonateX — официальное подключение или API-ключ.

Подключение доступно владельцу канала.

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

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

Как подключить платформу¶

Откройте страницу канала и перейдите в раздел Владелец.
Нажмите карточку Донат-платформы.
Выберите нужный сервис.
Подтвердите официальный доступ или вставьте URL виджета/API-ключ.
Нажмите кнопку подключения.
Дождитесь статуса Сбор включён.

Сразу после подключения PulseCaster попробует загрузить доступные последние события. Новые донаты будут появляться в журнале на этой же странице автоматически.

DonationAlerts¶

Рекомендуемый вариант не требует копировать токен:

В PulseCaster выберите DonationAlerts → Официальный OAuth.
Нажмите Подключить через DonationAlerts.
На открывшейся странице войдите в DonationAlerts и подтвердите доступ.
Вернитесь в PulseCaster и дождитесь статуса Сбор включён.

PulseCaster запросит только доступ к профилю, истории донатов и новым событиям. Доступ автоматически продлевается системой; вручную копировать или обновлять OAuth token не нужно.

URL OBS-виджета остаётся запасным способом:

Откройте виджеты оповещений DonationAlerts.
Скопируйте полный URL для браузерного источника OBS.
В PulseCaster выберите DonationAlerts → URL виджета.
Вставьте ссылку и нажмите Подключить DonationAlerts.

MemeAlerts¶

Рекомендуемый вариант не требует копировать токен:

В PulseCaster выберите MemeAlerts → Официальный OAuth.
Нажмите Подключить через MemeAlerts.
На открывшейся странице войдите в MemeAlerts и подтвердите доступ.
Вернитесь в PulseCaster и дождитесь статуса Сбор включён.

PulseCaster запросит доступ к профилю, новым донатам и отправкам платных мемов (стикеров) — оба типа событий одинаково попадают в журнал, отчёты и титры. Доступ автоматически продлевается системой; вручную копировать или обновлять OAuth token не нужно. В отличие от DonationAlerts, официальное подключение MemeAlerts не подгружает историю до подключения — API площадки отдаёт только новые события в реальном времени.

URL OBS-виджета остаётся запасным способом:

Откройте страницу OBS-виджета MemeAlerts.
Скопируйте полный URL с obsToken и mode=OBS.
В PulseCaster выберите MemeAlerts → URL виджета.
Вставьте ссылку и нажмите Подключить MemeAlerts.

DonatePay¶

Откройте страницу API DonatePay.
Скопируйте API-ключ доступа.
В PulseCaster выберите DonatePay, вставьте ключ и нажмите Подключить DonatePay.

DonateX¶

В PulseCaster выберите DonateX → Официальный OAuth.
Нажмите Подключить через DonateX, войдите на площадке и подтвердите доступ.
Вернитесь в PulseCaster и дождитесь статуса Сбор включён.

Доступ ограничен чтением профиля и донатов, получением новых событий и автоматическим продлением. Если приложение ещё не настроено, администратор должен добавить ключи DonateX. Вариант API-ключ сохраняется: ключ можно взять в настройках стримера DonateX.

При статусе Нужно переподключить повторите официальный вход: обычная проверка не возвращает отозванное разрешение. Уже собранная история остаётся на месте.

Безопасность ключей и ссылок¶

URL OBS-виджета, API-ключи и OAuth-токены дают доступ к событиям вашего аккаунта. Обращайтесь с ручными ключами и ссылками как с паролем:

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

Секрет шифруется при хранении и не показывается повторно. OAuth-токены DonationAlerts и MemeAlerts также шифруются, не передаются во frontend и обновляются только на сервере. После сохранения ручного секрета интерфейс отображает только короткую маску, которой недостаточно для восстановления исходного значения.

Отключение платформы прекращает получение новых событий, но не удаляет уже собранную историю. Чтобы заменить ключ или URL, нажмите Переподключить.

Какие данные сохраняются¶

Для каждого доната PulseCaster сохраняет данные, необходимые функциям канала:

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

Одно и то же событие не добавляется повторно, даже если платформа прислала его несколько раз.

Как работает получение событий¶

После подключения PulseCaster поддерживает получение новых событий и дополнительно выполняет регулярную проверку. Если сервис временно недоступен, подключение не удаляется: система продолжит попытки получить события. Если DonatePay отвечает ограничением частоты запросов, ключ сохраняется, а проверка автоматически повторяется после указанной площадкой паузы без повторного ввода. Время следующей попытки видно на странице; ручная проверка также соблюдает эту паузу.

На странице подключения можно нажать Проверить сейчас. Там же видны:

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

История, загруженная при первом подключении, не запускает правила задним числом. Тестовые донаты сохраняются в журнале для проверки подключения, но не попадают в отчёты и титры и не запускают боевые правила. Само правило можно безопасно проверить кнопкой Отправить тест в чат в разделе Проверка конструктора.

Где используются донаты¶

Отчёт по стриму¶

В отчёт попадают количество донатов, суммы по валютам, подключённые платформы, топ донатеров и последние события. Донат связывается со стримом, который шёл в момент события.

Финальные титры¶

Доступны два независимых блока:

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

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

PulseCaster начинает учитывать донаты с момента подключения платформы. Старая история из кабинета платформы не загружается в журнал, отчёты и титры. Периодическая проверка API нужна только для подхвата событий, которые могли прийти во время краткого разрыва соединения.

Правила¶

Триггер Донат запускает действие в момент нового боевого события. В тексте ответа доступны:

Переменная	Что подставит
`{user}`	имя донатера
`{event:donation_donor_name}`	имя донатера
`{event:donation_amount}`	сумму доната
`{event:donation_currency}`	валюту
`{event:donation_message}`	сообщение донатера
`{event:donation_provider}`	название подключённой платформы

Пример сообщения:

Спасибо, {user}, за {event:donation_amount} {event:donation_currency}! {event:donation_message}

Готовый шаблон правила¶

Откройте Владелец → Конструктор правил.
На вкладке Шаблоны выберите Благодарность за донат и нажмите Создать по шаблону.
При необходимости измените текст ответа.
В разделе Проверка нажмите Отправить тест в чат: бот подставит тестовое имя, сумму, валюту и сообщение.
Сохраните и включите правило.

Шаблон реагирует на каждый новый боевой донат и отправляет благодарность в чат. Условие по сумме добавлять необязательно. Если сообщение донатера не нужно показывать, удалите из ответа {event:donation_message}.

Подробнее о действиях, условиях и проверке: Конструктор правил.

Связка ников Twitch и MemeAlerts¶

Зритель может донатить на MemeAlerts под именем, которое отличается от ника в Twitch-чате. Чтобы PulseCaster всё равно узнавал такие донаты, на канале можно один раз указать пару «ник в Twitch — ник на MemeAlerts».

Настройка находится на странице MemeAlerts в Донат-платформы, а также прямо на странице Награда топу роста в Интерактивные игры — там, где виден результат поиска по !рост. Обе формы работают с одним и тем же списком связок канала.

Откройте Донат-платформы → MemeAlerts (или Интерактивные игры → Награда топу роста).
В блоке Связка ников с MemeAlerts укажите ник в Twitch-чате и ник на MemeAlerts.
Нажмите Добавить связку.

Если под указанным MemeAlerts-ником ещё не было ни одного доната на канал, PulseCaster сохранит связку, но предупредит об этом: донат по ней подтянется, как только зритель задонатит в первый раз.

Связка учитывается только для событий MemeAlerts — в топе донатеров, финальных титрах, отчёте по стриму, профиле зрителя и при автовыдаче за рост (см. Награда топу роста). На DonationAlerts, DonatePay и DonateX ник можно указать произвольно или задонатить анонимно, поэтому связка с MemeAlerts на них не распространяется: одноимённый, но не привязанный ник на другой площадке зрителю по ошибке не засчитается.

Удалить связку можно там же, кнопкой рядом со строкой.

Если события не появляются¶

Проверьте статус выбранной платформы.
Нажмите Проверить сейчас.
Убедитесь, что официальное подключение завершено, либо вставлен полный URL/правильный API-ключ.
Для DonationAlerts и MemeAlerts повторите официальное подключение, если доступ был отозван в аккаунте сервиса.
Если ручной доступ был обновлён на стороне платформы, переподключите сервис с новым значением.
Проверьте журнал событий: правило запускается только для нового боевого доната, а не для импортированной истории.

Если ошибка остаётся, отправьте в поддержку название платформы, время проверки и текст ошибки. Сам ключ или URL виджета отправлять не нужно.