Links for passing UTM parameters and other values are available only for flows in Telegram and MAX. The values of UTM parameters and other fields in the link are recorded in the designated fields in the subscriber card.
UTM parameters are values added to URLs to collect detailed information about traffic (where the user/subscriber came from). They are used to track the effectiveness of advertising and funnels.
How to create a link for passing UTM parameters and other values
- In the flow builder, enable edit mode.
- Open the Links section.
- Copy the link for passing UTM parameters and other values.
You will get a link like:
- For Telegram:
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&utm_source=xxx&utm_medium=xxx&utm_campaign=xxx
- For MAX:
https://max.ru/id3257037015_3_bot?start=c1772705397290-ds&utm_source=xxx&utm_medium=xxx&utm_campaign=xxx
Below we will use the Telegram link as an example. The same principles apply to MAX.
The part "https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds" is the main and required part.
The part "&utm_source=xxx&utm_medium=xxx&utm_campaign=xxx" is variable and can be modified or removed.
Parameters you can pass
- You can add static UTM parameters. Everyone who follows a link with these parameters will receive the corresponding tag in their subscriber card, which can be viewed in the BotHelp dashboard under People by selecting the specific subscriber.
utm_source– specific name of the traffic sourceutm_medium– type of traffic sourceutm_campaign– advertising campaign nameutm_content– differentiates ad versions (e.g., two different links in one email)utm_term– indicates a specific keyword (for AdWords) or email send date for a promotional link
You do not need to create new fields in BotHelp for these UTM parameters; they already exist in the subscriber card.
Example of creating a link with UTM parameters
Take the copied link from the builder:
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&utm_source=xxx&utm_medium=xxx&utm_campaign=xxx
Replace "xxx" with your own values:
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&utm_source=inst&utm_medium=paid_stories&utm_campaign=woman
You can also include only the necessary variables:
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&utm_campaign=woman&utm_content=123
- You can pass values of system (standard) BotHelp fields, such as name, email, or phone.
For example, using the system field name:
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&name=Ivan
The subscriber’s Name field will automatically be set to Ivan.
- You can pass values of custom fields. If the required custom field does not exist in the subscriber card, the data will not be recorded and the field must be created first.
For example, if several bloggers are promoting your flow, you need a custom field blogger. Go to Settings → Custom Fields → Add New Field, specify the field name and type. This field will appear in the subscriber card.
Add the blogger parameter to the links you share with bloggers:
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&blogger=buzova
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&blogger=gasanov
https://r.bothelp.io/tg?domain=testedtt_bot&start=c1774428182693-ds&blogger=vladbumaga
Now, when a subscriber follows the link, they will be tagged with the blogger they came from.
You can include multiple UTM parameters and values in one link. These links can be used in advertising campaigns or as referral links. Learn more about UTM parameters.
If you did not find the answer to your question, feel free to contact us in the chat inside your dashboard, message us on Telegram at @BotHelpSupportBot, or email us at hello@bothelp.io.
Get 14 Days of Full Access to the Platform
Enjoy the full functionality of the BotHelp platform for creating broadcasts, automated funnels, and chatbots — free for 14 days.