Как подключить и использовать Telegram в модуле «Воронки»

Одно из преимуществ модуля «Воронки» — это гибкая работа с базой пользователей через Telegram. В этой статье мы расскажем про первоначальные настройки: как правильно настроить Telegram-бота, какие есть различия в способах подключения ботов, как запускать бота в воронке и другие аспекты работы через Telegram.

Ниже рассмотрим, какие способы подключения доступны, а также чем они отличаются и можно ли изменить способ для конкретного бота.

В модуле «Воронки» вы можете использовать:

1. Ботов, подключенных к аккаунту через стандартный функционал.
2. Новых ботов, подключенных напрямую к модулю «Воронки».

В зависимости от того, какой бот используется — подключенный к аккаунту или подключенный напрямую к модулю «Воронки», — их работа в модуле будет отличаться.

Бот под управлением GetCourse:

• Действия запускаются только по предварительно зарегистрированному пользователю, который привязал к своему профилю такого бота.

Бот под управлением воронок:

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

Бот под управлением GetCourse:

• Реакции могут срабатывать с задержкой, так как бот задействован в стандартном функционале аккаунта (отправка рассылок, работа процессов и т. д.).

Бот под управлением воронок:

• Работает напрямую, благодаря чему реагирует практически моментально.

Бот под управлением GetCourse:

• Привязывается к пользователю, а значит, можно использовать вне модуля «Воронки», например, в процессах, рассылках и т. д.

Бот под управлением воронок:

• Используется только для рассылок внутри модуля «Воронки».

Бот под управлением GetCourse:

• Все сообщения пользователей, а также нажатия на кнопки попадают в раздел «Входящие».

Бот под управлением воронок:

• Сообщения не попадают в раздел «Входящие». С пользователями можно общаться в формате мессенджера в разделе «Apps» — «Боты» — «Чаты».

Бот под управлением GetCourse:

• Используется короткая ссылка.

Бот под управлением воронок:

• Ссылка для привязки находится в разделе «Apps» — «Боты» в настройках бота, пункт «Ссылка для привязки чата к пользователю».

Подключение через стандартный функционал GetCourse описали в инструкции «Как подключить Telegram-бот к аккаунту».

Для подключения напрямую к модулю «Воронки»:

1. Установите приложение «Боты» в разделе «Apps» — «Каталог», если еще не сделали это ранее.

2. После установки вы сразу попадете на страницу с настройками. Если вы уже устанавливали приложение ранее, перейдите в раздел «Apps» — «Боты».

3. На вкладке «Настройки» нажмите на «+» в разделе «Транспорты» и выберите «Telegram Bot».

4. Создайте Telegram-бота в BotFather по инструкции. В итоге вы должны скопировать токен созданного бота (шаг 4 инструкции).
5. Вставьте токен в поле «Ключ бота» и нажмите «Проверить ключ бота».

6. Нажмите «Использовать этого бота».

Сделать это можно при добавлении бота или, если бот уже есть в списке доступных транспортов, в его настройках с помощью кнопки «Проверить» под строкой «Адрес веб-хука».

У бота может быть четыре варианта ответа при проверке ключа:

1. Поле загорелось желтым цветом, адрес веб-хука не установлен — такой бот нигде не используется и его можно подключить.
2. Поле загорелось зеленым цветом, в адресе веб-хука имеются параметры chtm/app/sender — бот уже находится под управлением модуля «Воронки».

3. Поле осталось серым, в адресе веб-хука имеются параметры chtm/app/sender, ниже появилось желтое поле «Установленный адрес веб-хука» с адресом вашего аккаунта — бот находится под управлением GetCourse и его можно использовать в воронках или передать под управление модуля «Воронки» [перейти к инструкции ▼].
4. Поле загорелось желтым цветом, в адресе веб-хука нет параметров chtm/app/sender и прописан адрес сторонней системы — такой бот используется сторонней системой и его нельзя использовать для работы с воронками.

При необходимости вы можете перепривязать подключенный к модулю «Воронки» бот к аккаунту GetCourse и наоборот. При этом сохранятся подписчики бота и связи чатов с пользователями.

Чтобы перепривязать бота из модуля «Воронки» в аккаунт GetCourse:

1. Зайдите в настройки этого бота в разделе «Apps» — «Боты».
2. Нажмите «Убрать внешнее управление».

Бот перейдет под управление аккаунта GetCourse.

Чтобы перепривязать бота из аккаунта GetCourse в модуль «Воронки»:

1. Добавьте бота в список транспортов в разделе «Apps» — «Боты».
2. Укажите его токен.
3. Отметьте опцию «Заменить адрес веб-хука для обработки событий».

Также вы можете для уже существующего бота, который был добавлен в аккаунте, в настройках нажать «Установить» под полем с адресом веб-хука. Появится предупреждение о подтверждении и бот перейдет под управление модулем «Воронки».

После этого вы не сможете отправлять рассылки через этот бот в разделе «Сообщения» — «Рассылки». Взаимодействие с чатами пользователей будет возможно в разделе «Apps» — «Боты» — «Чаты».

Если вы еще не добавляли бота в воронку, то перед запуском вам необходимо это сделать:

1. Нажмите на шестеренку рядом с названием воронки.
2. Выберите бота в выпадающем списке.
3. Нажмите «Связать бота со сценой».

4. Далее подтвердите действие.
5. Сохраните изменения.

Теперь вы можете использовать бота в воронке.

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

Ниже рассмотрим несколько способов запуска бота в воронках:

1. С помощью ссылки для привязки чата к пользователю — можно будет выбрать, запускать воронку по любому, кто запустил бота, или выборочно по участникам определенной воронки.
2. Через лендинг с сохранением рекламных источников.
3. По прямой ссылке — можно использовать для продвижения через посевы.
4. Один бот для запуска в разных воронках.

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

Для этого варианта запуска бота должны быть соблюдены условия:

1. Пользователь должен быть авторизован в вашем аккаунте на момент запуска бота, чтобы произошла привязка бота к пользователю.
2. Пользователь должен запустить бот по ссылке для привязки чата к пользователю. Скопировать ее вы можете в разделе «Apps» — «Боты», на вкладке «Настройки» нужного бота.

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

Такая настройка ноды будет учитывать любые запуски бота. Следующее за запуском бота событие будет отрабатывать по всем пользователям.

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

1. Присвоить переменную пользователю на одном из предыдущих этапов воронки (до запуска бота), чтобы можно было определить, что текущий пользователь относится к этой воронке. Для этого:
   • добавьте перед нодой «Команда бота» любое событие, у которого в параметрах есть агент «user», например, «Добавлен в группу»;

• перейдите в настройки реактивности события (на вкладке воронки «Запуск»);
• выберите «При запуске блока — Установить переменные» и пропишите любую понятную переменную, например, funnel1: user.funnel1 = true.

2. Добавить проверку этой переменной на переходе из ноды «Команда бота», чтобы следующие события воронки запускались только по пользователям с нужной переменной, т. е. по пользователям из данной воронки. Для этого:
   • дважды нажмите на стрелку-переход,
   • выберите «установить условие»,

• пропишите значение переменной и нажмите «Применить».

После такой настройки следующие действия выполнятся только в случае, если у пользователя будет соответствующая переменная.

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

1. В настройках ноды «Команда бота» перейдите по ссылке «Как сделать ссылку в Telegram-бота?».

2. Найдите блок с нужным ботом и скопируйте строку «Для указания действия (click) в кнопке на странице».

3. В настройках кнопки лендинга используйте вызов JavaScript и добавьте в него скопированное значение. Ниже пример для кнопки на лендинге GetCourse

Также вместо кнопки вы можете разместить на лендинге ссылку для запуска бота в текстовом формате. В этом случае в качестве адреса укажите значение из строки «Для указания адреса (url) в ссылке на странице».

При таком запуске в первом сообщении пользователя после /start будет передаваться специальный параметр для определения сессии пользователя.

Для аналитики проведите к ноде «Команда бота» ноду «Источники трафика» — все рекламные метки протянутся автоматически.

Такой способ подойдет, когда не нужно учитывать источник запуска.

Для настройки:

1. Используйте прямую ссылку на бота вида https://t.me/USERNAME_ВАШЕГО_БОТА.
2. В настройках ноды «Команда бота» выберите «Запускать, если сообщение пользователя» — «точно совпадает с любым из вариантов».

При необходимости вы можете разметить ссылку на бота, чтобы отслеживать разные источники запуска. Это может быть полезно, например, для продвижения через посевы. Для этого:

1. Перейдите в раздел «Apps» — «Боты» — «Ссылки-метрики».
2. Нажмите на кнопку «Добавить новую ссылку-метрику».

3. Заполните название и метки для ссылки и нажмите «Добавить новую ссылку».
4. Нажмите «Скопировать URL». Эту ссылку вам нужно будет использовать для продвижения.

5. В настройках ноды «Команда бота» используйте вариант «Запускать, если сообщение пользователя» — «содержит любое из ключевых слов».

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

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

1. Укажите его в ссылке-метрике — рассматривали эту настройку [в разделе выше ▲].
2. Или сформируйте ссылку вида https://t.me/USERNAME_ВАШЕГО_БОТА?start=myparam1, где «myparam1» — значение параметра, которое вам нужно прописать.

Далее в настройках ноды «Команда бота» используйте чекбокс «Включить фильтр по стартовому параметру» и добавьте свой стартовый параметр (вручную либо из ссылок-метрик). С такими настройками нода «Команда бота» будет запущена, только если в событии был указанный стартовый параметр.

В своем Telegram пользователь может установить настройки конфиденциальности и запретить отправлять себе некоторый контент.

В воронках у вас есть возможность проверить, разрешено ли отправлять пользователю:

• голосовые сообщения и видеозаметки,
• обычные сообщения.

Используйте для этого ноду «Проверить разрешения чата».

В ней есть две настройки:

1. «Выберите тип разрешения» — можно проверить разрешение на отправку сообщений (то есть не заблокирован ли бот) или на отправку голосовых и видеозаметок.
2. «Сохранить результат в переменную объекта с типом» — можно выбрать тип переменной и ее название. В переменную будет записано значение true (если разрешение есть) либо false (если разрешения нет). Значение переменной можно проверять далее в воронке на переходах и нодах, таким образом проверяя наличие или отсутствие нужных разрешений у пользователя.

Telegram позволяет запросить у пользователя привязанный номер телефона. Это гарантирует, что номер настоящий и принадлежит этому пользователю.

Для получения контакта таким образом вам нужно:

1. Настроить ноду «Отправить сообщение».
2. Настроить ноду «Событие чата Telegram».
3. Обработать событие получения контакта от пользователя.

Чтобы запросить контакт:

1. Добавьте ноду «Отправить сообщение» и перейдите в ее настройки.
2. Напишите текст сообщения.
3. Нажмите «Добавить вариант ответа» и напишите текст для него.
4. Нажмите кнопку «Настройки» и выберите пункт «Запросить контакт».

При таких настройках нода отправит пользователю сообщение с кнопкой. При нажатии на кнопку он увидит окно с подтверждением отправки контакта.

Для сохранения данных:

1. Добавьте ноду «Событие чата Telegram».
2. Соедините ее с нодой «Отправить сообщение», настроенной ранее.
3. Укажите тип события «Получен контакт».

Данные о полученном контакте можно обработать стандартными средствами воронки: сохранить в переменную, проверять в условиях, отправить в тексте сообщения и т. д.

Событие «Получен контакт» позволяет получить следующие свойства пользователя:

• event.contact.phone_number — номер телефона,
• event.contact.first_name — имя отправленного контакта,
• event.contact.last_name — фамилия отправленного контакта (при наличии),
• event.contact.user_id — id из Telegram пользователя (при наличии),
• event.contact.vcard — дополнительные данные о контакте в виде vCard (при наличии).

Вы можете сохранить нужные свойства в переменные. Для этого:

1. Перейдите в настройки реактивности ноды «Событие чата Telegram» (на вкладке воронки «Запуск»).
2. Отметьте чекбокс «Установить переменные».
3. Сохраните нужные свойства в переменные, например,
   user.phone = event.contact.phone_number
   
   user.telegramId = event.contact.user_id,
   или весь объект целиком, например,
   user.tgContact = event.contact.

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

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

1. Подготовьте две разные реакции: на получение верного контакта и получение чужого (например, разные сообщения).
2. Нажмите на переход из ноды «Получен контакт» к сообщению об успешном получении контакта.

3. Выберите «Запустить, если» — «все условия выполнены», в «Значения переменных» пропишите соответствие идентификатора текущего пользователя присланному контакту event.contact.user_id == event.chat.originId.
4. Нажмите «Применить».

5. Аналогично настройте переход к сообщению о получении чужого контакта.

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

Вам также могут быть полезны статьи:

• Работа с выражениями в модуле Воронки
• Типовые ошибки, возникающие при срабатывании реакций в воронке