Интеграция с Vakas-tools

Как через Vakas-tools автоматизировать обмен данными с другими сервисами


Интеграция с сервисом Vakas-tools позволит автоматизировать и ускорить процесс обмена данными между BotHelp и другими сервисами: Bizon365, amoCRM, Bitrix24, Getcourse, sms-рассыльщики, email-рассыльщики, Tilda, Платформа LP, Google и др.

Общая схема взаимодействия состоит из трех сервисов: 

  • Сторонний сервис
  • Vakas-tools
  • BotHelp

Логика взаимодействия:

  • В vakas-tools передаются данные о подписчике из базы BotHelp
    • Передаются ФИО, почта, телефон, id и другие данные подписчика
  • Из стороннего сервиса в Vakas-tools поступает набор данных о подписчике, который выполнил определенное действие в этом стороннем сервисе.
    • К данным подписчика относятся его ФИО, почта и телефон, а также другие данные, передача которых задана в настройках интеграции
  • Vakas-tools обрабатывает поступившие в него данные:
    • "Находит" в базе BotHelp подписчика, который совершил действие в стороннем сервисе
    • Выполняет с найденным подписчиком действия, указанные в настройке интеграции. На данный момент доступно 3 типа действий, которые vakas-tools может выполнять с подписчиком в базе BotHelp: запуск/остановка бота, запуск/остановка авторассылки, передача значений в пользовательские поля
  • Таким образом, vakas-tools служит посредником для BotHelp и сторонними сервисами.

Разберем более подробно возможности интеграции на примере связки "BotHelp+Bizon365"


Настройка интеграции BotHelp и Bizon365

Данная интеграция позволит настроить автоматическое управление подписчиками в базе BotHelp на основе полученных данных: из формы регистрации, отчетов после вебинара, данных об оплатах.

Вы также можете изучить инструкцию и видео по настройке данной интеграции от сервиса vakas-tools по ссылке

1. Подготовка Vakas-tools к работе

  • Подключите BotHelp к vakas-tools. Для этого:
    • В кабинете BotHelp в "Настройках" в разделе "Интеграции" найдите и скопируйте поля ID и Secret в разделе Open API
    • В кабинете Bizon365 в разделе "Доступы" подразделе "Чат-боты" откройте страницу BotHelp и вставьте скопированные значения ID и Secret

  • Создайте новую базу в разделе Базы подписчиков. После создания база появится в общем списке баз:

  • Перейдите в раздел редактирования созданной базы - нажмите на иконку "Карандаш" 
  • В открывшемся разделе укажите ссылку на вебинарную комнату Bizon365. В дальнейшем вы сможете настроить передачу этой ссылке в бота BotHelp, чтобы он смог отправить ее подписчику.
    • Ссылку на вебинарную комнату можно получить в кабинете Bizon365 в настройках вебинарной комнаты.


2. Передача данных из BotHelp в Vakas-tools

Данные о подписчике из бота BotHelp передаются в базу Vakas-tools через webhook

  • Создайте бота и добавьте в него действие "Отправить данные подписчика через Webhook"
  • В настройки действия нужно будет вставить ссылку, по которой данные о подписчике будут передаваться в vakas-tools
  • Чтобы получить эту ссылку в списке ваших баз vakas-tools нажмите на кнопку "</> Ссылки" справа от названия нужной базы

  • В открывшемся окне скопируйте ссылку из раздела "Webhook для BotHelp"

  • Вставьте скопированную ссылку в блок действие в боте

  • В итоге получился вот такой бот:


3. Передача регистраций

3.1 Настройка Vakas-tool для передачи регистраций

  • Откройте список баз в кабинете Vakas-tools
  • Активируйте передачу регистраций из vakas-tools в BotHelp. Для этого нажмите на иконку "BotHelp" рядом с названием базы

  • Активируйте чек-бокс выгружать регистрации в BotHelp.

  • Теперь настройте передачу переменных из vakas-tools в BotHelp. Нажмите "Добавить переменную", в открывшемся окне нажмите "Добавить"
  • В открывшемся окне задайте:
    • "Название переменной" - это название пользовательского поля подписчика BotHelp, в которое будут передаваться данные. Важно - такое пользовательское поле уже должно быть в вашем кабинете BotHelp
    • "Поле в Базе" - это параметр в базе vakas-tools, значение которого будет передаваться в указанную выше переменную.
    • В нашем примере мы будем передавать ссылку на вебинарную комнату (значение ссылки мы указывали ранее) в поле link подписчиков BotHelp

 

  • Нажмите "Добавить"
  • В итоге у вас должен получится вот такой список переменных


3.2 Настройка лендинга и виджет-кнопки BotHelp для передачи регистраций

В данном примере мы соберем схему работы, при которой заявки с лендинга передаются в BotHelp. А после из BotHelp в базу vakas-tools. После чего из vakas-tools будут передаваться дополнительные данные о подписчике обратно в BotHelp

  • В BotHelp создайте виджет-кнопку, по которой подписчики будут переходить в вашего бота BotHelp
  • Для созданной виджет-кнопки укажите бота, в которого будут перенапраляться подписчик - бот, в котором ранее было добавлено действие с оптравкой данных в vakas-tools через webhook


  • В данном примере лендинг будет сделан в Tilda. В конструкторе Tilda создайте 2 страницы:
    • Страницы с формой регистрации. В форме регистрации подписчик оставляет свои данные и нажимает на кнопку "Отправить"
    • Спасибо-страница. На эту страницу подписчик попадает после отправки данных из формы регистрации. На ней будет виджет-кнопка для подписки на бота BotHelp
  • На страницу с формой регистрации добавьте блок HTML-код и вставьте в него скрипт от vakas-tools, который будет осуществлять передачу данных из формы на страницу Спасибо:
<script>
var thanks_pages = [];
thanks_pages[1] = '{ссылка_на_страницу_спасибо_1}';
</script>
<script src="//vakas-tools.ru/f/s/to_thank.js"></script>
  • Вместо текста  {ссылка_на_страницу_спасибо_1}  укажите ссылку вашей страницы Спасибо
  •  На странице Спасибо разместите созданную ранее в BotHelp виджет-кнопку 


Готово! В итоге получается следующая схема работы:

  1. Подписчик попадает на лендинг с формой регистрации
  2. Заполняет форму и отправляет свои данные
  3. Переходит на страницу Спасибо и подписывается на бота Bothelp
  4. Данные из формы регистрации записываются в карточку подписчика
  5. После запуска бота данные о подписчике автоматически отправляются в vakas-tools через webhook
  6. Vakas-tools обрабатывает полученные данные и автоматически в ответ отправляет значение заданных переменных обратно в BotHelp. В нашем примере мы передаем ссылку на вебинарную комнату


4. Настройка BotHelp, Bizon365 и Vakas-tools для передачи отчетов

4.1 Настройка Bizon365

В кабинете Bizon365 нужно указать ссылку, по которой будут отправляться отчеты в Vakas-tools. Для этого:

  • В списке ваших баз vakas-tools нажмите на кнопку "</> Ссылки" справа от названия нужной базы

  • Перейдите в раздел "Отчеты с вебинара" и скопируйте ссылку "Для отчетов с Bizon365"

  • В вашем кабинете Bizon365 перейдите в настройки вебинарной комнаты, откройте раздел настроек "Разное" подраздел "После вебинара". Вставьте скопированную ссылку в поле "Вебхук после создания отчета"


4.2 Настройка Vakas-tools

  • Откройте список баз в кабинете Vakas-tools
  • Активируйте передачу отчетов из vakas-tools в BotHelp. Для этого нажмите на иконку "BotHelp" рядом с названием базы

  • Активируйте чек-бокс "Выгружать отчеты в BotHelp"

  • ВАЖНО! Чтобы отчет сформировался, в Vakas-tools должны поступать регистрации с Bothelp, т.е. отчет будет сформирован только по подписавшимся на бот подписчикам. Регистрации и отчеты должны собираться в одну базу.
  •  Добавьте отчет и задайте условие его срабатывания

  • Из стандартного списка полей vakas-tools в поле "Поле в базе" выберите нужное и укажите его значение в поле "Значение поля". При таком значении данного поля будут выполняться следующие действия, указанные в этом отчете.
    • В нашем примере действия будут выполнять, если пользователь кликнул по кнопке в вебинарной комнате 1 раз
  • Нажмите "Добавить", после этого у вас будет такой список отчетов

  • Теперь в этом отчете вы можете настроить 3 типа действий:
    • Передача значений переменных в пользовательские поля подписчика BotHelp. Для настройки нажмите на кнопку "Переменные"
    • Запуск или остановка бота BotHelp для подписчика. Для настройки нажмите кнопку "Боты"
    • Запуск или остановка авторассылки BotHelp ля подписчика. Для настройки нажмите кнопку "Авторассылки"

Готово! В итоге получается следующая схема работы:

  1. В vakas-tools автоматически поступает отчет из Bizon365 для конкретного подписчика
  2. Поступившие из Bizon365 данные соответсвуют условиям, которые заданы в отчете в vakas-tools
  3. Vakas-tools выполняет заданные в отчете действия с этим же подписчиком в BotHelp

5. Настройка BotHelp, Bizon365 и Vakas-tools для передачи заказов

5.1 Настройка Bizon365

В кабинете Bizon365 нужно указать ссылку, по которой данные о заказах будут отправляться в Vakas-tool. Для этого:

  • В списке ваших баз vakas-tools нажмите на кнопку "</> Ссылки" справа от названия нужной базы

  • Перейдите в раздел "Оплаты" и скопируйте ссылку "Для оплат и заказов с Bizon365"

  • В вашем кабинете Bizon365 перейдите в настройки, откройте раздел "Настройки кассы", подраздел "Интеграция". На вкладке "Пересылка на URL" вставьте скопированную ссылку в поле "Адрес для пересылки 1"


5.2 Настройка Vakas-tools

  • Откройте список баз в кабинете Vakas-tools
  • Активируйте передачу заказов из vakas-tools в BotHelp. Для этого нажмите на иконку "BotHelp" рядом с названием базы

  • Активируйте чек-бокс "Выгружать заказы в BotHelp"

  • Добавьте условия, по которым будут выполняться действия при поступлении данных о заказах

  • ВАЖНО! Чтобы условия работали, регистрации, отчеты и оплаты должны собираться в одну базу. 
  • Из стандартного списка полей vakas-tools в поле "Поле в базе" выберите нужное и укажите его значение в поле "Значение поля". При таком значении данного поля будут выполняться следующие действия, указанные для этого заказа.
    • В нашем примере действия будут выполняться, если сумма, оплаченная пользователем в заказа равна 1000
  • Нажмите "Добавить", после этого у вас будет такой список отчетов

  • Теперь для заказов, у которых срабатывает указанное условие, вы можете настроить 3 типа действий:
    • Передача значений переменных в пользовательские поля подписчика BotHelp. Для настройки нажмите на кнопку "Переменные"
    • Запуск или остановка бота BotHelp для подписчика. Для настройки нажмите кнопку "Боты"
    • Запуск или остановка авторассылки BotHelp ля подписчика. Для настройки нажмите кнопку "Авторассылки"

Готово! В итоге получается следующая схема работы:

  1. В vakas-tools автоматически поступает отчет об оплате/заказе из Bizon365 для конкретного подписчика
  2. Поступившие из Bizon365 данные соответсвуют условиям, которые заданы в базе в vakas-tools для заказов
  3. Vakas-tools выполняет заданные в настройках по заказам действия с этим же подписчиком в BotHelp


Вы можете изучить инструкцию и видео по настройке данной интеграции от сервиса vakas-tools по ссылке

Помимо интеграции с bizon365 сервис vakas-tools позволяет настраивать интеграции с другими сервисами. Более подробную информацию можно изучить на сайте vakas-tools по ссылке


Если у вас остались вопросы, задайте их нам в чате внутри кабинета либо напишите на hello@bothelp.io 😃

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Получить 14 дней бесплатно 

👆 На этом пока всё