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

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

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

  • Передача стартов бота в рекламные системы: Яндекс, ФБ, Гугл, ВК, оптимизация на старты бота. Обучайте рекламные алгоритмы на реальные подписки.

  • Глубокие цели: Отправляйте в рекламные кабинеты данные о ключевых действиях внутри воронки (например, регистрация на вебинар, прохождение опроса, покупка) и оптимизируйте рекламу на них.

  • Аналитика по аудитории: отчеты по переходам в бота, конверсии в подписку по источникам трафика, UTM-меткам.

  • Досье подписчика.

  • Ежедневный отчет бота: Автоматическая сводка по подпискам за последние 24 часа.

В этой инструкции разберем, как настроить интеграцию Ботмен с «Откуда Подписки».

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

Процесс интеграции заключается в том, чтобы ваш бот на платформе Ботмен отправлял нам данные о новых подписчиках и их ключевых действиях с помощью вебхуков (Webhook).

Шаг 1 — Для интеграции получите API ключ в Откуда подписки бот. Как получить API ключ тут​

Шаг 2 — Настройка вебхука в Ботмен при старте бота​

Теперь настроим отправку данных в момент, когда пользователь запускает вашего бота.

  1. Перейдите в конструктор вашего бота на платформе BotMan.
  2. Добавьте блок "действие" после старта бота (самый первый блок) и выберите внешний запрос
  1. Установите метод отправки POST и задайте URL вида:
https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/user_did_start_bot

  1. В тело запроса необходимо поставить следующее
{
"user_id":"{{user_id}}",
"first_name":"{{first_name}}",
"last_name":"{{last_name}}",
"username":"{{user_name}}"
}

подсказка

Замените API_КЛЮЧ в ссылке на ваш собственный API ключ, полученный на первом шаге.

Шаг 3 — Проверка подключения​

Отлично! Базовая настройка завершена. Давайте убедимся, что все работает корректно.

  1. Перейдите по ссылке на вашего бота и перезапустите его командой /start.
  2. Откройте нашу страницу для проверки работоспособности интеграции: https://bot-api.tgtrack.ru/last_events/
  3. Введите свой API ключ и посмотрите последние полученные события. Вы должны увидеть информацию о вашем запуске бота.

Как настроить передачу глубоких целей​

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

Шаг 1 — Добавление вебхука для глубокой цели​

  1. В конструкторе воронок Ботмен найдите блок, в котором совершается целевое действие (например, кнопка «Зарегистрироваться»).

  2. После этого действия добавьте новый шаг «Вебхук» или «HTTP-запрос».

  3. В настройках укажите:

    • Метод запроса: POST
    • URL для отправки запроса:

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

подсказка

Снова замените API_КЛЮЧ на ваш ключ из «Откуда Подписки». Обратите внимание, что URL для глубоких целей отличается от URL для старта бота.

  1. В поле для тела запроса (Body) укажите данные в формате JSON:

    {
      "user_id": "{{user_id}}",
      "target": "webinar_reg"
    }
  • "user_id": "{{user_id}}": Здесь {{user_id}} — это системная переменная Ботмен, которая содержит ID пользователя в Telegram.
  • "target": "webinar_reg": Здесь webinar_reg — это название вашей цели. Вы можете задать любое имя на латинице, например: quiz_passed, lead_generated, lesson3_viewed. Главное, чтобы вы сами понимали, что оно означает.

Шаг 2 — Настройка рекламных кабинетов​

Чтобы рекламные системы начали «видеть» ваши цели и оптимизироваться на них, необходимо настроить передачу конверсий.

Важная информация

Для передачи данных целей из вашего бота в рекламную систему после настройки интеграции нужно сделать подключение к рекламной системе по инструкции