Коротко
Если Telegram-бот (@qutpaybot) замолчал, причина обычно одна из четырёх: чат не привязан к организации, бот заблокирован, в группе включён режим приватности или отключён нужный тип уведомлений. Первое действие — отправить /status в личном чате: если ответ пришёл, дело не в привязке, а в настройках.
Симптом → причина → решение
| Симптом | Причина | Решение |
|---|---|---|
| В личном чате не отвечает ни на одну команду | Бот заблокирован | Кнопка «Разблокировать» в чате, затем /start |
/start работает, а /today говорит, что привязки нет | Чат не привязан к организации | Возьмите код привязки в кабинете |
| В группе команды не работают | Включён режим приватности | BotFather → /setprivacy → Disable |
| В группе команды работают, а уведомления нет | Бот не администратор или тип уведомлений выключен | Сделайте бота админом, включите типы в кабинете |
| Не приходят уведомления об оплате, остальные приходят | Этот тип уведомлений отключён | Включите в кабинете |
| Раньше работал, теперь молчит | Привязка слетела или бота удалили из группы | Добавьте заново и введите код привязки |
Порядок проверки
1. Жив ли бот вообще
Отправьте /status в личный чат @qutpaybot.
- Ответ пришёл — бот жив, проблема в привязке или настройках. Переходите к шагу 2.
- Ответа нет — вероятно, бот заблокирован. Если вверху чата видна кнопка «Разблокировать», нажмите её и отправьте
/start. - Надпись «бот остановлен» — нажмите
/start.
Telegram не доставляет сообщения заблокированному боту, и с нашей стороны это не выглядит как ошибка: мы отправили, Telegram отбросил.
2. Привязан ли чат к организации
Пока бот вас не знает, он не понимает, чьи данные показывать. Привязка делается одноразовым кодом:
- В кабинете в разделе Настройки берёте код привязки Telegram
- Отправляете его боту
- Бот подтверждает организацию, команды начинают работать
Подробнее: Подключить Telegram-бота.
Если организаций несколько, каждый чат привязывается к одной конкретной. Счета чужой организации бот не покажет.
3. В группе — режим приватности
У Telegram-ботов по умолчанию включён режим приватности (privacy mode). Пока он включён, бот не видит все сообщения в группе — только адресованные ему напрямую. В результате команды вроде /today остаются без ответа.
Выключение: BotFather → /setprivacy → выбрать бота → Disable. После этого бота нужно удалить из группы и добавить заново — изменение вступает в силу при новом добавлении.
Альтернатива: писать команды с явным упоминанием бота (/today@qutpaybot). Так работает и при включённом режиме приватности.
4. В группе — администратор ли бот
В некоторых настройках группы участники без прав администратора не могут писать сообщения. Бот подчиняется тому же правилу: он пытается отправить, Telegram не пропускает.
После добавления бота в группу дайте ему права администратора или убедитесь, что участникам разрешено писать.
5. Включены ли типы уведомлений
Какие именно уведомления приходят, настраивается в кабинете. Если команды работают, а автоматические уведомления не приходят — причина здесь: нужный тип выключен.
Включите нужные типы в настройках Telegram в кабинете, а для проверки создайте счёт в песочнице и просимулируйте оплату.
Команды
| Команда | Что делает |
|---|---|
/invoice | Создать счёт |
/today | Отчёт за сегодня |
/last | Последние счета |
/status | Состояние сервиса и привязки |
/cancel | Отменить счёт |
/support | Написать в поддержку |
Полное описание: Команды Telegram-бота.
Чего делать не стоит
- Не ищите другого бота. Официальный бот — @qutpaybot. Не отправляйте код из кабинета ботам с похожими именами.
- Не выкладывайте код привязки в чат. Это доступ. Отправив его в группу, вы даёте возможность привязать вашу организацию любому, кто его увидит.
- Не используйте бота вместо вебхука. Уведомления рассчитаны на человека, для интеграции нужен вебхук: Вебхук не приходит.
Вопросы и ответы
Можно ли подключить к одной организации несколько чатов? Да. Обычно это группа для всей команды и отдельный личный чат владельца.
Связан ли бот с номером кассира? Нет. Привязка Telegram полностью отдельна от кассира Kaspi. Если привязка кассира оборвётся, бот продолжит работать — наоборот, он об этом и предупредит.
Что будет, если удалить бота из группы? Уведомления прекратятся. После повторного добавления может потребоваться заново ввести код привязки.
Через какого кассира идёт счёт, созданный через бота? Через активного кассира организации, как обычный счёт.
Бот молчит, а счета создаются. Это опасно? Не опасно, но неудобно: вы не узнаете сразу, если привязка оборвётся. Уведомления лучше восстановить.
Как написать в поддержку? Через /support в боте или другими каналами: Как написать в поддержку.