Интеграция с TargetHunter. Подключение к Albato
В этой статье мы разберем как подключить TargetHunter.Moderator к Albato, а также возможные интеграции с данным сервисом.
UPD: с 01/01/2024 партнер называется BotHunter
Подключение TargetHunter к Albato
Перейди в раздел Подключения и нажми кнопку Добавить подключение.
В появившемся окне выбери в списке TargetHunter.Moderator
Затем нажми кнопку Добавить подключение.
Для успешного подключения понадобится указать название подключения — можно придумать свое или оставить то, что стоит по умолчанию. А также API ключ из настроек.
После нажатия кнопки Далее, ты увидишь созданное подключение:
На этом подключение внутри Albato успешно завершено.
Важно: скопируй себе информацию из поля Webhook URL, она понадобится тебе дальше, для настройки работы из сервиса.
Настройка внутри TargetHunter.Moderator
Для того, чтобы отправлять информацию в Albato, в сервисе предусмотрено несколько возможностей:
1. Вебхуки
Эта технология позволяет отправлять информацию сразу после того, как произошло какое-либо событие. На данный момент отслеживаются такие события:
- Пользователь подписался на группу подписчиков (в приложении VK)
- Пользователь отписался от группы подписчиков (в приложении VK)
Также есть возможность отслеживать и любое событие, об этом написано в разделе про работу из бота.
Настройка сценария: при подписке, данные по человеку отправляются в Битрикс24, amoCRM или любой другой сервис, который подключен к Albato.
Для того, чтобы включить отправку:
- Перейдите на страницу https://smm.targethunter.ru/webhooks
- Нажмите кнопку Добавить получателя
- В поле URL вставьте значение из поля Webhook. Если вы не скопировали информацию из этого поля, вы всегда можете найти ее в личном кабинете Albato, найдя в разделе подключений TargetHunter.Moderator.
Так выглядит заполненное окно добавления получателя вебхука для нашего примера:
Нажми кнопку Сохранить.
Теперь данные будут поступать в Albato при каждом новом событии.
Настройка сценария: данные по человеку отправляются в CRM (или любой другой сервис), когда он подписывается на группу подписчиков
В личном кабинете Albato, в разделе Мои связки нажми Создать новую связку.
В пункте Триггер выбери сервис TargetHunter.Moderator и одно из событий: Пользователь подписался в группу в группу подписчиков или Пользователь отписался от группы подписчиков.
Теперь осталось выбрать действие, которое будет происходить, при срабатывании выбранного события (триггера). В нашем примере разберем отправку данных в CRM-систему, однако можно выбрать любой другой сервис, подключенный к Albato.
При создании действия можно выбрать поля из выпадающего списка. В пункте TargetHunter.Moderator выбери любое нужное значение — это будет та информация, которая пришла в триггере (событии) и которую ты будешь передавать в другой сервис.
Готово! Не забудь сохранить и запустить связку.
2. Связки из бота
Вебхуки позволяют отправлять информацию только по определенным событиям. А если надо сделать универсальную связку, которая будет срабатывать в нужный момент — подойдет это решение.
Предварительная настройка
Подключи интеграцию Albato на странице интеграций:
- Перейди на https://smm.targethunter.ru/integrations
- Нажми кнопку Добавить интеграцию
- Выбери сервис Albato
- В полях подключения нужно указать Webhook URL. Его можно найти в разделе подключений в личном кабинете Albato (скриншот ниже)
- Сохрани интеграцию
После этого тебе будет доступна работа с отправкой данных прямо из бота.
Чтобы отправлять данные из бота:
- Добавь блок Действие в нужном месте цепочки
- Выбери пункт Действия с интеграцией
- Выбери интеграцию Albato
- Выбери пункт Отправить информацию о пользователе
- Сохрани блок
Теперь, когда пользователь пройдет по этому блоку, в Albato будет отправлена информация с его данными.
Также можно указать дополнительные поля, которые будут отправлены вместе с основной информацией. Сейчас доступно 5 дополнительных значений.
Для того, чтобы создать связку по этому варианту — перейди в Albato, в раздел Мои связки. Нажми Создать новую связку.
Далее добавь триггер (событие), который будет запускать связку.
В поле Событие выбери Получена информация о пользователе.
Далее необходимо выбрать действие, которое должно произойти после получения информации из Модератора. Например, отправка данных в CRM.
Внизу списка ты увидишь пункт Произвольное поле. В них будет приходить та информация, которую ты укажешь в блоке отправки данных из бота.
