Интеграция через Albato

Как передать данные через вебхук. Связки с Битрикс, amoCRM, GetCourse

Открыть в новом окне по ссылке


Для начала вам нужно завести аккаунт в сервисе Albato. Сервис позволяет связать BotHelp с 100+ других платформ. Среди них: Битрикс24, amoCRM, GetCourse, Bizon365, Binotel и другие. Полный список смотрите на сайте Альбато.

 

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

Данные бота для Webhook↗


Подключение BotHelp к Альбато

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

 

 1.  Авторизуйтесь в Albato.
 2. Перейдите в раздел "Подключения" и найдите в списке BotHelp.

 3. Нажмите на кнопку "Добавить подключение".

 

 


4. Дайте название для подключения. Рекомендуем указывать название бота. Для разных ботов будут отдельные подключения.
5. Нажмите на кнопку "Далее".

6. Через несколько секунд будет сгенерирован url для настройки webhooks. Скопируйте его.

7. Нажмите на кнопку "Сохранить".

 

 

8. Вставьте скопированный webhook url в соответствующем поле в боте.

 


Таким образом вы подключили бота к Альбато.

 

Подключение вашего сервиса

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

 

В этой статье мы рассмотрим интеграцию на примере Битрикс24. 

 

Подключение Битрикс24

Для начала вам необходимо установить приложение Альбато в свой bitrix24.

 


Создайте новое подключение:

  1. Ввести любое название для подключения.

  2. Указать свой домен на Битриксе.

  3. Выбрать формат телефона.

  4. Сохранить и предоставить доступ.


После подключения все данные из Битрикса автоматически подгрузятся. 

 

Настройка связки

После того как вы создали хотя бы 2 подключения (BotHelp и необходимый вам сервис) можно создавать связку между ними. Для этого:

 

  1. Перейдите в раздел "Мои связки".

  2. Нажмите на кнопку "Создать связку" - "Новая".

 

Выберите системы, которые хотите связать. В нашем случае это BotHelp и Битрикс 24. 

 

Шаг 1. Откуда отправляем

  1. Первым шагом настраиваем откуда будут отправляться данные. Выбираем сервис BotHelp из списка

  2. Событие. Выберите событие, по которому запускается интеграция, и целевое действие, которое будет совершено. Для BotHelp доступно только событие завершения чата и новые данные подписчика. Первое работает в диалогах, так как нам необходима передача данных от подписчика, то выбираем второе.

  3. Выбор подключения.  Выберите бота, которого подключили ранее.

  4. Нажимаем кнопку "Далее" 

 

Ловец хуков

Вас перекинет на следующий шаг — Ловец хуков. Тут еще раз показан вебхук, который нужно вставить в шаге Действие бота. Пока пропустите этот шаг и нажмите кнопку "Далее"

Шаг 2. Куда передаем 

  1. Выбираем сервис Битрикс24 из списка

  2. Событие. Для Битрикса есть несколько типов событий. Для других сервисов их может быть еще больше или меньше. Можно выбрать создание сделки, нового контакта или лида, выбирайте то, что нужно вам. Я выбираю событие "Новый лид".

  3. Выбор подключения. Выберите аккаунт Битрикса.

  4. Нажимаем кнопку "Далее"

Шаг 3. Данные

На этом шаге необходимо выбрать данные, которые будут передаваться в Битрикс из BotHelp.
Поля автоматически подтянутся из Bitrix, вам нужно только указать какие данные из BotHelp подставить в эти поля.
Для этого:

 

  1. Нажмите на кнопку BotHelp в поле.

  2. Выберите необходимые данные из выпадающего списка.


Шаг 4. Дубликаты

Выберите, как обрабатывать дубликаты записей.
Доступны следующие опции:

  1. Не проверять на дубликаты и всегда создавать новую запись 

  2. Искать дубликаты и не создавать новую запись в случае нахождения 

  3. Искать дубликаты и обновлять поля найденной записи вместо создания новой. 

В случае выбора вариантов (2) или (3) отметьте галочками поля, по которым следует искать дубликаты. Обратите внимание, что для поиска доступны только те поля, для которых настроена передача данных на предыдущем шаге.
Если вы выбрали поиск и обновление дубликатов, то на шестом шаге вам следует настроить, как именно обновлять поля найденной записи. Форма аналогична четвёртому шагу.

 

Ожидать веб-хук

После создания связки необходимо проверить её работу. Откройте созданную связку, нажмите на значок Ловец хуков.


Нажмите на кнопку "Ожидать веб-хук". Здесь еще раз показан вебхук, который нужно вставить в боте.

 

После нажатия кнопки перейдите в своего бота, нажмите "Тестировать" и пройдите его цепочку до момента отправки вебхука.

 

После окончания цепочки бота перейдите в Альбато и убедитесь, что вебхук получен. Вы увидите, что появились также ваши кастомные поля и utm-метки, можно зайти и добавить эти данные в настройку подключения Битрикса.

Если на этом этапе у вас возникли сложности, убедитесь, что вы ввели правильный url вебхука и что вы дошли до момента отправки вебхука в боте.
Если вы всё сделали правильно, но данные не передались обратитесь в техподдержку Альбато.

 

Обратите внимание: Ссылка для передачи вебхука копируется из настроек подключения. Эта ссылка может отличаться от ссылки ловца хуков.

 

Связка создана

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

 

Запуск связки

Перейдите на страницу "Мои связки" и нажмите на кнопку "Запустить связку".

Вы получите уведомление, что связка запущена и её статус изменится на "работает (webhook)".


Тестируем связку

Перейдите в своего бота, еще раз запустите цепочку и пройдите её до момента передачи вебхука. Проверьте отображение нового Лида в Битриксе.

Интеграция с Гугл Таблицами


Интеграция с AmoCRM

Сервис-интегратор Альбато позволяет соединить и другие платформы с BotHelp, например Геткурс или Бизон. Если вы настроили и используете другую связку, присылайте нам видео и мы добавим его в эту инструкцию.



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

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

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

 

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