diff --git a/FAQ.md b/FAQ.md
new file mode 100644
index 0000000..ed18b62
--- /dev/null
+++ b/FAQ.md
@@ -0,0 +1,48 @@
+# FAQ / Устранение неполадок
+
+## Telegram
+
+### Бот не отвечает на команды
+- Проверьте, что бот добавлен в группу и имеет права администратора.
+- Убедитесь, что вы пишете команду с `/` (например, `/start`).
+- Попробуйте перезапустить бота: `/start`.
+
+### Кнопки не работают
+- Боту нужно право "Manage Messages" для редактирования schedule.
+- Если кнопки "зависли" — подождите 1–2 минуты и попробуйте снова.
+
+### Mini App не открывается
+- Убедитесь, что `TELEGRAM_MINI_APP_URL` использует **HTTPS**.
+- Проверьте, что домен добавлен в BotFather (`/setdomain`).
+- На iOS убедитесь, что Telegram обновлён до последней версии.
+
+## Discord
+
+### Slash-команды не появляются
+- Перезапустите Docker Compose (регистрация команд происходит при старте).
+- Проверьте, что у бота есть scope `applications.commands`.
+- На сервере должно быть не более 100 глобальных команд (у нас их < 10).
+
+### Кнопки Join/Leave не работают
+- Боту нужны права: Send Messages, Embed Links, Manage Messages.
+- Если кнопка "не нажимается" — проверьте, что вы не заблокировали бота.
+
+### DM-уведомления не приходят
+- Проверьте Discord Privacy Settings → "Allow direct messages from server members".
+- Бот не может писать первым, если вы его заблокировали.
+- Сбои DM логируются — ГМ увидит, что уведомление не дошло.
+
+## Общее
+
+### Reschedule голосование не завершилось
+- Голосование завершается по дедлайну (обычно через N часов).
+- Если голосов мало — побеждает вариант с наибольшим количеством голосов.
+- При равенстве — выбирается первый по времени.
+
+### Игрок из waitlist не поднялся автоматически
+- Проверьте, что у сессии установлен `max_players` > 0.
+- Если `max_players` не задан — waitlist не работает (все помещаются в основной состав).
+
+### Статистика показывает 0%
+- Статистика считается только для **завершённых** сессий (статус `completed`).
+- Если все сессии в статусе `planned` или `cancelled` — статистики не будет.