# Рахунки та реферали

У [картки контакту](https://support.watbot.org/uk/chatbots/contacts/card) є дві вкладки крім «Основне»: «Рахунки» і «Реферали».

## Рахунки

Рахунок — це внутрішній баланс контакту в боті: бонуси, бали, депозит. Це облік усередині бота, а не гаманець у платіжній системі. На кожну валюту в контакту свій рахунок.

### Як з'являється рахунок

Відкрити рахунок вручну в кабінеті не можна. Рахунок з'являється сам, коли на нього в цій валюті вперше надходять гроші, — наприклад, після блоків сценарію:

- [«Поповнити рахунок контакту»](https://support.watbot.org/uk/chatbots/blocks/contact-data/top-up-balance);
- [«Нарахувати винагороду рефереру»](https://support.watbot.org/uk/chatbots/blocks/contact-data/referrer-reward).

Списує з рахунку блок [«Списати з рахунку контакту»](https://support.watbot.org/uk/chatbots/blocks/contact-data/debit-balance). Усі блоки для роботи з даними контакту — у розділі [Блоки](https://support.watbot.org/uk/chatbots/blocks).

Поки рахунків немає, на вкладці написано «Порожньо».

### Вкладка «Рахунки»

У таблиці — «Валюта», «Баланс» і «Дата створення» кожного рахунку. Праворуч кнопки:

| Кнопка | Що робить |
|---|---|
| «+» | Відкриває вікно «Поповнити рахунок» |
| «−» | Відкриває вікно «Списати з рахунку» |
| «Журнал» | Показує всі операції за рахунком |
| «Заблокувати» / «Розблокувати» | Забороняє або знову дозволяє списання з рахунку |

![Вкладка «Рахунки»: рахунок контакту з балансом і кнопками](https://support.watbot.org/_media/uk/01-chatbots/07-contacts/_images/accounts.webp?v=1791781231)

### Поповнити або списати вручну

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

Списати більше, ніж є на рахунку, не можна.

### Блокування рахунку

Із заблокованого рахунку не можна списати гроші — ні вручну, ні сценарієм:

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

Поповнювати заблокований рахунок можна. Кнопка «Розблокувати» знімає заборону.

### Журнал

Кнопка «Журнал» відкриває список операцій за рахунком: «Тип», «Сума», «Опис» і «Дата операції». Угорі — останні.

![Журнал рахунку: поповнення блоком, поповнення і списання менеджером](https://support.watbot.org/_media/uk/01-chatbots/07-contacts/_images/journal.webp?v=1791781231)

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

Показати баланс самому контакту можна в повідомленні — функцією `getBalance`. Її описано на сторінці [Функції](https://support.watbot.org/uk/chatbots/templates/functions).

## Реферали

Реферальний зв'язок показує, хто кого привів у бота:

- **реферер** — контакт, який запросив людину;
- **реферал** — запрошений контакт.

Зв'язки складаються в ланцюжок. Ті, кого контакт запросив сам, — його перша лінія. Ті, кого запросили вони, — друга, і так далі. Усі лінії разом — мережа контакту.

### Як виникає зв'язок

**За реферальним посиланням.** У кожного контакту своє реферальне посилання на бота. Бот надсилає його людині в повідомленні — функціями з розділу «Реферальна програма» на сторінці [Функції](https://support.watbot.org/uk/chatbots/templates/functions). Коли за цим посиланням у бота приходить інша людина, вона стає рефералом власника посилання. Якщо в того, хто прийшов, уже є реферер, зв'язок не змінюється.

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

1. У рядку «Реферер (той, хто запросив)» натисніть «Призначити».
2. Введіть ID контакту-реферера. ID показано в шапці його картки та в першій колонці списку контактів.
3. Натисніть «Зберегти».

Хрестик поруч з іменем реферера прибирає зв'язок. Запрошені самим контактом при цьому залишаються за ним.

### Сповіщення про нового реферала

Бот може повідомляти рефереру, що за його посиланням прийшла нова людина. Це вмикається в налаштуваннях бота, на вкладці «Додатково»: перемикач «Отримувати сповіщення про нових рефералів» і поле «Глибина» — до якої лінії вгору ланцюжком надсилати сповіщення. Там само задається свій текст — «Власне повідомлення про нового реферала». Докладніше — у розділі [Налаштування бота](https://support.watbot.org/uk/chatbots/settings).

Коли реферера призначають вручну, сповіщення не надсилається.

### Де подивитися

- **У картці контакту**, у розділі «Реферальна програма»: «Реферер (той, хто запросив)» — хто запросив; «Реферали» — «Перша лінія» і «Вся мережа» з кількістю запрошених. Рядок «Реферали» є, лише якщо контакт когось запросив.
- **На вкладці «Реферали»** — контакти першої лінії: ID, «Ім'я», «Телефон», «Username» і «Кількість рефералів». В останній колонці два числа: запрошені самим рефералом і вся його мережа. Клік по імені відкриває картку реферала — так можна пройти ланцюжком униз.
- **У списку контактів** — колонка «Реферер».
- **У вивантаженні контактів** — колонка Referrer ID.

![Вкладка «Реферали»: запрошені контактом і кількість їхніх рефералів](https://support.watbot.org/_media/uk/01-chatbots/07-contacts/_images/referrals.webp?v=1791781231)

### Що можна робити з рефералами

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

## Якщо щось не працює

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