Telegram Bot — відбивка конверсій у Telegram канал

Призначення

Telegram Bot — це тип пікселя, який надсилає сповіщення про конверсії в Telegram-канал або групу в реальному часі. Застосовується для того, щоб оперативно відбивати конверсії (депозити, реєстрації, установки PWA тощо) прямо в Тг-канал команди, щоб баєри і тімліди могли моніторити результати в режимі реального часу.

Переваги:

• ✅ Моментальні сповіщення про конверсії прямо в Telegram

• ✅ Кастомний шаблон повідомлень з макросами

• ✅ Підтримка HTML-форматування (жирний, курсив тощо)

• ✅ Моніторинг в реальному часі без відкриття платформи

• ✅ Відправка в будь-який канал або групу, де бот є адміністратором

Попереднє налаштування: створення бота

Перед створенням Telegram Bot пікселя необхідно додати бота в розділі Tracker → Telegram Bots:

1. Перейдіть в Tracker → Telegram Bots

2. Натисніть «Додати бота»

3. Вкажіть Ім'я і Токен бота (отримайте у @BotFather в Telegram)

4. Налаштуйте Webhook для бота

5. Додайте бота як адміністратора в потрібний канал/групу

Бота також можна створити прямо з форми пікселя, натиснувши кнопку «+ Bot» поруч з вибором бота.

Налаштування Telegram Bot пікселя

Крок 1: Вибір бота

В полі «Telegram Bot» виберіть бота зі списку. Для адміністраторів список фільтрується за вибраною командою.

Крок 2: Вибір каналу/групи

В полі «Channel ID» виберіть канал або групу, куди бот буде надсилати повідомлення. Список каналів завантажується автоматично після вибору бота.

Бот повинен бути адміністратором каналу/групи для надсилання повідомлень.

Крок 3: Налаштування шаблона повідомлення

Тепер можна налаштувати пікселі для Telegram-бота.

1. Перейдіть в Pixels

2. Виберіть тип Telegram Bot

3. Натисніть ⋮

4. Редагувати

Шаблон повідомлення визначає, як буде виглядати сповіщення в каналі. Підтримується HTML-розмітка Telegram (<b>, <i>, <code> тощо) і макроси для підстановки даних конверсії.

Шаблон за замовчуванням:

<b>{campaign.name} [{event.user_country}]</b>
Offer:{offer.name}
Revenue:{event.event_revenue}
------
FB Campaign:{event.ext_sub4} ({event.ext_utm_content})
FB Adset:{event.ext_sub5} ({event.ext_utm_term})
FB Ad:{event.ext_sub6} ({event.ext_sub1})

Приклад повідомлення в каналі:

💬 My Campaign [DE]
Offer: Casino Offer X
Revenue: 150
------
FB Campaign: campaign_123 (1231321584654)
FB Adset: adset_789 (12313245645465)
FB Ad: ad_012 (12333255552222)

Доступні макроси

Як вставити макрос:

1. Натисніть на кнопку з потрібним макросом під полем шаблона

2. Макрос вставиться в поточну позицію курсора

3. Кнопка стане зеленою, якщо макрос вже використовується в шаблоні

Маппінг подій для Telegram Bot

Маппінг налаштовується так само, як і для інших типів пікселів. Ви вибираєте події трекера і відповідні їм події. При спрацьовуванні події повідомлення надсилається в канал.

Рекомендований маппінг:

Тестування Telegram Bot пікселя

Для перевірки налаштувань використовуйте дію «Test Telegram» в меню пікселя (⋮):

1. Відкрийте меню дій (⋮) для Telegram Bot пікселя

2. Виберіть «Test Telegram»

3. Бот надішле тестове повідомлення з заповненими тестовими даними в вибраний канал

4. Перевірте повідомлення в каналі — дані будуть тестовими (наприклад, Test Campaign, Test Offer, revenue = 10.00)

Повний приклад конфігурації

Маппінг подій:

Результат: при кожному депозиті в канал приходить повідомлення з назвою кампанії, офером, сумою і деталями рекламної кампанії.

Особливості роботи

1. Повідомлення надсилаються через Telegram Bot API (sendMessage з parse_mode: HTML)

2. Обробка асинхронна — події обробляються через чергу, як і інші типи пікселів

3. Логи надсилання доступні в розділі «Логи» пікселя (статус, запит/відповідь)