Перейти к основному содержимому

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

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

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

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

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

  • Получите API-ключ. Инструкции по получению API-ключа доступны здесь.

  • Откройте воронку в боте на платформе PuzzlBot.

  • В разделе Настройки → Интеграция напишите в url:

https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/on_telegram_webhook

API ключ нужно поменять на ваш, полученный от Откуда Подписки.

подсказка

Готово! Теперь при каждом старте вашего бота, будет посылаться запрос на сервис tgTrack (Откуда подписки бот).

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

подсказка

Для проверки работоспособности интеграции используйте нашу страницу проверки (https://bot-api.tgtrack.ru/last_events/).

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

  • Убедитесь, что бот PuzzleBot успешно передаёт события старта и блокировки, а сервис "Откуда Подписки" принимает их без ошибок. Статус обработки событий должен быть 0.

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

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

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

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

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

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

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