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

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

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

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

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

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

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

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

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)

Создать комнату проекта

Добавить в сценарий:

• шаг генерации ссылки
• сообщение с выдачей ссылки

Добавить:

• шаг получения данных
• условие проверки значения переменной количества приглашенных

Настроить условия продолжения сценария по количеству приглашённых

При необходимости добавить генерацию промокодов с помощью пользовательских переменных.

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

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

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

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

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

Эфир по подключению и работе интеграции смотрите тут: