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

ВНИМАНИЕ! СКИДКИ!

Специально для наших любимых подписчиков промокод: Автопилот
Ограничение по активации промокода — до конца 2020 года.

Важно! Бонус по промокоду — максимальный тариф на месяц +50к сообщений + опция рассылок по событиям. Промокод копировать без кавычек и других символов на страницу smm.targethunter.ru/license (левый нижний угол).

В этой инструкции проведена интеграция с сервисом рассылок: TargetHunter. Переходим на сайт, заходим через кнопку «Войти в сервис».

Можно и через email. Тогда на почту придет письмо от сервиса со ссылкой, для подтверждения электронного адреса, но техподдержка TargetHunter рекомендует авторизироваться через «Вконтакте».

Подключение сообщества не вызовет проблем, для этого есть инструкция в сообществе TargetHunter.

Итак, допустим у нас создана группа.

• Открываем раздел «Модератор» (1)

• В выпадающем списке выбираем нужное сообщество (2)

• В разделе «Инструменты» выбираем «Рассылки» (3)

• В разделе «Дополнительно» (4) кликаем «Webhook Api» (5)

Настройка Webhook

Вебхуки это реакция на событие в таргетхантаре. Например, на подписку на рассылку. Если вам такое нужно, нажимаем «Добавить» и вводим вебхук:

В поле «Название» вводим название вебхука: Автопилот.
В «URL» — ссылку из события «Упомянут в GET/POST запросе» из команды Автопилота. Пример итоговой ссылки:

https://skyauto.me/cllbck/961875918/531530/ZE4TD_SOME_YOUR_CODE_REQS?avtp=1&to=json&sid_param=object.vk_user_id 

Жмем «Сохранить»

Документацию по методам API для TargetHunter'a можно прочесть на этой странице. Также для успешной интеграции нужна настройка секретного ключа:

Открываем пункт «События», копируем его в Автопилот в поле для интеграции с Senler. Нажимаем «Применить» в обоих окнах. Если все успешно, то вы увидите вот такое сообщение:

Настройка вебхука (уведомлений) о подписке

Событие:
1) Для отлова событий создаем событие «Упомянут в GET запросе» с шаблончиком «запрос из бота».

2) Добавляем условие: переменная %type%равна %subscribe%

Действия:

1) Опционально, действие: «отправляем сообщение» в ответ с поздравлением об успешной подписке:

Вы можете добавить любые другие действия вместо этого. Например добавление нового подписчика в CRM.

Полезные переменные

Эти переменные можно использовать в команде с событием реагирующим на вебхук. Просто копируете нужную и подставляете в действия. Больше можете достать сами из особой перменной %request%.

Тип события: %type% //subscribe - подписка /unsubscribe - отписка
ID сообщества: %request.input.object.vk_group_id%
Дата: %request.input.object.date%
ID игрока: %request.input.object.vk_user_id%
ID группы рассылок: %request.input.object.subscription_id%
Источник: %request.input.object.source% // subscriptions - подписки, api - подписка по API

Настройка вебхука (уведомлений) про отписку

Важно! В этой команде будет копия из предыдущей команды. Только заменяем копией условие на %type% = unsubscribe

И действие «Отправить сообщение» также заменяем копией и изменяем текст:

%first_name%, Вы отписаны от рассылки. Нам очень жаль.

Подписка по ключевому слову — Пример команды

1) Событие: «написал сообщение» с текстом содержащим подписка

2) Действие: «Отправлен GET/POST запрос» на адрес https://smm.targethunter.ru/api/subscribers/add c параметрами:

• vk_group_id —%club_id%
• vk_user_id — массив ссылок или числовых идентификаторов пользователей ВКонтакте (максимум 10000). Мы будем указывать текущего пользователя, поэтому значение параметра будет %vk_id%;
• subscription_id — идентификатор группы подписчиков (0 - без группы). Поддерживаются переменные Автопилота.

Все! Больше никаких действий не нужно! При успешной подписке вебхук сработает автоматически. Проверить результат ответа сервера можно так: вывести переменную %response.success%. При успехе она будет равна true.

Отписка по ключевому слову — Пример команды

1) Событие: «написал сообщение» с текстом равнымстоп

2) Действие: «Отправлен GET/POST запрос» на адрес https://smm.targethunter.ru/api/subscribers/del c аналогичными параметрами из предыдущей команды:

Тестируем.

Интеграция работает успешно. Творческих взлетов.

Статью подготовил Андрей Горячих.

P. S. Желаете обходиться без запросов и получить в Автопилоте родные блоки для работы с Таргетхантером? Ставьте лайк и пишите комментарий к посту статьи. Ваша активность = горячая заинтересованность = наша доработка.