# Команды Telegram-бота: полный справочник

> Все команды @QutPayBot — выставить счёт, выручка за день, последние счета, статус, отмена, поддержка. Русские и казахские варианты, работа в группе и какие уведомления приходят.

## Коротко

[@QutPayBot](https://t.me/qutpaybot) — один общий бот для всех организаций. Через него можно выставлять счета, смотреть выручку за день и получать уведомления об оплатах, не открывая кабинет.

Порядок простой: в кабинете берёте код привязки, пишете боту `/start КОД` — в личном чате или в группе, — и этот чат связывается с организацией. После этого работают команды, а уведомления об оплатах приходят в тот же чат.

## Команды

| Команда | Что делает |
|---|---|
| `/start КОД` | Привязывает чат к организации. Код берётся в кабинете, живёт 15 минут |
| `/invoice 5000` | Создаёт счёт с QR и ссылкой на оплату |
| `/invoice 5000 77001234567` | Отправляет счёт прямо в приложение Kaspi покупателя |
| `/invoice 5000 Консультация` | Счёт с описанием |
| `/invoice 5000 77001234567 Консультация` | На телефон и с описанием |
| `/today` | Выручка за сегодня, все оплаченные счета, число открытых |
| `/last` | Последние 10 счетов: время, сумма, статус, идентификатор |
| `/status inv_…` | Статус одного счёта и его чек |
| `/cancel inv_…` | Отменяет счёт |
| `/support текст` | Отправляет вопрос в поддержку, ответ придёт в этот же чат |
| `/unlink` | Отвязывает чат от организации |
| `/help` | Краткий список команд |

Команды можно выбирать и из меню Telegram — бот регистрирует список сам.

## Русские и казахские варианты

Запоминать английские названия не обязательно, эти варианты тоже работают:

| Вариант | Основная команда |
|---|---|
| `/счет`, `/счёт`, `/шот`, `/inv` | `/invoice` |
| `/сегодня`, `/бүгін` | `/today` |
| `/статус` | `/status` |
| `/отмена` | `/cancel` |
| `/помощь`, `/қолдау`, `/көмек` | `/support` |

**В личном чате команду можно не писать вовсе:** сообщение, которое начинается с числа, считается запросом на счёт. Напишете `5000 Урок` — получите счёт на 5000 тенге с описанием «Урок».

Телефон распознаётся в любой записи: `8 700 123 45 67`, `+77001234567`, `7701-123-45-67`.

## Кнопки под ответом

Когда счёт создан, бот присылает его карточку: сумма, описание, статус, срок и идентификатор. Под карточкой — кнопки:

- **💳 Страница оплаты** — ссылка, которую отправляют покупателю (для QR-счёта);
- **🔄 Статус** — обновляет статус прямо в этом сообщении;
- **🚫 Отменить** — показывается, только пока счёт открыт.

В режиме песочницы на карточке стоит пометка `(sandbox)` — по ней видно, что реальных денег нет.

Если счёт отменён, но срок QR ещё не истёк, покупатель может успеть оплатить. Бот предупреждает об этом и присылает уведомление, когда деньги всё-таки приходят.

## Работа в группе

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

1. Добавьте бота в группу.
2. Напишите в группе `/start КОД` (код из кабинета).
3. Чтобы бот видел команды в группе, нужно **одно из двух**: @BotFather → `/setprivacy` → **Disable**, либо сделать бота администратором группы. Иначе Telegram не передаёт боту сообщения группы, и он молчит.

**Счёт в группе может создать любой участник.** Бот не разбирает роли, поэтому состав группы — ваша ответственность. Деньги всё равно приходят только на ваш счёт в Kaspi, но лишние счета путают отчётность.

В группе счёт «голым числом» не создаётся — там нужна полная команда `/invoice`.

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

В привязанный чат приходит следующее:

| Уведомление | Когда |
|---|---|
| ✅ ОПЛАЧЕНО | Счёт оплачен. Сумма, описание, номер заказа, данные клиента, номер чека |
| ↩️ Возврат / Частичный возврат | Когда возврат прошёл, с суммой возврата |
| ⌛ Истёк срок | Счёт так и не оплатили |
| 🚫 Отменён | Счёт отменили |
| ❌ Платёж не прошёл | Kaspi не провёл оплату |
| ⚠️ Предупреждение | Оборвалась привязка кассира Kaspi — со ссылкой на переподключение |

Если у счёта есть номер чека, к сообщению добавляется кнопка **🧾 Чек**. Пометка **ПОЗДНЯЯ ОПЛАТА** означает, что счёт был закрыт раньше, а деньги пришли позже: решать вам — выдать услугу или вернуть средства.

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

## Код привязки к организации

Код создаётся в кабинете: **Настройки** → Telegram-бот → получить код привязки.

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

Чтобы разорвать связь, напишите в этом чате `/unlink` или удалите чат из списка в кабинете.

## Чего бот не делает

- **Возвраты не оформляются.** Возврат денег доступен только в кабинете и через API — это сделано намеренно, потому что чат бота может быть открыт многим.
- **Настройки не меняются.** Ключи, вебхуки, тариф, кассир — всё в кабинете.
- **Счета чужой организации не видны.** Один чат привязан ровно к одной организации.

## Если бот молчит

Три самые частые причины: чат не привязан, в группе не выключен режим приватности, бот заблокирован. Пошаговая проверка: [Telegram-бот молчит](/kb/ru/telegram-bot-silent).

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

**Можно ли подключить своего бота?** В кабинете можно указать токен собственного бота и получать уведомления в него. Команды при этом работают через общий @QutPayBot.

**Работает ли `/support`, если чат не привязан?** Да. Если вы хотя бы раз входили в кабинет через Telegram, бот найдёт организацию по вашему номеру. Если не найдёт — предложит WhatsApp и почту: [Как написать в поддержку](/kb/ru/support-how).

**Виден ли счёт из бота в кабинете?** Да, все счета в одном списке. Канал, через который счёт создан, сохраняется.

**Что увидит клиент при счёте на телефон?** Счёт придёт в его приложение Kaspi: сумма, описание и номер вашего кассира. Подробнее: [Что видит покупатель](/kb/ru/what-customer-sees).

**Я хочу продавать в боте товары, а не просто выставлять счета.** Это отдельный сценарий: [Продажи через Telegram-бота](/kb/ru/for-telegram-bot).