Интеграция с Senler позволяет автоматически управлять подписчиками VK или Telegram-канала: добавлять в группы рассылок, подписывать на боты (воронки), запускать с конкретного шага бота, записывать переменные подписчика и сообщества, навешивать UTM-метки. Работает в трёх сценариях: при регистрации, после вебинара и при оплате. Ниже — как подключить, что нужно знать про идентификацию подписчика и какие действия доступны.
Подключение
- В Vakas-tools перейдите в Сервисы и доступы → Добавить сервис → Senler.
- Укажите Название подключения (произвольное, для вашего удобства — например, «Senler TG Курс»).
- Введите Access Token (API-ключ из Senler).
- Введите ID группы ВК или ID Telegram-канала.
- Нажмите «Добавить сервис».
Где взять Access Token
- Откройте Senler → Настройки канала → Работа с API.
- Нажмите «Создать ключ доступа».
- Скопируйте получившийся ключ.
.png)
.png)
.png)
.png)
На один аккаунт Senler можно создать до 20 ключей. Если ключей уже 20 — старый придётся удалить или использовать.
Где взять ID группы / ID канала
- VK: Senler → Настройки канала → «Работа с API» → ID группы написан вверху страницы.
- Telegram: Senler → Настройки бота Telegram → ID канала.
.png)
Если вы случайно введёте ID Telegram-канала в подключении, которое подразумевает VK (или наоборот), система сама перепроверит как другой тип канала и подстроится. Но название поля — одно и то же, можно вставлять любой ID.
Важно: главное про подписчика
Чтобы Vakas-tools мог что-то сделать в Senler с конкретным человеком (записать переменную, подписать на бота, добавить в группу), у этого человека в базе должен быть User ID Senler:
- для VK — vk_user_id (числовой ID ВК);
- для Telegram — tg_user_id.
Без User ID любое действие, кроме «Глобальные переменные», вернёт ошибку «Не найден User ID подписчика».
Откуда система берёт User ID
Поиск идёт строго по этой цепочке (как только нашли — остальные шаги пропускаются):
- Шорткод из настроек сервиса (см. ниже «Общие настройки» → «User ID подписчика»). Если там что-то указано — берём оттуда.
- Если не указан шорткод, то для VK-подключения — vk_user_id из контакта; для Telegram — tg_user_id.
В логах (канал senler) после каждого действия видно, как именно нашли ID: user_id_resolved_by = base_data (vk_user_id), base_data_service_params (tg_user_id) и т.д. — это помогает понять, почему ID нашёлся или не нашёлся.
Как заставить Senler присылать User ID (входящий вебхук)
Самый надёжный способ — настроить вебхук из Senler в Vakas-tools. Тогда при каждой подписке/действии в Senler на сторону Vakas-tools прилетят vk_user_id (или tg_user_id) и они сохранятся в контакте автоматически.
Чтобы у контактов в Vakas-tools появлялся vk_user_id / tg_user_id (без него действия не сработают), Senler должен отправлять данные о действиях подписчиков в Vakas-tools.
Как настроить вебхук в Senler
- В Senler откройте бот → действие/событие, при котором надо передавать данные.
- Добавьте действие «Webhook» (отправка данных).
- Вставьте URL вебхука Vakas-Tools (берётся в Vakas-Tools → раздел «Базы» → «Ссылки» → ссылка-вебхук для Senler).
- Сохраните.
Как работает интеграция — общая схема
Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.
1 Правило
2 Условия (внутри правила)
3 Действия (кнопка напротив правила)
Значок ⧉ — множественное добавление
Рядом с названием некоторых действий отображается зелёный значок ⧉ (два квадрата). Он означает, что это действие можно добавить несколько раз с разными настройками. Действия без этого значка можно добавить только один раз.
Правила и условия
Передача в Senler настраивается через стандартную для Vakas-tools связку Правило → Условие → Действие.
Создайте Правило
Нажмите ➕ Добавить правило. Это «папка» для ваших настроек.. . Хотите обрабатывать все события? → Оставьте правило без условий. Нужны только определённые (например, только VIP-оплаты)? → Добавьте условие внутри.
Настройте Условия (по желанию)
Условие — это фильтр. Например:
1. Название тарифа — содержит — VIP → подписать на воронку «VIP-приветствие» только VIP-покупателей.
2. Был на вебинаре — равно — Да → добавить в группу «Был на вебинаре».
3. Статус платежа — равно — Оплачено → подписать на бота «Дожим upsell» только после успешной оплаты.
Назначьте Действия
Нажмите Действия. Пока вы не добавите конкретное действие — событие просто пропустится, в Senler ничего не уйдёт.
Действия Senler
Действий восемь. Все, кроме «Глобальных переменных», требуют User ID подписчика.
1. Переменные подписчика
Записывает пользовательские переменные в карточку конкретного подписчика в Senler.
| Поле | Описание |
|---|---|
| Имя переменной | Название переменной в Senler (например, name, course, phone_call). Латиницей, без пробелов. |
| Значение | Что записать. Поддерживает шорткоды ({#name#}, {#email#}, {#positions#} и т. д.). |
Можно добавить сколько угодно пар «имя — значение» в одном действии — каждая пара отправится отдельным вызовом vars/set. Если хотя бы одна не записалась — действие вернёт ошибку с деталями (по каким именам сорвалось и почему).
2. Глобальные переменные
То же самое, но переменные общие для всего сообщества, а не привязаны к подписчику.
| Поле | Описание | |
|---|---|---|
| Имя переменной | Название глобальной переменной. | |
| Значение | Что записать. Поддерживает шорткоды. |
User ID не нужен. Это единственное действие, которое сработает даже если у контакта нет vk_user_id/tg_user_id. Используется для счётчиков, общих дат, последних значений.
3. Добавить в группу
Добавляет подписчика в группу рассылки Senler.
| Поле | Описание | |
|---|---|---|
| Группа подписчиков | Выбор из списка. Список подгружается из вашего Senler автоматически (с пагинацией — все группы, не только первые 100). | |
| UTM Source | Источник для аналитики Senler. Поддерживает шорткоды. | |
| UTM Medium | Канал | |
| UTM Campaign | Компания |
UTM-параметры опциональны — без них группа просто добавится без меток.
4. Удалить из группы
Удаляет подписчика из группы рассылки.
| Поле | Описание | |
|---|---|---|
| Группа подписчиков | Конкретная группа или «-- Все группы (отписать от всех) --» в начале списка — отпишет от всех групп этого канала сразу. |
5. Подписать на бота
Запускает подписчика по воронке (боту) Senler с первого шага.
| Поле | Описание | |
|---|---|---|
| Бот | Выбор из списка. Боты со статусом «Не активен» помечены (Не активен) — выбирать их можно, но они не запустятся, пока вы не активируете их в Senler. | |
| Повторная подписка | По умолчанию — выкл. Если включено, подписчик пройдёт воронку заново, даже если уже её проходил. Без галочки повторно подписать нельзя. |
6. Отписать от бота
Удаляет подписчика из бота (воронки).
7. Подписать на шаг бота
Подписывает подписчика сразу на нужный шаг воронки, а не с её начала. Полезно, чтобы перевести «горячего» лида сразу к продающему шагу.
| Поле | Описание | |
|---|---|---|
| Бот | Выбор из списка. | |
| ID шага (step_id) | Числовой/строковый ID шага. Введите вручную. | |
| Повторная подписка | Если включено — подписчик пройдёт шаг заново, даже если уже подписан. |
Как найти step_id: откройте бота в Senler → выберите нужный шаг → ID шага виден в URL страницы или в настройках шага.
8. Добавить с UTM-меткой
Добавляет подписчика в группу с привязкой готовой UTM-метки, созданной в самом Senler (не произвольных строк, как в действии №3, а сохранённого в Senler объекта-метки).
| Поле | Описание | |
|---|---|---|
| Группа подписчиков | Выбор из списка | |
| UTM-метка | Выбор из списка UTM-меток, созданных в Senler. |
Готовые примеры настройки
Регистрация → переменные + подписка на бота напоминания
Раздел: Регистрации. Правило без условий.
Переменные подписчика:
name = {#name#}
webdate = {#vebinar_time_date#}
webtime = {#vebinar_time_hi#}
weblink = {#bizon_url#}
Подписать на бота: «Напоминание о вебинаре»
Добавить в группу: «Зарегистрированы на вебинар» (UTM-метки опционально)
После вебинара (был, не кликнул) → перевод в «прогрев»
Раздел: Отчёты. Условие: Был минут > 30 И Кликал по кнопке = 0.
Отписать от бота: «Напоминание о вебинаре»
Подписать на бота: «Прогрев — был, но не купил»
После вебинара (не был) → перевод в «дожим записью»
Раздел: Отчёты. Условие: Был на вебинаре = Нет.
Отписать от бота: «Напоминание о вебинаре»
Подписать на бота: «Запись вебинара + дожим»
Оплата → благодарность + апсейл
Раздел: Оплаты. Условие: Статус платежа = Оплачено.
Переменные подписчика:
tariff = {#positions#}
amount = {#costMoney#}
Отписать от бота: «Дожим оплаты»
Подписать на бота: «Благодарность + апсейл»
Добавить в группу: «Покупатели»
Неоплаченный заказ → дожим
Раздел: Оплаты. Условие: Статус платежа содержит Ожидает оплаты.
Подписать на бота: «Дожим оплаты»
Переменные подписчика:
paylink = {#paymentLink#}
left = {#leftCostMoney#}
Запустить с конкретного шага бота
Например, у вас есть длинная воронка из 10 шагов. Хотите запустить лида сразу с шага №5 (продающий блок).
Подписать на шаг бота:
Бот: «Главная воронка»
ID шага: 12345 (взять в Senler из URL шага)
Повторная подписка: ✓ (если лид уже был в этой воронке раньше)
Глобальный счётчик регистраций
Раздел: Регистрации. Правило без условий.
Глобальные переменные:
last_registration = {#name#} ({#email#})
last_reg_time = {#date#}