Purpose

Telegram Bot is a type of pixel that sends notifications about conversions to a Telegram channel or group in real time. It is used to promptly track conversions (deposits, registrations, PWA installations, etc.) directly in the team's TG channel, so buyers and team leads can monitor results in real time.

Advantages:

• ✅ Instant notifications about conversions directly in Telegram

• ✅ Custom message template with macros

• ✅ Support for HTML formatting (bold, italic, etc.)

• ✅ Real-time monitoring without opening the platform

• ✅ Sending to any channel or group where the bot is an administrator

Preliminary setup: creating a bot

Before creating a Telegram Bot pixel, you need to add the bot in the Tracker → Telegram Bots section:

1. Go to Tracker → Telegram Bots

2. Click “Add Bot”

3. Specify the Name and Token of the bot (get it from @BotFather in Telegram)

4. Configure the Webhook for the bot

5. Add the bot as an administrator in the desired channel/group

The bot can also be created directly from the pixel form by clicking the “+ Bot” button next to the bot selection.

Configuring the Telegram Bot pixel

Step 1: Selecting a bot

In the “Telegram Bot” field, select the bot from the list. For administrators, the list is filtered by the selected team.

Step 2: Selecting a channel/group

In the “Channel ID” field, select the channel or group where the bot will send messages. The list of channels is loaded automatically after selecting the bot.

The bot must be an administrator of the channel/group to send messages.

Step 3: Configuring the message template

Now you can configure the pixels for the Telegram Bot.

1. Go to Pixels

2. Select the Telegram Bot type

3. Click ⋮

4. Edit

The message template defines how the notification will look in the channel. HTML markup is supported in Telegram (<b>, <i>, <code>, etc.) and macros for substituting conversion data.

Default template:

<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})

Example message in the channel:

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

Available macros

How to insert a macro:

1. Click the button with the desired macro below the template field

2. The macro will be inserted at the current cursor position

3. The button will turn green if the macro is already used in the template

Event mapping for Telegram Bot

Mapping is configured just like for other types of pixels. You select tracker events and their corresponding events. When an event is triggered, a message is sent to the channel.

Recommended mapping:

Testing the Telegram Bot pixel

To check the settings, use the “Test Telegram” action in the pixel menu (⋮):

1. Open the actions menu (⋮) for the Telegram Bot pixel

2. Select “Test Telegram”

3. The bot will send a test message with filled test data to the selected channel

4. Check the message in the channel — the data will be test data (for example, Test Campaign, Test Offer, revenue = 10.00)

Complete configuration example

Event mapping:

Result: with each deposit, a message arrives in the channel with the campaign name, offer, amount, and advertising campaign details.

Features of operation

1. Messages are sent via the Telegram Bot API (sendMessage with parse_mode: HTML)

2. Asynchronous processing — events are processed through a queue, like other types of pixels

3. Sending logs are available in the pixel's “Logs” section (status, request/response)