# Подключить Telegram-бота

> Берёте код привязки в разделе Настройки и пишете боту @qutpaybot команду /start КОД. Подключить можно и в личный чат, и в группу. Какие уведомления приходят и какие есть команды.

## Коротко

Открываете в Telegram бота **@qutpaybot**, берёте код привязки в разделе **Настройки** в кабинете и пишете боту `/start КОД`. Всё. После этого в чат приходят уведомления об оплатах, возвратах, обрыве привязки кассира и о приближении к лимиту. Бота можно подключить и в личный чат, и в рабочую группу.

## Как подключить

1. Заходите в кабинет: https://qut.kz/app
2. Открываете раздел **Настройки** и берёте **код привязки** в блоке Telegram.
3. Находите в Telegram бота **@qutpaybot**.
4. Пишете боту `/start` вместе с кодом: `/start КОД`.
5. Бот подтверждает привязку. В кабинете в том же блоке видно, что чат подключён.

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

## Подключение в группу

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

1. Добавляете бота в группу (Add member → @qutpaybot).
2. Пишете в этой группе `/start КОД`.

В группе есть одна особенность: в Telegram у ботов бывает включён **режим конфиденциальности** (privacy mode), и тогда бот видит не все сообщения группы. Поэтому в группе надёжнее писать команды с именем бота: `/today@qutpaybot`. Если бот молчит — проверьте это в первую очередь.

Добавляя бота в группу, посмотрите, кто в ней состоит: в чат будут приходить суммы счетов и данные покупателей.

## Какие уведомления приходят

| Уведомление | Когда приходит | Почему это важно |
|---|---|---|
| Об оплате | В момент оплаты счёта | На офлайн-точке вы сразу видите платёж и не просите показать чек |
| О возврате | Когда возврат прошёл | Если возврат сделал сотрудник, вы узнаёте сразу |
| Об обрыве привязки кассира | Когда оборвалась сессия Kaspi | Самое важное: вы узнаёте об остановке раньше, чем напишут клиенты |
| О лимите | Когда месячный лимит подходит к концу | Успеваете поднять тариф заранее |

Уведомление об обрыве привязки — главная причина подключить бота. Без него о проблеме обычно узнают, только когда покупатель напишет «не могу оплатить»: [Привязка кассира оборвалась](/kb/ru/connection-lost).

## Команды

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

Команда `/invoice` выручает, когда нет программиста: достали телефон и выставили счёт прямо оттуда. `/status` — самый быстрый ответ на вопрос «проблема у меня или нет».

Другие способы связаться с поддержкой: [Как написать в поддержку](/kb/ru/support-how).

## Как отключить бота

Чат отключается в разделе **Настройки** — после этого уведомления в него не приходят. Со стороны Telegram достаточно заблокировать бота или удалить его из группы.

Отключение бота не влияет ни на счета, ни на API-ключи, ни на привязку к Kaspi. Бот — только канал уведомлений.

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

**Бот молчит, что проверить?** Три вещи: привязан ли чат (видно в разделе Настройки), не заблокировали ли вы бота, и пробовали ли писать команду в группе с `@qutpaybot`.

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

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

**Что делать, если код устарел?** Взять новый код в разделе Настройки в кабинете.

**Приходят ли уведомления по счетам из песочницы?** Да, режим в них помечен отдельно. При тестировании это удобно: сразу видно, что уведомления доходят.