TG Diversion Link Complete Guide: Features, Plan Requirements, and Landing Page Configuration FAQ

If you use Telegram Bot for customer service or community management, you must have encountered this scenario: users enter your Bot via ads, social media posts, or email links, but you cannot determine which channel they came from, nor track ad conversion performance. TG Diversion Link is designed to solve this problem—it is an official short link with tracking capabilities that helps you with ad attribution, multi-channel traffic routing, and user source analysis.

This article uses an FAQ-style structure to systematically explain what a diversion link is, its differences from regular Bot links, plan requirements, configuration methods, and how to combine it with traffic diversion to build a complete ad conversion chain. It is aimed at teams using Telegram Bot for customer service, especially those in overseas markets, Web3, and B2B SaaS operations.

---

What is a TG Diversion Link?

A diversion link (also known as a magic link) is a special short link provided by TG-Staff, formatted as:

https://app.tg-staff.com/{code}

When a visitor clicks this link, the system automatically redirects to your designated Telegram Bot, and during the redirect, it captures the visitor’s IP address, browser information (User-Agent), operating system type, and all URL parameters carried in the link (such as utm_source, utm_campaign, or custom parameters).

It has two core uses:

• Ad attribution: Determine which ad platform or campaign the user came from, to evaluate the customer acquisition effectiveness of each channel.
• Multi-channel tracking: Route traffic from different sources (social media, email, website, offline QR codes) through the diversion link into the Bot, enabling granular analysis of user sources.

In simple terms: Diversion link = short link + visitor information capture + redirect to Telegram Bot, all in one.

---

What is the difference between a diversion link and a regular Bot link?

Limitations of regular Bot links

Most Telegram Bots use links in the format:

https://t.me/your_bot?start=xxx

This type of link has obvious limitations:

• Cannot track visitor IP or browser information.
• Even if start parameters are included, they can only be read by the Bot’s /start command and cannot be automatically attributed to ad channels.
• Cannot capture user geographic location, device type, etc., before redirect.

Core advantage of diversion links: Visitor information capture

TG-Staff diversion links achieve information capture through an intermediate redirect page, with the following flow:

1. Visitor clicks https://app.tg-staff.com/{code}.
2. The system records the visitor’s IP, User-Agent, source URL, UTM parameters, etc., on the redirect page.
3. Automatically redirects to https://t.me/your_bot?start=xxx.
4. Once the user enters the Bot, TG-Staff associates the captured data with the user profile.

Comparison table:

Feature	Regular Bot Link	TG-Staff Diversion Link
Redirect target	Direct to Telegram Bot	Intermediary page captures info then redirects
Captures IP/browser info	No	Yes
Captures UTM parameters	Only start parameter	Supports all URL parameters
Ad attribution capability	None	Strong
Extra configuration needed	No	Needs to be created in console

---

Which plans can use diversion links? How to activate?

Diversion links are available in Standard plan and above, including:

• Standard (approx. $8.99/month)
• Pro (approx. $16.99/month)
• During the free trial, Standard features (including diversion links) are available

Setup Steps

1. Log in to the TG-Staff Console.
2. Navigate to “Project Settings” → “Routing Links” page.
3. Click “Create Routing Link” and select the Bot project to bind.
4. The system automatically generates a {code} short link, which can be copied and used.
5. (Optional) Append UTM parameters to the link, for example: https://app.tg-staff.com/abc123?utm_source=facebook&utm_campaign=summer_sale.

The generated routing link can be directly used in ad campaigns, social media posts, email signatures, and more.

---

How Do Routing Links Enable Ad Attribution and Traffic Tracking?

What Parameters Can Be Tracked?

When a user clicks a routing link, the system captures the following information:

• IP Address: Can resolve approximate geographic location (country/city).
• Browser Information: User-Agent includes browser type, version, and operating system.
• URL Parameters: Supports all standard UTM parameters and any custom parameters (e.g., affiliate_id, source).

The captured data is associated with the user’s profile. You can view each user’s source channel, visit time, device type, and more in the TG-Staff Console. This is crucial for analyzing ad ROI—you can see which channels bring the most users and which campaigns have higher conversion rates.

How to Integrate with Bot Auto-Replies and Human Agents?

Routing links are just tracking tools; they need to work with Conversation Routing to form a complete ad traffic pipeline:

1. Ad Campaigns: Run ads on Facebook, Google Ads, Twitter, etc., using routing links.
2. Auto-Replies: After users enter the Bot, TG-Staff’s visual command flow (drag-and-drop editor) can automatically send welcome messages, menus, or guides.
3. Human Handoff: When users need human service, conversation routing rules (round-robin or online priority) assign them to available agents.
4. Attribution Analysis: Agents can see the user’s source channel in the chat interface for follow-ups or sales strategy adjustments.

Full Pipeline:

广告/社媒 → 分流链接（捕获信息） → Bot 自动回复 → 人工坐席（附带来源数据）

---

Common Routing Link Configuration Issues and Troubleshooting

Link Not Working / Redirection Errors

• Check Bot Status: The Bot bound to the routing link must be online in the TG-Staff Console. If the Bot is stopped or deleted, the link will fail.
• Check Project Binding: The routing link must be associated with a specific Bot project; ensure the project is not deleted or modified.
• Check Link Format: Confirm the link has no typos; the {code} part must match the creation.

Parameters Not Captured

• Confirm Parameter Format: UTM parameters must use standard format, e.g., ?utm_source=xxx&utm_campaign=yyy, avoid # or Chinese characters.
• Confirm User Completion: If the user clicks the link but does not actually enter the Telegram Bot (e.g., blocked by browser or manually closed), the system cannot capture information.

Slow Redirection

• Routing links pass through an intermediate page, typically taking 1–2 seconds. Slower user networks may cause delays. It’s recommended to state “Auto-redirect to Telegram after clicking” in ad copy.

---

FAQ

Q: Is the Diversion Link a free feature?
A: No. The Diversion Link feature is part of the Standard plan and above. During the free trial, you can use all features of the Standard plan, so you can experience the Diversion Link during the trial. After the trial expires, you need to subscribe to the Standard plan (approximately $8.99/month) or the Pro plan to continue using it.

Q: Are Diversion Link and Conversation Routing the same thing?
A: No. Diversion Link is a short link tool used to capture visitor information, focusing on ad attribution and multi-channel tracking. Conversation Routing is a set of rules for conversation distribution, determining which agent handles a user after they enter the Bot. Used together, they form a complete chain of ad traffic → user handling.

Q: What user information can the Diversion Link track?
A: When a visitor clicks the Diversion Link, the system captures their IP address, browser type/version, operating system, and URL parameters carried in the link (such as utm_source, utm_campaign, or custom parameters). This information can be used for subsequent user profiling and ad channel performance evaluation.

Q: What state does the Bot need to be in when creating a Diversion Link?
A: The Diversion Link is bound to a specific Bot project. The Bot must have been connected via the TG-Staff console and be online. If the Bot is stopped or deleted, the Diversion Link will not work properly.

Q: Can the Diversion Link be used in social media ads (e.g., Facebook, Google Ads)?
A: Yes. The Diversion Link is essentially a standard URL short link that can be embedded in ad platforms, social media posts, emails, and other scenarios just like a regular link. By appending UTM parameters to the link, you can also achieve ad channel attribution.

---

Next Steps

• Sign up for a free trial of TG-Staff: https://app.tg-staff.com/
• Check the Diversion Link documentation for detailed configuration: https://docs.tg-staff.com/
• Contact customer service Bot @tgstaff_robot for assistance

If you are using Telegram Bot for customer service or user operations, take 10 minutes to test the Diversion Link—it might be the missing piece of attribution puzzle in your current ad campaigns.