Счета и рефералы
У карточки контакта есть две вкладки помимо «Основное»: «Счета» и «Рефералы».
Счета
Счёт — это внутренний баланс контакта в боте: бонусы, баллы, депозит. Это учёт внутри бота, а не кошелёк в платёжной системе. На каждую валюту у контакта свой счёт.
Как появляется счёт
Открыть счёт вручную в кабинете нельзя. Счёт появляется сам, когда на него в этой валюте впервые приходят деньги, — например, после блоков сценария:
Списывает со счёта блок «Списать со счета контакта». Все блоки для работы с данными контакта — в разделе Блоки.
Пока счетов нет, на вкладке написано «Пусто».
Вкладка «Счета»
В таблице — «Валюта», «Баланс» и «Дата создания» каждого счёта. Справа кнопки:
| Кнопка | Что делает |
|---|---|
| «+» | Открывает окно «Пополнить счет» |
| «−» | Открывает окно «Списать со счета» |
| «Журнал» | Показывает все операции по счёту |
| «Заблокировать» / «Разблокировать» | Запрещает или снова разрешает списания со счёта |
Пополнить или списать вручную
- Нажмите «+» или «−» в строке счёта.
- Укажите «Сумма» и «Описание» — оба поля обязательны. Описание попадёт в журнал, по нему потом будет понятно, за что прошла операция.
- Нажмите «Пополнить» или «Списать».
Списать больше, чем есть на счёте, нельзя.
Блокировка счёта
С заблокированного счёта нельзя списать деньги — ни вручную, ни сценарием:
- блок «Списать со счета контакта» поведёт контакта по ветке нехватки средств;
- блок «Пополнить счет контакта» с отрицательной суммой ничего не спишет и остановит сценарий.
Пополнять заблокированный счёт можно. Кнопка «Разблокировать» снимает запрет.
Журнал
Кнопка «Журнал» открывает список операций по счёту: «Тип», «Сумма», «Описание» и «Дата операции». Сверху — последние.
| Тип | Откуда операция |
|---|---|
| «Пополнение блоком», «Списание блоком» | Блоки сценария |
| «Пополнение менеджером», «Списание менеджером» | Вручную на вкладке «Счета» |
| «Пополнение рефералом» | Реферальное вознаграждение |
| «Пополнение через платежную систему», «Списание платежной системой» | Оплата через платёжную систему |
| «Пополнение через API», «Списание через API» | Внешняя программа через API платформы |
Показать баланс самому контакту можно в сообщении — функцией getBalance. Она описана на странице Функции.
Рефералы
Реферальная связь показывает, кто кого привёл в бота:
- реферер — контакт, который пригласил человека;
- реферал — приглашённый контакт.
Связи складываются в цепочку. Те, кого контакт пригласил сам, — его первая линия. Те, кого пригласили они, — вторая, и так далее. Все линии вместе — сеть контакта.
Как возникает связь
По реферальной ссылке. У каждого контакта своя реферальная ссылка на бота. Бот отправляет её человеку в сообщении — функциями из раздела «Реферальная программа» на странице Функции. Когда по этой ссылке в бота приходит другой человек, он становится рефералом владельца ссылки. Если у пришедшего уже есть реферер, связь не меняется.
Вручную. В карточке контакта, в разделе «Реферальная программа»:
- В строке «Реферер (родитель)» нажмите «Назначить».
- Введите ID контакта-реферера. ID показан в шапке его карточки и в первой колонке списка контактов.
- Нажмите «Сохранить».
Крестик рядом с именем реферера убирает связь. Приглашённые самим контактом при этом остаются за ним.
Уведомление о новом реферале
Бот может сообщать рефереру, что по его ссылке пришёл новый человек. Это включается в настройках бота, на вкладке «Дополнительно»: переключатель «Получать уведомление о новых рефералах» и поле «Глубина» — до какой линии вверх по цепочке отправлять уведомление. Там же задаётся свой текст — «Пользовательское сообщение о новом реферале». Подробнее — в разделе Настройки бота.
Когда реферера назначают вручную, уведомление не отправляется.
Где посмотреть
- В карточке контакта, в разделе «Реферальная программа»: «Реферер (родитель)» — кто пригласил; «Рефералы» — «Первая линия» и «Вся сеть» с числом приглашённых. Строка «Рефералы» есть, только если контакт кого-то пригласил.
- На вкладке «Рефералы» — контакты первой линии: ID, «Имя», «Телефон», «Username» и «Количество рефералов». В последней колонке два числа: приглашённые самим рефералом и вся его сеть. Клик по имени открывает карточку реферала — так можно пройти по цепочке вниз.
- В списке контактов — колонка «Реферер».
- В выгрузке контактов — колонка Referrer ID.
Что можно делать с рефералами
- начислять вознаграждение пригласившим — блок «Начислить вознаграждение рефереру»;
- ветвить сценарий по числу приглашённых — блок «Условие»;
- отбирать получателей рассылки фильтром «Имеет определенное количество рефералов» — страница Получатели и фильтры;
- показывать контакту его ссылку и список приглашённых — функции автоподстановок.
Если что-то не работает
- «Недостаточно средств». Сумма списания больше баланса счёта. То же сообщение появится при списании с заблокированного счёта — сначала разблокируйте его.
- «Передана нулевая сумма». Укажите сумму больше нуля.
- «Такой реферер для текущего бота не найден». Контакта с таким ID нет в этом боте. Реферером может быть только контакт того же бота.
- «Текущий контакт не может быть реферером для самого себя». Указан ID самого контакта.
- «Указанный вами реферер находится в сети рефералов текущего контакта». Нельзя назначить реферером того, кого этот контакт сам привёл — напрямую или через цепочку.