Назначение

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 Bot`а.

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. Логи отправки доступны в разделе «Логи» пикселя (статус, запрос/ответ)