Как подключить SamBot

SamBot поддерживает полную интеграцию с Откуда Подписки, доступен функционал:

  • Передача активаций бота в рекламные системы Яндекс/ФБ/Гугл/ВК, оптимизация на старты бота
  • Глубокие цели: передача в рекламные системы Яндекс/ФБ/Гугл/ВК глубоких целей воронки. Например, просмотр урока №2, регистрация на вебинар, покупка.
  • Трекинг отписок (блокировок) бота
  • Аналитическая отчетность по аудитории: источники трафика, срок жизни в боте, полный список подписчиков, utm метки откуда пришли
  • Аналитическая отчетность по подпискам: переходы в бота, конверсии в подписку 
  • Ежедневные отчеты бота
    “подписки 24ч”
    “отписки 24 ч”
  • Досье подписчика

Следуйте по шагам для настройки подключения:

1. Настройка webhook для SamBot

  1. Откройте настройки проекта на платформе SamBot.
    • При старте или блокировке вашего бота отправьте вебхук, полученный от телеграм в поле «webhook» на этот метод

Что такое webhook.

Когда кто то запускает бота в телеграм, сам телеграм присылает сообщение, кто бота запустил платформе, которая управляет ботом, в данном случае SamBot.
Самый простой способ – передать это сообщение в наш сервис Откуда Подписки, остальное бот всё сделает сам.

2. Для интеграции необходимо получить API ключ. Как получить API ключ тут.


Пример URL, на который надо послать запрос:
https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/sambot_on_tg_webhook

Вот так выглядит настройка отправки в sambot:

Что нужно передать:

НазваниеТипОписание
webhookJsonwebhook, полученный от телеграм

Пример:
{

  “webhook”: {<полный вебхук, полученный от телеграм>}

}

2. Проверка подключения

Для проверки настройки webhook используйте страницу тестирования API TGTrack:
https://bot-api.tgtrack.ru/last_events/

Укажите ваш API ключ (который получили на шаге 1) и проверьте последние 100 запросов.

Проверим, что samBot действительно передаёт старт, стоп, а сервис Откуда Подписки принимает его без ошибок. Статус обработки событий должен быть – 0.

3. Особенности

Если у вас несколько воронок, которые запускаются по разным значениям параметра start бота, то в ссылке на вашего бота укажите нужный параметр:


https://t.me/ВАШБОТ?start=ВАШЕЗНАЧЕНИЕ

Если ваша воронка не запускается, то допишите на ленде к ссылке бота параметр ?nochange.

1) с параметром старт: https://t.me/ВАШБОТ/?start=СТАРТСЛОВЛ&nochange=1
2) без параметра старт: https://t.me/ВАШ_БОТ/?nochange=1

СтартСлов – слово по которому стартует та или иная воронка, если у вас несколько воронок.

nochange – запрещает нашему сервису изменять значение параметра старт.

См. далее:
Передача стартов бота в Я.Директ
Передача стартов бота в Facebook/Insta
Передача стартов бота в VK Реклама