# Telegram-бот молчит — что проверить

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

## Коротко

Если Telegram-бот (@qutpaybot) замолчал, причина обычно одна из четырёх: **чат не привязан к организации**, **бот заблокирован**, в группе включён **режим приватности** или **отключён нужный тип уведомлений**. Первое действие — отправить `/status` в личном чате: если ответ пришёл, дело не в привязке, а в настройках.

## Симптом → причина → решение

| Симптом | Причина | Решение |
|---|---|---|
| В личном чате не отвечает ни на одну команду | Бот заблокирован | Кнопка «Разблокировать» в чате, затем `/start` |
| `/start` работает, а `/today` говорит, что привязки нет | Чат не привязан к организации | Возьмите код привязки в кабинете |
| В группе команды не работают | Включён режим приватности | BotFather → `/setprivacy` → **Disable** |
| В группе команды работают, а уведомления нет | Бот не администратор или тип уведомлений выключен | Сделайте бота админом, включите типы в кабинете |
| Не приходят уведомления об оплате, остальные приходят | Этот тип уведомлений отключён | Включите в кабинете |
| Раньше работал, теперь молчит | Привязка слетела или бота удалили из группы | Добавьте заново и введите код привязки |

## Порядок проверки

### 1. Жив ли бот вообще

Отправьте `/status` в личный чат @qutpaybot.

- **Ответ пришёл** — бот жив, проблема в привязке или настройках. Переходите к шагу 2.
- **Ответа нет** — вероятно, бот заблокирован. Если вверху чата видна кнопка «Разблокировать», нажмите её и отправьте `/start`.
- **Надпись «бот остановлен»** — нажмите `/start`.

Telegram не доставляет сообщения заблокированному боту, и с нашей стороны это не выглядит как ошибка: мы отправили, Telegram отбросил.

### 2. Привязан ли чат к организации

Пока бот вас не знает, он не понимает, чьи данные показывать. Привязка делается одноразовым кодом:

1. В кабинете в разделе **Настройки** берёте код привязки Telegram
2. Отправляете его боту
3. Бот подтверждает организацию, команды начинают работать

Подробнее: [Подключить Telegram-бота](/kb/ru/telegram-connect).

Если организаций несколько, каждый чат привязывается к одной конкретной. Счета чужой организации бот не покажет.

### 3. В группе — режим приватности

У Telegram-ботов по умолчанию включён **режим приватности (privacy mode)**. Пока он включён, бот не видит все сообщения в группе — только адресованные ему напрямую. В результате команды вроде `/today` остаются без ответа.

Выключение: BotFather → `/setprivacy` → выбрать бота → **Disable**. После этого бота нужно удалить из группы и добавить заново — изменение вступает в силу при новом добавлении.

Альтернатива: писать команды с явным упоминанием бота (`/today@qutpaybot`). Так работает и при включённом режиме приватности.

### 4. В группе — администратор ли бот

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

После добавления бота в группу дайте ему права администратора или убедитесь, что участникам разрешено писать.

### 5. Включены ли типы уведомлений

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

Включите нужные типы в настройках Telegram в кабинете, а для проверки создайте счёт в песочнице и просимулируйте оплату.

## Команды

| Команда | Что делает |
|---|---|
| `/invoice` | Создать счёт |
| `/today` | Отчёт за сегодня |
| `/last` | Последние счета |
| `/status` | Состояние сервиса и привязки |
| `/cancel` | Отменить счёт |
| `/support` | Написать в поддержку |

Полное описание: [Команды Telegram-бота](/kb/ru/telegram-bot-commands).

## Чего делать не стоит

- **Не ищите другого бота.** Официальный бот — @qutpaybot. Не отправляйте код из кабинета ботам с похожими именами.
- **Не выкладывайте код привязки в чат.** Это доступ. Отправив его в группу, вы даёте возможность привязать вашу организацию любому, кто его увидит.
- **Не используйте бота вместо вебхука.** Уведомления рассчитаны на человека, для интеграции нужен вебхук: [Вебхук не приходит](/kb/ru/webhook-not-arriving).

## Вопросы и ответы

**Можно ли подключить к одной организации несколько чатов?** Да. Обычно это группа для всей команды и отдельный личный чат владельца.

**Связан ли бот с номером кассира?** Нет. Привязка Telegram полностью отдельна от кассира Kaspi. Если привязка кассира оборвётся, бот продолжит работать — наоборот, он об этом и предупредит.

**Что будет, если удалить бота из группы?** Уведомления прекратятся. После повторного добавления может потребоваться заново ввести код привязки.

**Через какого кассира идёт счёт, созданный через бота?** Через активного кассира организации, как обычный счёт.

**Бот молчит, а счета создаются. Это опасно?** Не опасно, но неудобно: вы не узнаете сразу, если привязка оборвётся. Уведомления лучше восстановить.

**Как написать в поддержку?** Через `/support` в боте или другими каналами: [Как написать в поддержку](/kb/ru/support-how).