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

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

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

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

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

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

  • Трекинг отписок: Узнайте, какие источники трафика приводят пользователей, которые быстро блокируют вашего бота.

  • Аналитика по аудитории: Получайте отчеты по источникам трафика, UTM-меткам, сроку жизни подписчиков и многое другое.

  • Досье на каждого подписчика: Вся история взаимодействия с пользователем в одном месте.

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

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

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

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

Шаг 1 — Получение API ключа​

Для начала вам понадобится уникальный API ключ вашего бота в системе «Откуда Подписки».

примечание

Если у вас еще нет API ключа, получите его по этой инструкции: Как получить API ключ. Это займет не больше минуты.

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

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

  1. Перейдите в конструктор вашего бота на платформе Ботмен.
  2. Выберите блок, который срабатывает при самом первом контакте с пользователем (обычно это блок Старт или аналогичный).
  3. Добавьте в этот блок действие «Вебхук» или «HTTP-запрос».
  4. В настройках этого действия укажите следующие параметры:

  • Метод запроса: POST

    • URL для отправки запроса:
    https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/on_telegram_webhook
    подсказка

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

  1. В поле для тела запроса (Body) вставьте переменную, которая отвечает за передачу всех данных о пользователе от Telegram. В Ботмен это может быть переменная вроде {{full_request}} или {{request_data}}.

    {{full_request}}

    Эта переменная позволит нам получить всю необходимую информацию для корректного трекинга.

    Шаг 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. Главное, чтобы вы сами понимали, что оно означает.

[ЗДЕСЬ СКРИНШОТ: Настройка вебхука для передачи глубокой цели "webinar_reg" в Ботмен.]

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

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

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

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