# 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):

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

TWITCH_BOT_TOKEN=...
TWITCH_BOT_REFRESH=...

TWITCH_STREAMER_TOKEN=...
TWITCH_STREAMER_REFRESH=...
```

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