UA	US	RU

UA	US	RU

1 1. Введение
2 2. Настройка интеграции
3 Сопутствующие инструкции
4 Основные термины

1. Введение

Определение

Уведомления в Telegram через блок «Действие» — это автоматизированный механизм мгновенного оповещения менеджера о новых подписчиках или о прохождении подписчиками конкретного блока туннеля. Используется на стадии Управление (Manage) жизненного цикла клиента. При срабатывании блока «Действие» в туннеле платформа Leeloo.AI отправляет HTTP POST-запрос к Telegram Bot API, и менеджер мгновенно получает сообщение с контактами лида в Telegram-группу или канал.

Механизм работает на стыке блока «Действие» (красный блок в конструкторе туннелей продаж), Telegram Bot API (внешний сервис) и переменных платформы (имя, телефон, email подписчика). Без отдельной настройки на стороне Leeloo.AI и Telegram уведомления не работают: нужен бот в Telegram, его API-токен, Chat ID группы, рабочая ссылка с подставленным JSON-телом сообщения.

B2B оператор (маркетолог, менеджер по продажам или владелец бизнеса) настраивает интеграцию один раз — создаёт бота через BotFather, формирует Telegram-группу для команды продаж, получает Chat ID, склеивает рабочую ссылку и настраивает блок «Действие» в туннеле. После этого каждый менеджер команды получает уведомления автоматически — без открытия платформы.

B2C клиент (подписчик) с механизмом уведомлений напрямую не взаимодействует — он просто проходит туннель: подписывается через LGT, отвечает в чате, заказывает консультацию. Однако каждое его прохождение через блок «Действие» становится событием, по которому платформа отправляет уведомление команде продаж в Telegram.

В Client's Card записывается факт прохождения блока «Действие» как событие в логах подписчика. Уведомление в Telegram — это внешнее побочное действие (side-effect) этого события, отправляемое через HTTP-запрос наружу платформы.

После ознакомления вы поймёте:

что такое блок «Действие» и как он используется для отправки внешних запросов;
как создать Telegram-бота через BotFather и получить API-токен;
как создать Telegram-группу, добавить бота и получить Chat ID;
как сформировать рабочую ссылку и JSON-шаблон сообщения с переменными платформы;
как подключить блок «Действие» в туннеле для мгновенных уведомлений команде продаж.

Назначение

Уведомления в Telegram через блок «Действие» — это канал мгновенной осведомлённости команды продаж о ключевых событиях в воронке. Они устраняют задержку «открыл платформу — увидел нового лида»: вместо проверки CRM или Чатов раз в N минут менеджер получает push-уведомление в Telegram в момент события и реагирует в течение секунд.

Управление (Manage) — менеджер получает уведомление в Telegram в реальном времени: новый лид прошёл через LGT и подписался, существующий клиент дошёл до блока «Заказал консультацию» в туннеле или ответил на pre-sale вопросы. Менеджер открывает чат прямо из ссылки в уведомлении и продолжает обработку без задержек. Задача — обеспечить максимально быструю реакцию команды продаж на действия лидов и минимизировать «остывание» горячих заявок.

2. Настройка интеграции

Интеграция настраивается за 12 шагов: подготовка Telegram-бота (раздел 2.1), Telegram-группы (разделы 2.2 – 2.4), получение Chat ID (разделы 2.5 – 2.6), формирование рабочей ссылки (раздел 2.7) и настройка блока «Действие» в туннеле (разделы 2.8 – 2.12). Все шаги последовательные — не пропускайте.

2.1. Создание Telegram-бота через BotFather

Перейдите к боту BotFather в Telegram и подпишитесь на него:

https://t.me/BotFather

Введите команду /newbot и нажмите Enter.

Задайте имя бота — оно будет отображаться для пользователей Telegram (пример: botleeloo).

Задайте username для бота — он обязательно должен заканчиваться на _bot (пример: leeloo199_bot).

Бот готов. Скопируйте API-токен бота — он понадобится далее.

Примечание: если у вас уже есть бот, перейдите в BotFather, введите /mybots, выберите нужного бота из списка и нажмите API Token.

2.2. Создание Telegram-канала или группы

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

2.3. Добавление бота в группу

Добавьте созданного на шаге 2.1 бота в качестве участника группы — без этого бот не сможет отправлять сообщения.

2.4. Публичный режим группы и имя

В настройках группы временно измените тип на Публичная и задайте имя латиницей без пробелов. Публичный режим нужен только на шаге 2.5 для получения Chat ID — после этого группу вернёте в приватный режим.

2.5. Получение Chat ID группы

Сформируйте ссылку по шаблону, заменив значения в верхнем регистре:

https://api.telegram.org/botYOUR_BOT_TOKEN/sendmessage?chat_id=@YOUR_GROUP_NAME&text=hello

Вставьте готовую ссылку в адресную строку браузера и нажмите Enter. На открывшейся странице найдите "chat": {"id": и скопируйте число после него (вместе со знаком «–»).

2.6. Возврат группы в приватный режим

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

2.7. Формирование рабочей ссылки

Сформируйте финальную ссылку для отправки сообщений:

https://api.telegram.org/botYOUR_BOT_TOKEN/sendmessage?chat_id=CHAT_ID

Замените YOUR_BOT_TOKEN на API-токен из шага 2.1, а CHAT_ID — на скопированный идентификатор из шага 2.5.

2.8. Открытие блока «Действие» в туннеле

Перейдите в туннель, нажмите правой кнопкой мыши на пустом поле и создайте блок «Действие» (красный). Откройте его, нажмите «Добавить» и выберите «Отправка внешнего запроса».

2.9. Выбор метода POST

В настройках внешнего запроса в качестве HTTP-метода выберите POST — Telegram Bot API принимает данные именно этим методом.

2.10. URL запроса

В раздел URL вставьте рабочую ссылку из шага 2.7.

2.11. JSON в поле Body

В разделе Body введите JSON-скрипт согласно вашим потребностям. Вы можете добавить любые переменные платформы:

{
  "text": "🎯 Новый подписчик: {name}\n🔹 Тел.: {phone}\n🔹 Чат: https://app.leeloo.ai/chats/all/PersonID/ID/"
}

2.12. Подключение блока и переменные

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

Готово! Теперь каждый раз, когда подписчик проходит через подключённый блок, вы получите сообщение в Telegram с его контактными данными и ссылкой на чат.

Интеграция настраивается один раз и работает автоматически. Если меняется состав команды — добавьте новых участников в Telegram-группу, не нужно перенастраивать бота или блок «Действие».

2.13. Видео-инструкция

Сопутствующие инструкции

Название инструкции	Назначение

Название инструкции	Назначение
Настройка уведомлений	Настройка email-уведомлений и панели уведомлений в Leeloo.AI.

Основные термины

Термин	Пояснение

Термин	Пояснение
Уведомления в Telegram через блок «Действие»	Автоматизированный механизм оповещения команды продаж в Telegram о событиях в туннелях. Работает на стыке блока «Действие», Telegram Bot API и переменных платформы.
Блок «Действие»	Красный блок в конструкторе туннеля продаж, выполняющий действия — в том числе отправку внешних HTTP-запросов.
BotFather	Официальный Telegram-бот для создания и управления ботами.
API-токен	Уникальный ключ бота для доступа к Telegram Bot API.
Chat ID	Уникальный числовой идентификатор Telegram-группы или канала. Для групп начинается со знака «–».
Отправка внешнего запроса	Действие в блоке «Действие», отправляющее HTTP-запрос на указанный URL с данными подписчика.
Переменные платформы	Плейсхолдеры в JSON-теле запроса вида `{name}`, `{phone}`, `{email}`, которые подставляются конкретными данными подписчика в момент срабатывания блока.
Client's Card	Карточка клиента в Leeloo.AI, куда записывается событие прохождения блока «Действие».
Sales Tunnel (Туннель продаж)	Последовательность блоков, через которую проходит подписчик.
Telegram Bot API	HTTP API Telegram для отправки сообщений через бота.