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

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

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

“подписки 24ч”
Досье подписчика.

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

1. Настройка внешнего запроса для SamBot

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

Добавьте действие «Отправить веб-запрос»

В конструкторе вашего бота на платформе SAMBOT в разделе Реакции выберите первую реакцию, которая запускается при старте бота.

Выполните настройку как на скрине.

Укажите адрес внешнего сервиса (URL)

В поле Адрес внешнего сервиса вставьте следующий URL:

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

подсказка

Замените API_КЛЮЧ на ваш уникальный API ключ, полученный от бота «Откуда Подписки» на 📘 шаге 1.

Выберите Метод отправки: POST
Добавьте JSON с данными пользователями:

Поставьте галочку напротив пункта Отправить JSON. В поле Укажите JSON скопируйте и вставьте следующий код:

{
"user_id": "{user_id}",
"first_name": "{first_name}",
"last_name": "{last_name}",
"username": "{username}"
}

Как это работает?

Этот код формирует пакет данных о пользователе. Платформа SAMBOT автоматически заменит переменные в фигурных скобках (например, {user_id}) на реальные данные пользователя, запустившего бота.

После выполнения этих шагов ваш бот будет готов отправлять информацию о каждом новом подписчике в систему «Откуда Подписки», что позволит вам отслеживать источники трафика и эффективность рекламы.

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

Для проверки работоспособности интеграции используйте нашу страницу тестирования: 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 – запрещает нашему сервису изменять значение параметра старт.