Для чего нужна интеграция
Что можно сделать в Vakas-tools совместно с BotHelp:
- Сбор регистраций с чат-бота.
- Передача регистраций в воронку BotHelp.
- Передача событий из отчётов с вебинара в воронку BotHelp.
- Передача данных о заказах и оплатах клиента в воронку BotHelp.
В зависимости от полученных данных из Vakas-tools можно запускать сегментированные цепочки сообщений в чат-боте.
Шаги интеграции
Чтобы отправлять данные в BotHelp, нужно получить идентификатор bothelp_id из чат-бота. Когда в базе Vakas-tools будут контакты с bothelp_id, можно передавать в BotHelp любые данные.
- Подключение BotHelp к Vakas-tools.
- Передача контактов с Tilda в BotHelp со страницы регистрации или через минилендинг (если у вас уже есть контакты в BotHelp, пропустите этот шаг).
- Передача контактов из BotHelp в Vakas-tools с идентификатором bothelp_id.
- Настройка передачи данных — регистрации, отчёты, заказы.
Создание базы
Инструкция по созданию базы по ссылке. Если база создана, пропустите этот шаг.
Подключение Bothelp
Инструкция по подключению по ссылке. Если подключение создано, пропустите этот шаг.
Передача контактов с Tilda в BotHelp со страницы регистрации
Если у вас уже есть контакты в 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.
Передача контактов с Tilda в BotHelp через минилендинг
Если у вас уже есть контакты в BotHelp, пропустите этот раздел.
Этот способ подходит, когда сбор регистраций происходит не через Tilda и страницу «Спасибо», а через собственный минилендинг BotHelp.
1 Создайте минилендинг в BotHelp
Перейдите в BotHelp.
В меню слева выберите «Инструменты роста».
Создайте новый инструмент — «Мини-лендинг».
2 Настройте минилендинг
Укажите данные, которые будут запрашиваться у пользователя, и способ их запроса.
Выберите бота или авторассылку, которая запустится после регистрации.
3 Настройте передачу данных в Vakas-tools через вебхук
Скопируйте вебхук из Vakas-tools. Перейдите в «Базы» → «Ссылки».
Спуститесь ниже и найдите раздел «Webhook для BotHelp».
Скопируйте ссылку вебхука и вставьте в Bothelp.
4 Получите ссылку на минилендинг
Вернитесь в настройки минилендинга.
Справа будет доступна ссылка на созданную страницу.
Перейдите по ссылке и протестируйте регистрацию лида.
Перейдите в Контакты у Базы в которую передаете и с которой копировали вебхук, найдите контакт, который передавали тестово и проверьте, чтобы в данных с регистрации были данные с Bothelp.
Важно: для Vakas-tools обязательно необходимо собирать контакты — email, номер телефона или оба поля.
Важно: если не настроить передачу bothelp_id в Vakas-tools, данные из Vakas-tools передать обратно в BotHelp будет невозможно.
Как это работает
- Лид переходит на минилендинг BotHelp и заполняет форму (email, телефон).
- Запускается бот, который через вебхук отправляет данные (включая bothelp_id) в Vakas-tools.
- В базе Vakas-tools появляется контакт с bothelp_id → можно передавать данные обратно в BotHelp.
Передача контактов из BotHelp в Vakas-tools с идентификатором bothelp_id
Это обязательный шаг для работы интеграции. Без bothelp_id Vakas-tools не сможет передавать данные обратно в BotHelp.
1 Создайте бота в BotHelp
Перейдите в BotHelp.
В меню слева выберите «Боты».
Создайте бот, который запускается при регистрации (или используйте существующий).
2 Откройте редактор бота
Справа вверху нажмите на «Редактировать».
3 Добавьте действие «Отправить данные через Webhook»
Внизу справа нажмите на «Добавить» → «Действия».
Выберите действие «Отправить данные подписчикам через Webhook».
4 Скопируйте вебхук из Vakas-tools
Вернитесь в Vakas-tools.
Перейдите в «Базы» → «Ссылки».
Спуститесь ниже и найдите раздел «Webhook для BotHelp».
Скопируйте ссылку вебхука.
5 Вставьте вебхук в бота
Вернитесь в BotHelp в редактор бота.
Вставьте скопированный вебхук в поле действия.
Нажмите «Сохранить и закрыть».
Результат
Теперь при каждой регистрации через бота данные подписчика (включая bothelp_id) будут автоматически передаваться в Vakas-tools. В базе у контакта появится идентификатор bothelp_id, и все дальнейшие действия (передача переменных, запуск ботов, авторассылки) будут работать.
Передача данных в Bothelp из Vakas-tools
Как работает интеграция дальше — общая схема
Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.
Схема работы:
- Правило — определяет, при каких условиях передавать данные.
- Условия (внутри правила) — фильтруют, какие лиды попадут под это правило.
- Действия (кнопка напротив правила) — определяют, какое действие совершить и что именно передать в сервис.
Настройка правил
Правила настраиваются одинаково для всех сервисов. Подробная инструкция по созданию правил и настройке условий описана в отдельном разделе.
В рамках интеграции с BotHelp отличаются только доступные действия, которые выполняются при срабатывании правила.
Конструктор действий
Открывается кнопкой «Действия» напротив правила в таблице. Все доступные действия:
Переменные
Позволяет сохранить переменные в заявку и в клиента. Нажмите «Добавить действие» → Переменные.
Заполните пары:
- Название в BotHelp (левая колонка) — название кастомного поля в BotHelp, латинскими буквами, без пробелов.
- Значение (правая колонка) — значение поля. Поддерживает шорткоды.
Можно добавить несколько пар. Пустые пары пропускаются.
Поле должно быть предварительно создано в настройках BotHelp, иначе API вернёт ошибку.
Боты
| Действие | Описание |
|---|---|
| Запустить бот | Запускает выбранного бота для подписчика. Бот выбирается из списка (подгружается из API BotHelp). |
| Остановить бот | Останавливает выбранного бота для подписчика. |
Авторассылки
| Действие | Описание |
|---|---|
| Запустить авторассылку | Запускает выбранную авторассылку (воронку) для подписчика. |
| Остановить авторассылку | Останавливает выбранную авторассылку для подписчика. |
Теги
| Действие | Описание |
|---|---|
| Добавить теги | Добавляет теги подписчику. Указывать через запятую. Поддерживает шорткоды. |
| Удалить теги | Удаляет указанные теги у подписчика. Указывать через запятую. |
Сообщения
| Действие | Описание |
|---|---|
| Отправить сообщение | Отправляет текстовое сообщение подписчику. Поддерживает шорткоды. |
Настройки передачи регистраций, отчетов, заказов и запуск ботов описаны на примерах. Поэтому простраивая логику опирайтесь на ваши воронки в чат-боте.
Передача регистраций в BotHelp
Цель: при регистрации на вебинар передать данные подписчика в BotHelp — переменные (дата и время вебинара, ссылка на комнату), запустить бота или авторассылку.
Важно: для передачи данных у контакта в базе Vakas-tools должен быть bothelp_id. Настройте получение bothelp_id (см. выше «Передача контактов из BotHelp в Vakas-tools с идентификатором bothelp_id»).
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_id. Регистрации и отчёты должны собираться в одну базу.
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#}.