# Счета и рефералы

У [карточки контакта](https://support.watbot.ru/chatbots/contacts/card) есть две вкладки помимо «Основное»: «Счета» и «Рефералы».

## Счета

Счёт — это внутренний баланс контакта в боте: бонусы, баллы, депозит. Это учёт внутри бота, а не кошелёк в платёжной системе. На каждую валюту у контакта свой счёт.

### Как появляется счёт

Открыть счёт вручную в кабинете нельзя. Счёт появляется сам, когда на него в этой валюте впервые приходят деньги, — например, после блоков сценария:

- [«Пополнить счет контакта»](https://support.watbot.ru/chatbots/blocks/contact-data/top-up-balance);
- [«Начислить вознаграждение рефереру»](https://support.watbot.ru/chatbots/blocks/contact-data/referrer-reward).

Списывает со счёта блок [«Списать со счета контакта»](https://support.watbot.ru/chatbots/blocks/contact-data/debit-balance). Все блоки для работы с данными контакта — в разделе [Блоки](https://support.watbot.ru/chatbots/blocks).

Пока счетов нет, на вкладке написано «Пусто».

### Вкладка «Счета»

В таблице — «Валюта», «Баланс» и «Дата создания» каждого счёта. Справа кнопки:

| Кнопка | Что делает |
|---|---|
| «+» | Открывает окно «Пополнить счет» |
| «−» | Открывает окно «Списать со счета» |
| «Журнал» | Показывает все операции по счёту |
| «Заблокировать» / «Разблокировать» | Запрещает или снова разрешает списания со счёта |

![Вкладка «Счета»: счёт контакта с балансом и кнопками](https://support.watbot.ru/_media/ru/01-chatbots/07-contacts/_images/accounts.webp?v=1791781230)

### Пополнить или списать вручную

1. Нажмите «+» или «−» в строке счёта.
2. Укажите «Сумма» и «Описание» — оба поля обязательны. Описание попадёт в журнал, по нему потом будет понятно, за что прошла операция.
3. Нажмите «Пополнить» или «Списать».

Списать больше, чем есть на счёте, нельзя.

### Блокировка счёта

С заблокированного счёта нельзя списать деньги — ни вручную, ни сценарием:

- блок «Списать со счета контакта» поведёт контакта по ветке нехватки средств;
- блок «Пополнить счет контакта» с отрицательной суммой ничего не спишет и остановит сценарий.

Пополнять заблокированный счёт можно. Кнопка «Разблокировать» снимает запрет.

### Журнал

Кнопка «Журнал» открывает список операций по счёту: «Тип», «Сумма», «Описание» и «Дата операции». Сверху — последние.

![Журнал счёта: пополнение блоком, пополнение и списание менеджером](https://support.watbot.ru/_media/ru/01-chatbots/07-contacts/_images/journal.webp?v=1791781230)

| Тип | Откуда операция |
|---|---|
| «Пополнение блоком», «Списание блоком» | Блоки сценария |
| «Пополнение менеджером», «Списание менеджером» | Вручную на вкладке «Счета» |
| «Пополнение рефералом» | Реферальное вознаграждение |
| «Пополнение через платежную систему», «Списание платежной системой» | Оплата через платёжную систему |
| «Пополнение через API», «Списание через API» | Внешняя программа через API платформы |

Показать баланс самому контакту можно в сообщении — функцией `getBalance`. Она описана на странице [Функции](https://support.watbot.ru/chatbots/templates/functions).

## Рефералы

Реферальная связь показывает, кто кого привёл в бота:

- **реферер** — контакт, который пригласил человека;
- **реферал** — приглашённый контакт.

Связи складываются в цепочку. Те, кого контакт пригласил сам, — его первая линия. Те, кого пригласили они, — вторая, и так далее. Все линии вместе — сеть контакта.

### Как возникает связь

**По реферальной ссылке.** У каждого контакта своя реферальная ссылка на бота. Бот отправляет её человеку в сообщении — функциями из раздела «Реферальная программа» на странице [Функции](https://support.watbot.ru/chatbots/templates/functions). Когда по этой ссылке в бота приходит другой человек, он становится рефералом владельца ссылки. Если у пришедшего уже есть реферер, связь не меняется.

**Вручную.** В карточке контакта, в разделе «Реферальная программа»:

1. В строке «Реферер (родитель)» нажмите «Назначить».
2. Введите ID контакта-реферера. ID показан в шапке его карточки и в первой колонке списка контактов.
3. Нажмите «Сохранить».

Крестик рядом с именем реферера убирает связь. Приглашённые самим контактом при этом остаются за ним.

### Уведомление о новом реферале

Бот может сообщать рефереру, что по его ссылке пришёл новый человек. Это включается в настройках бота, на вкладке «Дополнительно»: переключатель «Получать уведомление о новых рефералах» и поле «Глубина» — до какой линии вверх по цепочке отправлять уведомление. Там же задаётся свой текст — «Пользовательское сообщение о новом реферале». Подробнее — в разделе [Настройки бота](https://support.watbot.ru/chatbots/settings).

Когда реферера назначают вручную, уведомление не отправляется.

### Где посмотреть

- **В карточке контакта**, в разделе «Реферальная программа»: «Реферер (родитель)» — кто пригласил; «Рефералы» — «Первая линия» и «Вся сеть» с числом приглашённых. Строка «Рефералы» есть, только если контакт кого-то пригласил.
- **На вкладке «Рефералы»** — контакты первой линии: ID, «Имя», «Телефон», «Username» и «Количество рефералов». В последней колонке два числа: приглашённые самим рефералом и вся его сеть. Клик по имени открывает карточку реферала — так можно пройти по цепочке вниз.
- **В списке контактов** — колонка «Реферер».
- **В выгрузке контактов** — колонка Referrer ID.

![Вкладка «Рефералы»: приглашённые контактом и число их рефералов](https://support.watbot.ru/_media/ru/01-chatbots/07-contacts/_images/referrals.webp?v=1791781230)

### Что можно делать с рефералами

- начислять вознаграждение пригласившим — блок [«Начислить вознаграждение рефереру»](https://support.watbot.ru/chatbots/blocks/contact-data/referrer-reward);
- ветвить сценарий по числу приглашённых — блок [«Условие»](https://support.watbot.ru/chatbots/blocks/logic/condition);
- отбирать получателей рассылки фильтром «Имеет определенное количество рефералов» — страница [Получатели и фильтры](https://support.watbot.ru/chatbots/mailings/audience);
- показывать контакту его ссылку и список приглашённых — [функции](https://support.watbot.ru/chatbots/templates/functions) автоподстановок.

## Если что-то не работает

- **«Недостаточно средств».** Сумма списания больше баланса счёта. То же сообщение появится при списании с заблокированного счёта — сначала разблокируйте его.
- **«Передана нулевая сумма».** Укажите сумму больше нуля.
- **«Такой реферер для текущего бота не найден».** Контакта с таким ID нет в этом боте. Реферером может быть только контакт того же бота.
- **«Текущий контакт не может быть реферером для самого себя».** Указан ID самого контакта.
- **«Указанный вами реферер находится в сети рефералов текущего контакта».** Нельзя назначить реферером того, кого этот контакт сам привёл — напрямую или через цепочку.