TGStaff Complete Guide to Diversion Links: Attribution Closed Loop from Ad Click to Bot Launch

#TGStaff Complete Guide to Diversion Links (Magic Links): Attribution Closed Loop from Ad Click to Bot Launch

At the intersection of B2B SaaS and the Telegram ecosystem, traffic attribution has always been one of the most troublesome issues for the operations team. When you place an ad on Facebook, Google or email to guide users to click on a link to enter Telegram Bot, how do you know exactly which channel and ad group the user comes from? TGStaff’s Diversion Link (Magic Link) was born to solve this pain point. This article will break down in detail how magic links work, how to configure attribution capabilities, and the complete traffic link from ad clicks to agent engagement.

What is TGStaff diversion link (magic link)?

TGStaff diversion link (called “magic link” in the official documentation) is a short link generated by the app.tg-staff.com domain name. The core difference between it and the ordinary t.me/yourbot?start=xxx link is: The offload link will first pass through an intermediate page before jumping to Telegram Bot. This intermediate page is responsible for capturing the visitor’s IP address, browser information (User-Agent), and URL parameters (including UTM tags), and then correlating this data with subsequent bot sessions.

To put it simply, ordinary links just “open the door”, while diversion links are the “access control system” - it records the coming of each visitor, so that every Bot conversation carries attribution information. For teams that use TGStaff as a customer service platform, this means that you can accurately track the traffic source of each Bot session and achieve a closed loop of advertising attribution and multi-channel traffic drainage.

How to implement ad attribution and traffic tracking through diversion links?

The attribution capability of diversion links is based on a simple jump process:

1. The user clicks the diversion link (such as https://app.tg-staff.com/abc123).
2. The browser loads the intermediate page, and the TGStaff backend captures the following data:
   • Visitor IP address (can be used for geolocation).
   • User-Agent (browser type, operating system, device model).
   • URL parameters (including all UTM parameters and custom parameters).
3. The middle page automatically jumps to open the Telegram Bot’s conversation interface (or directly launch the Bot’s Web App).
4. After the user sends the first message, the conversation is automatically associated with the previously captured visitor information.

The process may seem simple, but data traceability is ensured at every step. Compared with ordinary t.me links, diversion links make the original “black box” Bot traffic transparent.

Attribution closed-loop workflow

In order to understand more intuitively, we describe a complete attribution closed loop in words:

• Advertising: You create an ad in the Facebook ad management backend, and the target URL is set to TGStaff diversion link.
• User click: The user clicks on the advertisement on the mobile phone, and the browser opens the middle page of the diversion link.
• Data Capture: The middle page records the user’s IP, device information, and UTM parameters passed by the advertising platform (such as utm_source=facebook, utm_campaign=summer_sale).
• Jump to Bot: Users are directed to your Telegram Bot and trigger a welcome message or auto-reply.
• Agent Acceptance: A user in the Bot initiates a consultation, and TGStaff’s session diversion rules allocate the session to an online agent. Agents can see the user’s source information in the sidebar of the web console.
• Effectiveness Analysis: Operators can use the TGStaff console or third-party tools to view the number of sessions, conversion rates and other indicators grouped by UTM sources to optimize ad delivery strategies.

Every step is trackable, which means you can answer key questions such as “Which ad did this user come from?” and “Which channel has the highest quality of traffic?”

Comparison with ordinary Bot links

Features	Normal t.me/yourbot?start=xxx link	TGStaff offload link
Data capture	Only Bot side can obtain start parameters	Capture IP, User-Agent, all URL parameters
UTM support	Do not automatically capture	Automatically capture utm_source and other standard parameters
Attribution capabilities	None (only manually coded by start> parameters)	Full attribution, can be associated to specific sessions
Middle page	None	Yes, used for data collection and jump
Applicable scenarios	Simple Bot startup	Advertising traffic, multi-channel tracking, marketing attribution
Do you need additional configuration	No	Just create it in the TGStaff console

As you can see from the table above, if the team just needs to let users open bot conversations, a normal link will suffice. But if you want to track the source of each bot launch and optimize your ad budget allocation accordingly, diversion links are the only option.

How to configure UTM parameters to achieve precise channel attribution?

UTM parameters are the most commonly used attribution tool in digital marketing. TGStaff offload links support all standard UTM parameters, including:

• utm_source: source channel (such as facebook, google, twitter).
• utm_medium: medium (such as cpc, social, email).
• utm_campaign: activity name (such as summer_sale, product_launch).
• utm_term: Keyword (used for paid search advertising).
• utm_content: Content identifier (used to distinguish different ad creatives within the same campaign).

The configuration method is very simple: After creating the offload link in the TGStaff console, just append the UTM parameters directly after the link. For example:

https://app.tg-staff.com/abc123?utm_source=facebook&utm_medium=cpc&utm_campaign=summer_sale&utm_content=ad_v1

TGStaff automatically captures these parameters and associates them with the visitor record when the user opens the bot. You can see each user’s source information in the session details in the console.

Best Practice: It is recommended to use a different combination of UTMs for each ad channel, each ad group, and even each ad creative. For example:

• Facebook Ads: utm_source=facebook&utm_campaign=spring_2024&utm_content=carousel_ad
• Google Search Ads: utm_source=google&utm_medium=cpc&utm_term=telegram+bot+customer+service
• Email Marketing: utm_source=newsletter&utm_medium=email&utm_campaign=product_update_v2

In this way, during subsequent analysis, you can accurately know which channel and which ad group brought the most Bot sessions, thereby optimizing the delivery strategy.

Actual combat of traffic diversion links: from ad click to agent acceptance

Now that the theory is over, let’s use a complete scene to connect all functions. Suppose you are the operations manager of a cross-border SaaS company and are driving traffic to the Telegram Bot customer service system.

Advertising traffic scenarios

You create an ad in the Facebook ad management backend, set the target URL to the TGStaff offload link, and append the UTM parameters:

https://app.tg-staff.com/abc123?utm_source=facebook&utm_medium=social&utm_campaign=product_trial&utm_content=video_ad

After a user clicks on the ad, the middle page captures the user’s IP and browser information. After jumping to the Bot, the Bot automatically sends a welcome message: “Thanks for the consultation! Please describe your needs and our customer service will reply as soon as possible.”

At this time, TGStaff’s session offloading rule (configured as “online priority”) will assign the session to an agent who is currently online. After the agent opens the web console, he sees that the source information is displayed on the session details page: “Source: Facebook / Activity: product_trial”. Agents can start responding directly without asking the user “where are you from?”

Social media and email marketing scenarios

The same diversion link can also be used for other channels:

• Twitter Tweets: To embed diversion links in tweets, use utm_source=twitter.
• LinkedIn Post: To share to a company profile or group, use utm_source=linkedin.
• Newsletter: To put a diversion link in the email, use utm_source=newsletter&utm_medium=email.

By comparing the number of sessions, user stay time, conversion rate and other indicators of each channel, you can clearly know which channel has the best traffic drainage effect. For example, if users from LinkedIn usually ask for more complex questions, it means that the quality of users brought by this channel is higher; while users from Facebook ads may be more inclined to quickly understand the product, which is suitable for short-term conversion.

Applicable packages and usage restrictions for diversion links

Offload linking is a feature of TGStaff Standard Edition and above. You can fully experience it during the free trial period (3 days). After the trial expires, you need to upgrade to the standard or professional version to continue using it. Please see the official website package page for specific prices.

Note:

• Link Validity: Diversion links are permanently valid as long as your package is active.
• Short Link Management: On the “Diversion Links” page of the TGStaff console, you can view all created links and copy or delete them at any time.
• Custom domain name: The current version does not support custom short link domain names. All diversion links use the app.tg-staff.com domain name. For most marketing scenarios, this is enough.
• Data retention: Attribution data will be retained along with session records, and the specific retention period depends on the package type.

FAQ

Q: What is the difference between TGStaff diversion links and ordinary t.me links?

Answer: Ordinary t.me links only open the Bot conversation and cannot track the source of the click. TGStaff’s offload link will first capture the visitor’s IP, browser information and URL parameters (including UTM) through an intermediate page to achieve advertising attribution and multi-channel traffic tracking.

Q: What UTM parameters does Magic Link support?

A: All standard UTM parameters are supported, including utm_source, utm_medium, utm_campaign, utm_term, and utm_content. TGStaff will automatically capture these parameters and associate them with visitor records, allowing you to analyze the traffic drainage effects of different channels.

Q: Does the offload link require additional configuration?

Answer: No. When creating a offload link in the TG-Staff console, the system will automatically generate a short link. You only need to copy the link into an advertisement, social media or email, and the attribution jump will be completed after the user clicks.

Q: Can I use offloading links during the free trial period?

Answer: Yes. After registering, you can enjoy a 3-day free trial, during which you can fully experience the offloading link function. After the trial expires, you need to upgrade to the Standard or Professional Edition to continue using it.

Q: Where can I view the data captured by the offload link?

Answer: Each visitor’s IP, browser information and source parameters can be viewed in the session record or user details in the TG-Staff console. Please refer to Official Documentation for specific entry.

Start tracking your Bot traffic flow now

If you are using Telegram Bot for customer service or operations, and want to get rid of the dilemma of “not knowing where users come from”, you might as well try TGStaff’s diversion link. Sign up for a free trial, create your first referral link, and test attribution within your current ads or social media channels.

• Register for trial: https://app.tg-staff.com/
• View full documentation: https://docs.tg-staff.com/
• Contact Customer Service Bot: https://t.me/tgstaff_robot

From ad clicks to Bot activation to agent engagement - make every traffic flow trackable and optimizable.