Open

UA Open	US	RU

UA Open	US	RU

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, склеює робоче посилання та налаштовує блок «Дія» у тунелі. Після цього кожен менеджер команди отримує сповіщення автоматично — без відкриття платформи.

Open

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.

Open

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

Open

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

Open

Бот готовий. Скопіюйте API-токен бота — він знадобиться далі.

Open

2.2. Створення Telegram-каналу або групи

У Telegram створіть нову групу або канал, до яких команда продажів буде отримувати сповіщення про лідів.

Open

2.3. Додавання бота до групи

Додайте створеного на кроці 2.1 бота як учасника групи — без цього бот не зможе надсилати повідомлення.

Open

2.4. Публічний режим групи та ім'я

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

Open

2.5. Отримання Chat ID групи

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

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

Open

2.6. Повернення групи у приватний режим

Поверніться у налаштування групи та змініть тип з Публічна знову на Приватна — для захисту контактних даних передплатників.

2.7. Формування робочого посилання

Сформуйте фінальне посилання для надсилання повідомлень:

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

2.8. Відкриття блоку «Дія» у тунелі

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

Open

2.9. Вибір методу POST

У налаштуваннях зовнішнього запиту як HTTP-метод оберіть POST — Telegram Bot API приймає дані саме цим методом.

Open

2.10. URL запиту

У розділ URL вставте робоче посилання з кроку 2.7.

Open

2.11. JSON у полі Body

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

Open

2.12. Підключення блоку та змінні

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

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

Open

Супутні інструкції

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