В этой статье разберем основные принципы работы с Telegram-ботами в GetCourse.

• Способы интеграции с ботами
• Привязка к пользователю
• Запуск бота
• Ограничение запусков воронки только для подписчиков воронки
• Учет источников трафика при разных точках входа
• Запись utm-меток (или других параметров визита) в доп.поля пользователя/заказа

В связи с множеством отличий в способах интеграции с ботом или вариантом запуска, механики работы могут отличаться, поэтому по каждому вопросу будем разбирать несколько вариантов, в зависимости от разных вводных данных.

Способы интеграции

Основные отличия интеграции с ботами рассмотрены в этой статье. Изучив её вы можете определиться, под чьим управлением должен находиться бот. Далее в статье, будут использоваться термины "под управлением GC" или "под внешним управлением". Для того, чтобы узнать, под чьим управлением на данный момент находится бот, можно перейти в его настройки в модуле ботов /chtm/app/sender/ и нажать кнопку "проверить" под адресом веб-хука.

• если поле загорелось зеленым цветом, значит бот находится под управлением Воронок. В терминах GC - "под внешним управлением".
• если над кнопкой появилось еще одно поле с адресом вебхука, то
  • если адрес указывает на ваш getcourse-аккаунт, под находится под управлением GC
  • если адрес указывает на другой домен, значит ваш под находится под управлением какой-то внешней системы. Такие боты в воронках использовать невозможно.

Привязка к пользователю

Если привязать чат к пользователю, то в воронках при получении событий по этому чату, будет подтягиваться агент пользователь. В зависимости от способа интеграции, используются разные ссылки для привязки чата к пользователю. В обоих случаях важно, чтобы пользователь переходил по ссылке авторизованным. Без авторизации система не поймет, к какому пользователю необходимо привязывать бота.

Бот в GC Ссылка для привязки находится в настройках бота на стороне GC

Бот в Воронках Ссылка для привязки находится в настройках бота в модуле /chtm/app/sender

Это не обязательное действие, вы можете начать работу с ЛИДом с бота, а связку с пользователем сделать позже.

• В случае с ботом GC, для этого нужно будет направить авторизованного пользователя (с техническим адресом @telgram) на страницу с формой. После заполнения формы, у пользователя будет обновлен email. Для этого можно использовать рассылку GC с включенной опцией "оборачивать ссылки для авторизации".
• Для бота под внешним управлением, вам нужно обернуть ссылку для отслеживания кликов, после заполнения формы, получившийся пользователь автоматически свяжется с чатом из которого был переход.

Запуск бота

Для отслеживания запуска бота можно использовать ноду "Команда бота".

Первый запуск бота всегда происходит с входящим сообщением начинающимся или равняющимся /start. В зависимости от задачи, этот параметр может меняться.

Варианты запуска бота:

• привязка к пользователю после заполнения формы
• переход в бота с лендинга по кнопке или ссылке (минуя любые формы)
• запуск бота по прямой ссылке
• запуск разных воронок для одного и того же бота

Подробнее о каждом из вариантов, вы можете узнать в этой статье.

Запись utm-меток (или других параметров визита) в доп.поля пользователя/заказа

Сохранение utm-параметров разобрали в этой статье