Для чего нужна интеграция
Что можно сделать в Vakas-tools совместно с BotHelp:
- Сбор регистраций с чат-бота.
- Передача регистраций в воронку BotHelp.
- Передача событий из отчётов с вебинара в воронку BotHelp.
- Передача данных о заказах и оплатах клиента в воронку BotHelp.
В зависимости от полученных данных из Vakas-tools можно запускать сегментированные цепочки сообщений в чат-боте.
Шаги интеграции
Для передачи данных в BotHelp система ищет подписчика по идентификатору bothelp_id, а если его нет — по email или телефону. Идеальный вариант: в базе Vakas-tools у контакта есть bothelp_id, тогда поиск быстрый и надёжный. Но если идентификатора нет, достаточно совпадения email или телефона в обеих системах.
- Подключение BotHelp к Vakas-tools.
- Передача контактов с Tilda в BotHelp со страницы регистрации или через минилендинг (если у вас уже есть контакты в BotHelp, пропустите этот шаг).
- Передача контактов из BotHelp в Vakas-tools с идентификатором bothelp_id (желательно, но не обязательно — без него поиск идёт по email/телефону).
- Настройка передачи данных — регистрации, отчёты, заказы.
Создание базы
Инструкция по созданию базы по ссылке. Если база создана, пропустите этот шаг.
Подключение Bothelp
Инструкция по подключению по ссылке. Если подключение создано, пропустите этот шаг.
Сбор контактов и получение идентификатора BotHelp
Для передачи данных в BotHelp желательно, чтобы у контакта в базе был идентификатор подписчика (bothelp_id). С ним поиск подписчика быстрый и точный. Без него система найдёт подписчика по email или телефону, но контакт должен быть и в Vakas-tools, и в BotHelp.
Получить bothelp_id можно двумя способами: через виджет на Tilda или через минилендинг BotHelp. Если подписчики у вас уже есть в BotHelp, переходите сразу к настройке бота.
Через страницу «Спасибо» на Tilda
Если у вас уже есть контакты в BotHelp, пропустите этот раздел.
Этот способ подходит, когда регистрации собираются на лендинге (например, Tilda) и на странице «Спасибо» лиды подписываются на бота.
1 Создайте виджет-кнопку в BotHelp
Перейдите в BotHelp.
В меню слева выберите «Инструменты роста».
Создайте виджет-кнопку для регистрации лидов:
Выберите соцсеть или мессенджер, в котором будет запускаться бот.
Настройте дизайн виджета.
Нажмите «Сохранить».
2 Скопируйте код активации виджета
Перейдите к установке виджета.
Скопируйте код активации в буфер обмена — этот код нужно добавить в страницы «Спасибо».
3 Добавьте код активации на страницу «Спасибо» в Tilda
Перейдите в Tilda на страницу «Спасибо».
Добавьте блок «Другое» → «HTML-код».
Нажмите «Контент».
Вставьте скопированный код активации и нажмите «Сохранить и закрыть».
Перенесите этот блок в самый верх страницы (в раздел).
4 Добавьте код виджета на страницу «Спасибо»
Вернитесь в BotHelp и скопируйте код виджета (отличается от кода активации).
На странице «Спасибо» в Tilda аналогично добавьте блок «Другое» → «HTML-код».
Вставьте код виджета в то место страницы, где должна отображаться кнопка подписки на бота.
Нажмите «Сохранить и закрыть».
5 Добавьте скрипт передачи данных на страницу регистрации
Скопируйте скрипт.
Перейдите в Tilda на страницу регистрации (где собираются контактные данные лидов).
Добавьте блок «Другое» → «HTML-код».
Вставьте скрипт.
В скрипте замените {ссылка_на_страницу_спасибо_1} на свою ссылку.
6 Опубликуйте страницы
В Tilda нажмите вверху справа «Опубликовать» на обеих страницах:
- Страница регистрации.
- Страница «Спасибо».
Важно: ссылка должна быть с протоколом (http:// или https://) и в одинарных кавычках. Пример: 'https://mysite.ru/thankyou'
Как это работает
- Лид заполняет форму на странице регистрации → данные (имя, email, телефон) передаются на страницу «Спасибо».
- На странице «Спасибо» лид видит виджет-кнопку и подписывается на бота → данные уходят в BotHelp.
- Через бота данные вместе с bothelp_id отправляются обратно в Vakas-tools через вебхук.
- Теперь из Vakas-tools можно передавать дополнительные переменные (дата вебинара, ссылка на комнату и т.д.) обратно в BotHelp.
Через минилендинг BotHelp
Если у вас уже есть контакты в BotHelp, пропустите этот раздел.
Этот способ подходит, когда сбор регистраций происходит не через Tilda и страницу «Спасибо», а через собственный минилендинг BotHelp.
1 Создайте минилендинг в BotHelp
Перейдите в BotHelp.
В меню слева выберите «Инструменты роста».
Создайте новый инструмент — «Мини-лендинг».
2 Настройте минилендинг
Укажите данные, которые будут запрашиваться у пользователя, и способ их запроса.
Выберите бота или авторассылку, которая запустится после регистрации.
3 Настройте передачу данных в Vakas-tools через вебхук
Скопируйте вебхук из Vakas-tools. Перейдите в «Базы» → «Ссылки».
Спуститесь ниже и найдите раздел «Webhook для BotHelp».
Скопируйте ссылку вебхука и вставьте в Bothelp.
4 Получите ссылку на минилендинг
Вернитесь в настройки минилендинга.
Справа будет доступна ссылка на созданную страницу.
Перейдите по ссылке и протестируйте регистрацию лида.
Перейдите в Контакты у Базы в которую передаете и с которой копировали вебхук, найдите контакт, который передавали тестово и проверьте, чтобы в данных с регистрации были данные с Bothelp.
Важно: для Vakas-tools обязательно необходимо собирать контакты — email, номер телефона или оба поля.
Важно: передача bothelp_id желательна, но не обязательна. Если идентификатора нет, система попробует найти подписчика в BotHelp по email или телефону. Для этого контакт должен существовать и в базе Vakas-tools, и в BotHelp с совпадающим email или телефоном. С bothelp_id поиск надёжнее и быстрее.
Как это работает
- Лид переходит на минилендинг BotHelp и заполняет форму (email, телефон).
- Запускается бот, который через вебхук отправляет данные (включая bothelp_id) в Vakas-tools.
- В базе Vakas-tools появляется контакт с bothelp_id → можно передавать данные обратно в BotHelp.
Настройка бота для передачи bothelp_id в Vakas-tools
Этот шаг рекомендуется для надёжной работы интеграции. С bothelp_id система находит подписчика мгновенно. Без него поиск идёт по email или телефону через API BotHelp, что тоже работает, но контакт должен существовать в обеих системах с совпадающими данными.
1 Создайте бота в BotHelp
Перейдите в BotHelp.
В меню слева выберите «Боты».
Создайте бот, который запускается при регистрации (или используйте существующий).
2 Откройте редактор бота
Справа вверху нажмите на «Редактировать».
3 Добавьте действие «Отправить данные через Webhook»
Внизу справа нажмите на «Добавить» → «Действия».
Выберите действие «Отправить данные подписчикам через Webhook».
4 Скопируйте вебхук из Vakas-tools
Вернитесь в Vakas-tools.
Перейдите в «Базы» → «Ссылки».
Спуститесь ниже и найдите раздел «Webhook для BotHelp».
Скопируйте ссылку вебхука.
5 Вставьте вебхук в бота
Вернитесь в BotHelp в редактор бота.
Вставьте скопированный вебхук в поле действия.
Нажмите «Сохранить и закрыть».
Результат
Теперь при каждой регистрации через бота данные подписчика (включая bothelp_id) будут автоматически передаваться в Vakas-tools. Это идеальный вариант: поиск подписчика по bothelp_id быстрее и надёжнее, чем по email или телефону.
Передача данных в Bothelp из Vakas-tools
Как работает интеграция дальше — общая схема
Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.
Схема работы:
- Правило — определяет, при каких условиях передавать данные.
- Условия (внутри правила) — фильтруют, какие лиды попадут под это правило.
- Действия (кнопка напротив правила) — определяют, какое действие совершить и что именно передать в сервис.
Общие настройки
На странице сервиса BotHelp нажмите кнопку «Настройки». Здесь указывается, по какому параметру система будет искать подписчика в BotHelp при передаче данных.
Источники идентификатора подписчика
Чтобы передать данные в BotHelp, система должна найти подписчика. Приоритетный способ — по идентификатору bothelp_id, который приходит при регистрации через бота. Если его нет, система ищет по email или телефону через API BotHelp.
В настройках укажите:
- Тип идентификатора: «BotHelp ID подписчика» (внутренний номер в конкретном канале) или «CUID подписчика» (постоянный идентификатор, рекомендуемый BotHelp).
- Источник: шорткод поля, в котором хранится идентификатор. Например,
{#bothelp_user_id_tg#}для Telegram-канала.
Если подписчик есть в нескольких каналах (Telegram, ВКонтакте, Max), добавьте отдельный источник для каждого канала кнопкой «Добавить ещё один источник». Тогда данные будут переданы во все каналы одновременно.
Настройка правил
Правила настраиваются одинаково для всех сервисов. Подробная инструкция по созданию правил и настройке условий описана в отдельном разделе.
В рамках интеграции с BotHelp отличаются только доступные действия, которые выполняются при срабатывании правила.
Конструктор действий
Открывается кнопкой «Действия» напротив правила в таблице. Все доступные действия:
Переменные
Позволяет сохранить переменные в заявку и в клиента. Нажмите «Добавить действие» → Переменные.
Заполните пары:
- Название в BotHelp (левая колонка) — название кастомного поля в BotHelp, латинскими буквами, без пробелов.
- Значение (правая колонка) — значение поля. Поддерживает шорткоды.
Можно добавить несколько пар. Пустые пары пропускаются.
Поле должно быть предварительно создано в настройках BotHelp, иначе API вернёт ошибку.
Боты
| Действие | Описание |
|---|---|
| Запустить бот | Запускает выбранного бота для подписчика. Бот выбирается из списка (подгружается из API BotHelp). |
| Остановить бот | Останавливает выбранного бота для подписчика. |
Авторассылки
| Действие | Описание |
|---|---|
| Запустить авторассылку | Запускает выбранную авторассылку (воронку) для подписчика. |
| Остановить авторассылку | Останавливает выбранную авторассылку для подписчика. |
Теги
| Действие | Описание |
|---|---|
| Добавить теги | Добавляет теги подписчику. Указывать через запятую. Поддерживает шорткоды. |
| Удалить теги | Удаляет указанные теги у подписчика. Указывать через запятую. |
Сообщения
| Действие | Описание |
|---|---|
| Отправить сообщение | Отправляет текстовое сообщение подписчику. Поддерживает шорткоды. |
Настройки передачи регистраций, отчетов, заказов и запуск ботов описаны на примерах. Поэтому простраивая логику опирайтесь на ваши воронки в чат-боте.
Передача регистраций в BotHelp
Цель: при регистрации на вебинар передать данные подписчика в BotHelp — переменные (дата и время вебинара, ссылка на комнату), запустить бота или авторассылку.
Для передачи данных рекомендуется, чтобы у контакта в базе был bothelp_id. Если его нет, система найдёт подписчика по email или телефону, но контакт должен быть и в Vakas-tools, и в BotHelp.
1 Создайте правило для регистрации
2 Настройте действия правила
Нажмите «Действия» напротив созданного правила.
2.1. Добавьте переменные
Нажмите «Добавить действие» → Переменные. Добавьте пары «название — значение»:
3 Сохраните настройки
Нажмите «Сохранить». Правило готово — при регистрации данные будут автоматически передаваться в BotHelp.
| Название в BotHelp | Значение (шорткод) | Что передаётся |
|---|---|---|
webdata |
{#webinar_date#} |
Дата вебинара |
webtime |
{#webinar_time#} |
Время вебинара |
weblink |
{#room_link#} |
Ссылка на комнату |
Нажмите иконку {--} рядом с полем значения, чтобы увидеть список доступных шорткодов. Названия переменных указывайте точно так же, как они созданы в BotHelp.
2.2. Запустите бота (по желанию)
Нажмите «Добавить действие» → Запустить бот. Выберите бота из списка, например «Приветствие» или «Напоминание о вебинаре».
2.3. Добавьте теги (по желанию)
Нажмите «Добавить действие» → Добавить теги. Укажите теги через запятую, например:
регистрация, {#webinarId#}2.4. Отправьте сообщение (по желанию)
Нажмите «Добавить действие» → Отправить сообщение. Укажите текст, например:
Вы зарегистрированы на вебинар! Дата: {#webinar_date#}, время: {#webinar_time#}. Ссылка: {#room_link#}Проверка передачи регистраций
- Зайдите на лендинг, введите данные и нажмите «Зарегистрироваться».
- При успешной отправке — переход на страницу «Спасибо».
- Нажмите на виджет и запустите бота.
- В Vakas-tools → «Базы» → «Контакты» — проверьте, что лид поступил в базу с bothelp_id, ссылкой на комнату и датой вебинара.
- В BotHelp → «Подписчики» — проверьте наличие лида и значения переменных (дата, время, ссылка).
Передача отчётов в BotHelp
Цель: после вебинара передать данные об активности зрителей (время просмотра, клики по кнопкам и др.) в BotHelp — обновить переменные подписчика, запустить нужного бота или авторассылку в зависимости от поведения.
Важно: отчёт передаётся только по тем лидам, которых система может найти в BotHelp: по bothelp_id, email или телефону. Регистрации и отчёты должны собираться в одну базу.
1 Создайте правила для отчётов
2 Настройте действия каждого правила
Нажмите «Действия» напротив правила, для которого хотите настроить передачу данных.
2.1. Добавьте переменные
Нажмите «Добавить действие» → Переменные. Добавьте пары:
3 Сохраните настройки
Нажмите «Сохранить». Теперь после вебинара данные отчёта передадутся в BotHelp.
| Название в BotHelp | Значение (шорткод) | Что передаётся |
|---|---|---|
bil_minut |
{#bil_minut#} |
Сколько минут был на вебинаре |
click_button |
{#clickFile#} |
Кликал ли по кнопке |
city |
{#city#} |
Город |
webinarId |
{#webinarId#} |
ID вебинара |
2.2. Остановите старого бота и запустите нового
Для правила «Все лиды»:
- Нажмите «Добавить действие» → Остановить бот → выберите «Напоминание о вебинаре».
- Нажмите «Добавить действие» → Запустить бот → выберите «После вебинара».
Для правила «Кликнул по кнопке» — настройте другие действия:
- Остановить бот: «Напоминание о вебинаре».
- Запустить бот: «Горячий лид».
2.3. Управляйте авторассылками (по желанию)
- Нажмите «Добавить действие» → Остановить авторассылку → выберите «Зарегистрировался».
- Нажмите «Добавить действие» → Запустить авторассылку → выберите «Был на вебинаре».
2.4. Добавьте теги (по желанию)
был на вебинареДля каждого правила с условиями настройте свои действия — например, для правила «Кликнул по кнопке» запустить другого бота или авторассылку, добавить другие теги.
Передача заказов и оплат в BotHelp
Цель: при создании заказа или поступлении оплаты передать данные в BotHelp — обновить переменные (номер заказа, сумма, статус), запустить бота или авторассылку для дожима или подтверждения оплаты.
Важно: регистрации, отчёты и оплаты должны собираться в одну базу.
1 Создайте правило для заказов
При необходимости добавьте дополнительные правила с условиями. Например: правило «Новая заявка (не оплачено)». Условия: Поле оплачено, условие = 0. Поле осталось оплатить, условие > 0.
2 Настройте действия правила
Нажмите «Действия» напротив созданного правила.
2.1. Добавьте переменные
Нажмите «Добавить действие» → Переменные. Добавьте пары:
3 Сохраните настройки
Нажмите «Сохранить». Теперь при создании заказа или оплате данные будут переданы в BotHelp.
| Название в BotHelp | Значение (шорткод) | Что передаётся |
|---|---|---|
zakaz |
{#payment_number#} |
Номер заказа |
tariff |
{#positions#} |
Название тарифа |
amount |
{#costMoney#} |
Сумма заказа |
paid |
{#payedMoney#} |
Оплачено |
left |
{#leftCostMoney#} |
Осталось оплатить |
status |
{#payment_status#} |
Статус платежа |
2.2. Запустите/остановите ботов
Для правила «Оплатил»:
- Остановить бот: «После вебинара» (или «Дожим»).
- Запустить бот: «Оплатил».
Для правила «Новая заявка»:
- Запустить бот: «Дожим оплаты».
2.3. Управляйте авторассылками
Для правила «Оплатил»:
- Остановить авторассылку: «Был на вебинаре».
- Запустить авторассылку: «После оплаты».
2.4. Отправьте сообщение (по желанию)
Спасибо за оплату! Тариф: {#positions#}, сумма: {#costMoney#} руб.2.5. Добавьте теги (по желанию)
оплата, {#positions#}Шорткоды
Во всех текстовых полях можно использовать шорткоды — подстановки данных. Нажмите {--} рядом с полем, чтобы увидеть доступные шорткоды.
Примеры: {#name#}, {#email#}, {#phone#}, {#city#}.