TG-Staff Diversion Link (Magic Link) Configuration Guide: Complete Steps for Creation, Copying, and Deployment

In B2B SaaS customer service scenarios, Telegram Bot is often used to handle user inquiries. However, tracking which channel users come from to enter the Bot has always been a pain point—Telegram natively does not provide source attribution, making it difficult for operators to distinguish traffic from ad campaigns, social media promotions, or community shares. TG-Staff’s Diversion Link (Magic Link) is designed to solve this problem. This article will comprehensively break down everything from definition, scenarios, configuration to deployment, explaining how to use the official domain short link https://app.tg-staff.com/{code} for precise traffic attribution and customer service session diversion.

What is a TG-Staff Diversion Link (Magic Link)?

A Diversion Link (also known as a Magic Link) is an official domain short link provided by TG-Staff, formatted as https://app.tg-staff.com/{code}. Its core workflow is:

1. User clicks the short link → 2. The system captures the visitor’s IP address, browser information (User-Agent), and tracking parameters appended to the URL → 3. Automatically redirects to your designated Telegram Bot, and the user directly enters the conversation.

Unlike regular Bot links (such as t.me/YourBot?start=xxx), diversion links intercept and record the visitor’s source information before the redirect. This data is stored in TG-Staff’s user profiles for subsequent analysis. This feature is available only for Standard Plan and above (also accessible during the free trial period).

Why Do You Need Diversion Links? — Use Cases and Core Value

The pain point that diversion links solve is very specific: Telegram Bot itself cannot distinguish which channel a user comes from. You may be running Google Ads, Facebook Ads, KOL promotions, and community sharing links simultaneously, but all users see the same welcome message when they enter the Bot, making it impossible to implement differentiated operations based on different sources. Here are three typical scenarios.

Scenario 1: Ad Attribution

Suppose you run a cross-border SaaS product and advertise simultaneously on Google Ads, Facebook Ads, and Twitter. Using diversion links, you can create a unique short link for each channel (e.g., https://app.tg-staff.com/abc for Google Ads, https://app.tg-staff.com/def for Facebook Ads). When users click the ad and are redirected to the Bot, TG-Staff records the source channel in their user profile. You can then evaluate the conversion performance of each channel and optimize your ad budget allocation.

Scenario 2: Multi-Channel Operation Tracking

In addition to paid ads, you may also run multiple Telegram communities, invite KOLs for promotions, or post on different social media platforms. With diversion links, you can append custom parameters at the end of the URL (e.g., ?source=telegram-group-a, ?source=kol-john) to distinguish user sources from different communities. These parameters are captured with the request and displayed in the “Source” field of the user profile.

Scenario 3: Customer Service Diversion During Peak Hours

Combined with TG-Staff’s session diversion rules (round-robin / online-first), diversion links can also serve as a buffer during peak consultation hours. For example, you can embed a diversion link in your ad copy. When a large number of users flood in simultaneously, the system automatically assigns them to online agents according to the rules, preventing any single agent from being overwhelmed. At the same time, because the source information is recorded, agents can immediately know which campaign the user came from, providing more precise service.

Prerequisites: Plan Confirmation and Permission Preparation

Before you start configuration, ensure the following conditions are met:

• Plan Requirements: Your TG-Staff account must be on the Standard or Pro plan (you can also create and use diversion links during the free trial; after the trial ends, you need to upgrade to the Standard plan ($8.99/month) to continue using them. The annual plan is more cost-effective — see the official plan page).
• Bot Project Integration: You have at least one Telegram Bot project integrated with TG-Staff (i.e., Bot Token binding completed).
• Agent Permissions: The agent account used to configure diversion links must have “Project Management” or “Diversion Links” operation permissions. If unsure, contact the project administrator to adjust permissions in “Agent Management”.

Step-by-Step Guide: Creating and Copying Split Links

Below is the complete configuration process. It is recommended to follow the steps in order.

Step 1: Enter the Split Link Management Page

Log in to the TG-Staff App Console, and find the “Split Links” entry in the left navigation bar or project settings. The layout may vary slightly between versions, but it is usually located under “Project Settings” or “Marketing Tools”. After clicking, you will see a list of created split links (empty for new accounts).

Step 2: Create a New Split Link

Click the “Create Link” button in the top-right corner of the page. In the pop-up form, enter a display name. It is recommended to use a meaningful name, such as “2025 Spring Promotion”, “Google Ads Campaign”, or “KOL Zhang San Promotion”, for easier management later. The system will automatically generate a unique code string (e.g., abc123) and concatenate it into a full short link https://app.tg-staff.com/abc123.

• Tip: The name is for internal management only and will not be displayed externally. code is the unique identifier of the link and cannot be modified after creation, but you can delete and recreate it at any time.
• Optional: Some versions allow you to specify the target Bot project for the link (if you have multiple projects under your account). Select the correct project to ensure proper redirection.

Step 3: Copy the Link and Add Tracking Parameters

After creation, click the “Copy” button next to the link to obtain the full short link. At this point, you can append custom URL parameters to further distinguish traffic sources. It is recommended to use standard UTM parameter format, for example:

https://app.tg-staff.com/abc123?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale

Or simpler custom parameters:

https://app.tg-staff.com/abc123?source=google-ads&campaign=spring

Parameter Format Requirements: Only letters, numbers, underscores (_), and hyphens (-) are supported. If parameter values contain Chinese characters or special symbols (such as spaces, &), please perform URL encoding first (encodeURIComponent), otherwise it may cause redirection failure or attribution data loss.

Deployment Practices: How to Use Redirect Links in Ads & Social Media

Once you have created your redirect link, the next step is deployment. Here are best practices for different channels.

Advertising Platforms

• Google Ads: Enter the redirect link (with UTM parameters) in the “Final URL” field of your campaign. It is recommended to also set a “Tracking Template” to pass additional parameters like Click ID, but ensure the final URL still points to the TG-Staff short link.
• Meta Ads (Facebook/Instagram): Enter the redirect link in the “Website URL” field. Meta will automatically append the fbclid parameter, but you still need to manually add utm_source=facebook to distinguish the source.
• Twitter Ads / LinkedIn Ads: Similar steps—paste the redirect link into the ad destination URL.

Social Media & Community Deployment

• Telegram Groups/Channels: Send the redirect link directly. Since Telegram generates link previews, it is advisable to include a description like “Click the link to chat with customer support.”
• Twitter / LinkedIn Posts: Embed the short link in your posts, or use a Bio Link tool (e.g., Linktree) with the redirect link as one of the targets.
• KOL Promotions: Create a unique redirect link (or use different UTM parameters) for each KOL to facilitate subsequent settlement and performance evaluation.

Viewing Data

When a user enters the Bot via the redirect link, their source information is automatically recorded in the TG-Staff user profile. You can view a single user’s IP address, browser info, and URL parameters (such as utm_source, source) in the “User Management” section. Pro users also get more detailed source analysis reports.

FAQ & Troubleshooting

You may encounter the following issues during configuration. Troubleshoot as follows:

• Link does not redirect: Check if the Bot is online (whether the Bot Token is valid or the project is paused). The redirect link itself does not depend on the Bot being online (it only handles redirection), but if the Bot is banned or the token expires, users will not be able to start a conversation after clicking.
• Parameters not working: Ensure the parameter format is correct (no Chinese characters, no spaces, no special symbols) and properly encoded. Manually open the redirect link in a browser and check the address bar for the full parameters. If they are not displayed, the parameters were not passed successfully.
• Agent does not receive the conversation: Check whether the conversation routing rules are correctly configured. If using “Online First” and all agents are offline, the system falls back to round-robin assignment. If no agent picks up, confirm that agent accounts are online and have the necessary permissions for the project.
• Source field empty in user profile: The information captured by the redirect link is recorded only when the user first clicks. If the user clicks again or enters the Bot through other means, the source field may be overwritten or left blank. It is recommended to create a unique link for each user session.

Common Questions

Q: How long is a redirect link valid? Do I need to renew it manually?
A: A redirect link is valid indefinitely once created, unless you manually delete it in the console or the project is removed. No renewal is needed, but it is recommended to periodically clean up unused links for better management.

Q: Can I create multiple redirect links under one project?
A: Yes. TG-Staff does not limit the number of redirect links per project. You can create multiple links for different campaigns, channels, or time periods for independent tracking.

Q: Do redirect links support HTTPS? Are they safe for user privacy?
A: Yes, all redirect links enforce HTTPS encryption. The captured information (IP, browser, URL parameters) is used only for attribution analysis and not for any other purpose, meeting general privacy protection requirements.

Q: What happens if a user clicks a redirect link to the Bot but no agent is online?
A: The user will enter the Bot’s auto-reply flow normally. If you configured “Online First” routing and no agent is online, the system falls back to round-robin mode. If all agents are offline, the conversation will remain in the queue until an agent comes online to handle it.

Q: Are there differences in redirect link features between the Standard and Pro plans?
A: Core creation and deployment features are the same. The Pro plan additionally supports viewing more detailed source analysis data in user profiles and linking redirect links with internal control rules (e.g., restricting a specific link to be handled only by designated agents).

---

Try TG-Staff Redirect Links Now: Go to app.tg-staff.com to sign up for a free trial and create your first magic link following the steps in this article. For advanced configurations (e.g., UTM parameter management, internal control linking), refer to the official documentation. If you encounter any issues during setup, feel free to contact @tgstaff_robot for real-time support.