What is a Telegram Diversion Link? A Comprehensive Guide to the Principle and Use of Telegram Magic Links

If you’re using Telegram Bot for customer service or community management, you might be accustomed to tracking user sources through links like t.me/yourbot?start=xxx. However, such links have an obvious drawback: you cannot obtain any visitor information before the user jumps to the Bot—Where is the IP address from? Which advertising channel did the user come through? What browser is being used? This data is lost before the jump.

tg diversion links (also known as magic links / Diversion Links) are designed precisely to solve this problem. They are special short links provided by the TG-Staff platform, formatted as https://app.tg-staff.com/{code}, which automatically capture key visitor information before the user jumps to the Telegram Bot, and associate this data with subsequent customer service conversations. Simply put, they make “who came from where” traceable and attributable.

---

What is a tg Diversion Link? Core Definition of Magic Links

From a functional perspective, a tg diversion link is a jump proxy with data collection capabilities.

The jump process for a regular Telegram Bot link (such as t.me/yourbot?start=xxx) is:

用户点击链接 → 直接打开 Telegram → 进入 Bot 对话

Whereas the jump process for a diversion link is:

用户点击 app.tg-staff.com 短链 → 系统后台采集数据 → 自动跳转至 Telegram Bot

This “data collection” step is the core value of magic links. It allows the operations team to obtain basic data needed for attribution analysis before the user interacts with the Bot, rather than having to guess the user’s source after they send a message.

---

How Do Magic Links Work? The Full Process from Click to Attribution

Step 1: User Clicks the app.tg-staff.com Short Link

The link you embed in ad campaigns, social media posts, or emails is formatted as https://app.tg-staff.com/{code}. This code is a unique identifier generated by TG-Staff for each project, pointing to the Telegram Bot project you configured.

For example, a typical magic link looks like this:

https://app.tg-staff.com/abc123

After clicking, the user first arrives at the TG-Staff official domain server, rather than jumping directly to Telegram.

Step 2: Automatically Collect Visitor Information Before the Jump

Before the user is redirected to Telegram, the system collects the following types of data:

• IP Address: Can be used to roughly determine the user’s country/region
• Browser User-Agent: Identifies the device type, operating system, and browser version the user is using
• Referrer URL: The page from which the user clicked the link
• UTM Parameters: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Any Custom URL Parameters: You can append your own parameters to the link, and the system will capture them as well

Step 3: Redirect to Telegram Bot with Data and Route to Agent

After data collection, the system automatically redirects the user to your Telegram Bot. The user sees the normal Bot welcome screen, completely unaware of the data collection happening behind the scenes.

At the same time, the collected data is linked to the user’s session record. When the user later initiates a conversation and is assigned to an agent, the customer service representative can see the user’s source channel and UTM parameters on the conversation interface. Combined with session routing rules (round-robin or online-first), the system can automatically assign users from different sources to different agents or project groups.

---

Routing Links vs. Normal Telegram Bot Links: Key Differences

Comparison Dimension	Normal Bot Link (t.me/yourbot?start=xxx)	Routing Link (app.tg-staff.com/{code})
Pre-redirect Data Collection	Not supported	Supported (IP, UA, source, UTM, etc.)
Attribution Capability	Manual channel differentiation via start parameter only	Auto-capture multi-channel parameters, supports UTM attribution
Source Tracking	Cannot obtain Referrer info	Can obtain Referrer and source URL
Agent Routing Integration	Requires additional development	Built-in session routing rules, auto-assign agents
Link Readability	Link becomes longer with many parameters	Short link format, clean and manageable
Multi-campaign Management	Requires manual management of different start parameters	Unified management of all routing links in the console

For teams needing granular operations, the value of routing links is that you no longer rely on users manually entering codes or recording sources—the system handles data collection and association for you.

---

When to Use Magic Links?

1. Ad Attribution

You run paid ads on Google Ads, Facebook, or Twitter and want to track which channels drive Bot conversations. Use a unique routing link per ad group with UTM parameters to see conversion data for each channel in the TG-Staff dashboard.

2. Multi-Channel Social Media Referral

Post the same product intro on Twitter, LinkedIn, and WeChat groups, and want to know which channel has the highest click-to-conversion rate? Generate different routing links for each channel, and data is automatically aggregated.

3. Web3 User Referral

Airdrops, community tasks, referral rewards—source tracking is critical. Routing links capture user IP and device info at click time, enabling finer campaign attribution with custom parameters.

4. Independent Tracking for Different Product Lines/Campaigns

A single Bot may serve multiple product lines. Use routing links to generate unique short links per campaign, so agents can instantly see which campaign the user came from, making conversations more targeted.

---

How to Create and Configure Routing Links: Step-by-Step Guide

Prerequisites: Check Your Plan

Routing links are available on Standard Plan and above, and can be tested during the free trial. Register TG-Staff to enjoy a 3-day free trial without binding a payment method.

For plan details, see the official pricing page. The Standard Plan is approximately 8.99/month, and the Professional Plan is approximately16.99/month, with additional discounts for annual billing.

Configuration Steps: Project Settings → Routing Links → Get Short Link

1. Log in to the TG-Staff Console
2. Enter the Bot project you want to configure
3. Find the “Routing Links” module in the left menu
4. Click “Create Routing Link,” and the system will automatically generate a app.tg-staff.com short link
5. Copy the link and add UTM parameters based on your promotional channel
6. Embed the final link in ads, social media, or emails

---

Best Practices and Common Misconceptions for Magic Links

✅ Best Practices

• Create independent links for each campaign: Do not reuse the same distribution link across multiple channels, otherwise attribution data will be mixed up.
• Standardize UTM parameter naming: It is recommended to adopt a consistent naming convention (e.g., utm_source=twitter, utm_medium=social) for easier later analysis.
• Test before launching: Click the link to ensure it redirects to the Bot correctly and that the agent side displays the source information properly.
• Manage link naming: Add notes to each link in the console, indicating the corresponding campaign name and launch date.

❌ Common Misconceptions

• Assuming magic links can track all user behavior: Distribution links only capture data at the moment before redirection; they cannot track subsequent user behavior within the Bot.
• Not configuring session distribution rules, leading to agent confusion: If users from multiple sources flood in simultaneously, it is recommended to set up distribution rules (round-robin or online-first) in advance to avoid agent conflicts.
• Failing to update expired links in time: Although distribution links themselves do not expire, if project configurations change (e.g., Bot association changes), you need to regenerate them.

---

Frequently Asked Questions

Q: What is the difference between a TG distribution link and a regular link?

A: Regular Telegram Bot links (e.g., t.me/yourbot?start=xxx) cannot collect user data before redirection. TG distribution links are app.tg-staff.com short links provided by TG-Staff that automatically capture visitor IP, browser information, source channel, and UTM parameters before redirecting to the Bot, helping operators achieve ad attribution and multi-channel traffic tracking.

Q: Where is the data collected by magic links stored? Can it be exported?

A: Collected data is associated with the user’s session record and stored within the TG-Staff platform. Pro users can view relevant attribution data in the user profile and data statistics modules; standalone report export is not currently supported.

Q: Which UTM parameters are supported by distribution links?

A: Standard UTM parameters (utm_source, utm_medium, utm_campaign, utm_term, utm_content) are supported, as well as any custom URL parameters. All parameters are captured and recorded before the user is redirected.

Q: How many distribution links can be created for one project?

A: There is currently no limit on the number. It is recommended to create separate links for different campaigns or channels for easier attribution analysis. Proper naming management is advised after link generation.

Q: Can distribution links be used during the free trial?

A: Yes. After registering for TG-Staff, you get a 3-day free trial during which you can experience all features of the Standard plan, including distribution links. To continue using after the trial, you need to subscribe to the Standard or Pro plan.

---

Summary and Next Steps

The core value of TG distribution links can be summarized in three words: data attribution, channel tracking, and operational efficiency. They solve the pain point that traditional Telegram Bot links cannot collect user data before redirection, enabling operations teams to achieve precise ad attribution and multi-channel traffic tracking with zero development cost.

If you are using a Telegram Bot for customer service or community management, we recommend trying to configure your first distribution link now:

1. Register for TG-Staff free trial (no payment info required)
2. Go to project settings and create a distribution link
3. Launch the link on a channel and observe user source data
4. For help, contact @tgstaff_robot or check the official documentation

Start with the first set of attribution data and make the traffic results from each channel clearly visible.