idle-xboct/docs/twitch-setup.md

Twitch: чек-лист подключения (нужен к M1)

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

1. Приложение (один раз)

1. На аккаунте, который регистрирует приложение (можно сам бот-аккаунт), включите 2FA: twitch.tv → Настройки → Безопасность и конфиденциальность. Без 2FA Twitch не даёт создавать приложения.
2. Зайти на https://dev.twitch.tv/console под этим аккаунтом → Register Your Application:
   • Name: любое уникальное, например idle-xboct-bot
   • OAuth Redirect URLs: http://localhost:3000/oauth/callback
   • Category: Chat Bot
3. Скопировать Client ID, затем Manage → New Secret → Client Secret (показывается один раз).

2. Токен бота — чтение и ответы в чате (M1)

Scope: chat:read chat:edit.

• Быстрый способ: https://twitchtokengenerator.com → «Chat Bot / Quick Token» → залогиниться именно бот-аккаунтом → получить access token и refresh token.
• Надёжный способ (когда дойдём до M1): мини-OAuth-скрипт на redirect из п.1.

3. Токен стримера — Channel Points (нужен только к M5, спотлайт)

Scope: channel:read:redemptions. Получается так же (twitchtokengenerator или свой OAuth), но залогиниться нужно аккаунтом стримера. EventSub-события выкупа наград принимают только пользовательский токен владельца канала — токена бота тут недостаточно.

4. Куда положить

Файл .env в корне packages/server/ (в git не попадает — уже в .gitignore):

TWITCH_CLIENT_ID=...
TWITCH_CLIENT_SECRET=...
TWITCH_CHANNEL=имя_канала

TWITCH_BOT_TOKEN=...
TWITCH_BOT_REFRESH=...

TWITCH_STREAMER_TOKEN=...
TWITCH_STREAMER_REFRESH=...

Refresh-токены обновляет RefreshingAuthProvider из twurple автоматически — перелогиниваться вручную не придётся.