Интеграция с реферальной системой для чат-ботов

1. Общая логика работы

Реферальная система позволяет автоматически:

генерировать персональные ссылки для подписчиков,
отслеживать приглашённых пользователей,
использовать данные о приглашениях в сценариях чат-бота.

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

2. Архитектура решения

Интеграция состоит из трёх ключевых уровней:

Настройки канала – подключение и авторизация
Комнаты (проекты) – логика хранения и учёта рефералов
Сценарии бота – использование ссылок и данных внутри воронки

3. Настройка канала

Перед началом работы необходимо подключить канал.

В разделе "Настройки канала":

авторизовать аккаунт Senler,
подключить VK token,
настроить webhook.

Назначение:

обеспечивает передачу событий (вход по ссылке, регистрация пользователя),
связывает чат-бот с реферальной системой.

Статусы подключения должны быть активны.

4. Работа с комнатами

4.1. Назначение комнаты

Комната – это отдельная сущность для:

учёта рефералов,
изоляции данных разных проектов,
настройки переменных.

Для каждого проекта (сценарий/бот/воронка) рекомендуется использовать отдельную комнату.

4.2. Создание комнаты

При создании комнаты задаются:

название комнаты,
системная метка (используется для генерации переменных) – только латинские буквы и цифры, максимум 8 символов,
параметры хранения данных (в какого чат-бота добавлять приглашенных пользователей).

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

В этом случае – вы можете направлять его на заранее заготовленного бота с сообщением, о том, что так делать нельзя и приглашение самого себя не засчитывается.

После создания автоматически формируются переменные:

ссылка пользователя,
количество приглашённых,
список приглашённых.

4.3. Редактирование комнаты

Доступны действия:

изменение названия,
управление логикой хранения.

Важно: изменение метки после создания комнаты – недоступно, она закрепляется за комнатой.

5. Настройка сценария чат-бота

5.1. Генерация реферальной ссылки

После входа пользователя в бота необходимо добавить шаг с интеграцией:

Действие: "Сгенерировать ссылку"

Что происходит:

пользователю создаётся уникальная реферальная ссылка,
ссылка записывается в переменную.

Пример переменной:

{%rl_test_url%}

Далее эту переменную необходимо вставить в сообщение бота, в котором вы человеку эту ссылку выдаёте:

Пример:

Вот ваша ссылка для приглашения: {%rl_test_url%}

5.2. Получение данных по рефералам

Используется шаг с интеграцией:

Действие: "Получить данные подписчика"

Доступные переменные:

Количество приглашённых:

{%rl_test_count%}

Список приглашённых:

{%rl_test_list%}

Пример сообщения:

Количество приглашённых: {%rl_test_count%}

Список:

{%rl_test_list%}

Для того, чтобы переменные корректно отображались у пользователя и вы могли продолжить сценарий или выдачу бонуса за выполненное задание – после шага с интеграцией необходимо добавить условие проверки значения пользовательской переменной типа “Количество приглашенных”, в рамках примера в этом руководстве это будет – {%rl_test_count%}.

ВАЖНО: Все переменные выше – это примеры.

Для каждой комнаты формируются свои переменные в зависимости от метки, которую вы установили в настройках комнаты.

6. Использование в пользовательских переменных

Пользовательские переменные могут использоваться:

для генерации промокодов,
персонализации предложений,
сегментации пользователей.

Примеры:

уникальный промокод на основе ID, количества приглашённых или порядковому номеру;
разные офферы в зависимости от количества приглашенных.

7. Типовой сценарий внедрения

Подключить канал (Senler, токен, webhook)
Создать комнату проекта
Добавить в сценарий:
1. шаг генерации ссылки,
2. сообщение с выдачей ссылки.
Добавить:
1. шаг получения данных,
2. условие проверки значения переменной количества приглашенных.
Настроить условия продолжения сценария по количеству приглашённых
При необходимости добавить генерацию промокодов с помощью пользовательских переменных.

8. Ограничения и особенности

Один пользователь закрепляется только за одним пригласившим
Повторные переходы по другим ссылкам не учитываются
Учёт начинается с момента первого входа по реферальной ссылке
Корректная работа требует активного webhook
В ВК приглашенный не сможет попасть в бота просто перейдя по ссылке, важно, чтобы он что-то написал в сообщество, для этого рекомендуем в настройках сообщества создать приветственное сообщение и включить кнопку “начать”

Данная интеграция поможет вам создавать новые геймифицированные механики, акции, инфоповоды и увеличить трафик в ваших чат-ботов и рассылки с помощью приглашений друзей от вашей действующей базы подписчиков.

Шаблон чат-бота с интеграцией: https://senler.ru/cabinet/botshare/3302675_5df55ccb8478174178f716b175f0a9f5

Разработано совместно с агентством XPAB