To create a Telegram bot, go to the "Spots" section

Click “Add spot” and select “Telegram bot”

Adding Telegram App steps:

Step 1. Fill in the “General” tab

Name - the name of the bot in our system for your convenience

Editing rights - grant rights to users who have the right to edit this Telegram App, as well as receive a link to launch traffic to the Telegram App and view outgoing postbacks.

Delete permissions - grant permissions to users who have the right to delete this Telegram App

Step 2. Fill in the “Bot” tab

Bot Username — enter your Telegram bot's username without the @ symbol (for example, myname_bot).

Webhook Link (Recommended)

This type of webhook is designed to reliably and accurately transmit user IDs for subsequent tracking of their actions in the MVP Project system. It is supported by most popular platforms for creating Telegram bots, including both constructors and custom solutions.

URL format:

https://thedinator.com/tracker/bot/webhook/QFCkQw83/?user_id={user_id}&subscriber_id={sub_id}

Explanation of parameters:

• user_id — Telegram user ID. Obtained on the first layer of your bot.
• subscriber_id — internal user identifier on the MVPProject platform. Passed to the /start command and comes in the format /start xxx-xxx-xxx .

Example request:

https://thedinator.com/tracker/bot/webhook/QFCkQw83/?user_id=123456789&subscriber_id=abc-123-xyz

It is recommended to use this method, as it is easy to implement and does not require additional operations.

Link for Telegram webhook

This option is used in cases where the platform does not allow you to configure the request parameters. It is assumed that you duplicate the contents of the standard Telegram webhook request (for example, the update object) directly, without modifications. Suitable for advanced custom solutions and rare platforms with direct access to outgoing data.

Send link:

https://thedinator.com/tracker/bot/telegram/webhook/QFCkQw83/

It is recommended to pass the entire update structure received from the Telegram API in the request body.

If you are using a builder platform and are not sure whether it supports passing parameters in the URL, contact the platform's technical support or choose the method with a simple webhook.

Step 3. Complete the Deals tab

• Specify whether a CRM is connected to this channel (Yes/No).
• Select one or more communication channels through which tracking will be performed (add the channels first if they have not been created yet).

Step 4. Complete the Postbacks tab.

On this tab you can add pixels of various advertising networks where to send postbacks about subscriptions, registrations, sales, etc.

Postback type - select where you want to send postbacks. You can find more information about setting up each postback type in the section “Setting up analytics and tracking” .

Step 5. Assign Responsible Users

1. Open the Responsible Users tab (available if CRM is enabled for the channel on the Deals tab).
2. Assign users to the required lines (for example, 1st Line Manager and 2nd Line Manager).
3. This allows incoming leads to be distributed across shifts and pipelines.

Step 6. Add an AI Character

1. Open the AI tab.
2. Select an AI character from the drop-down list.
3. Click Create Spot.
4. Your Telegram bot is now ready to use! 🥳

For detailed instructions on creating an AI character, see ➡️ here

📢 Telegram Bot Spot Editing Guide

1. The "Deals" tab

• Add a postback URL with the required parameters (for example: https://google.com?clickid={clickid}&custom_parameter={tg_id}). The tg_id parameter allows you to pass the user's Telegram ID together with the clickid. Passing tg_id is optional and can be configured as needed.
• New! You can now pass the Spot UUID in deals using the spot={spot} macro. This parameter is optional and can be configured as needed.
• Specify a link anchor. Any URL sent by a manager to a client will be displayed using this anchor text. For example, if the manager sends https://thedinator.com/lr/5QM4?otv=1, the client will see it as Platform.
• Specify the macro that will be used to quickly insert the link into messages, broadcasts, welcome messages, and commands (for example, {link1}).
• If you use multiple offers, add them by clicking Add Offer. You can also enable random offer distribution.
• Click Save Changes.

2. Adding Custom Macros

1. Open the Variables tab.
2. Click Add Variable.
3. In the Variable field, select the desired macro name from the drop-down list.
4. In the Value field, enter the text that should be inserted when the macro is used.
5. Click Save Changes.

For more information about configuring variables, see ➡️ here

Let's take a look at the main features of the Telegram Bot Spot card.

Telegram bot card

Button 1. Edit

Allows you to edit the selected spot.

Button 2. Subscribers

Displays all information about the spot's subscribers. You can sort and filter the data, as well as export it to an Excel file for further work with your subscriber database.

Button 3. Postbacks

Displays all outgoing postbacks (to Facebook, Google, and TikTok) and incoming postbacks associated with this spot.

Button 4. Conversions

Displays information about your spot subscribers' conversions. You can sort and filter the data, as well as export it to an Excel file for further analysis and management of your subscriber database.

Button 5. Generate Landing Page Links

Generates a tracking link for this spot.

Button 6. Postback Links

Displays a list of postback URLs that can be used to send information about user actions back to the platform. These actions will be reflected in the statistics.

Button 7. Delete

Deletes the Telegram bot spot.