TG-Staff 团队 avatar TG-Staff 团队

TG Split Link Distribution Guide: Generate Independent Attribution Links for Affiliates and Agents to Achieve Precise Settlement

tg-diversion-link distribution tg diversion link attribution link Telegram Bot

TG Diversion Link Distribution Guide: How to Generate Independent Attribution Links for Affiliates and Resellers for Accurate Settlement

When your Telegram Bot business starts expanding through affiliate marketing or reseller models, one of the trickiest issues arises: How to accurately determine which channel each paying user comes from?

Traditional solutions—giving each reseller a unique referral code, requiring users to manually enter it, and reconciling manually at month-end—are not only inefficient but also prone to disputes. If your team uses TG-Staff to manage Bot customer service, its Diversion Link feature perfectly solves the attribution problem for distribution. This article provides a hands-on guide on how to generate independent attribution links for each affiliate or reseller, establishing an automated, precise settlement system.


In the Telegram Bot ecosystem, users typically enter via the Bot’s public username (@username) or deep links (t.me/yourbot?start=xxx). Both methods have clear drawbacks in distribution scenarios.

Three Major Pain Points of Traditional Distribution Attribution

  • Multi-channel Confusion: A reseller shares a link in a WeChat group, another promotes on Twitter. Users clicking both enter the same Bot. You can’t tell which conversion came from which reseller, leading to disputes when settling—either “proportional split” or “first-come-first-served.”
  • Settlement Relies on Manual Reconciliation: Resellers submit Excel tables each month claiming how many customers they brought. You need to manually cross-check registration times and conversation logs in the Bot backend, which is time-consuming and error-prone.
  • Data Lag Hinders Optimization: No real-time view of which channel has higher click-through rates or better conversions, making it impossible to adjust promotion budgets or strategies promptly.

A TG-Staff diversion link is essentially a short URL generated from the TG-Staff official domain (e.g., https://app.tg-staff.com/{code}). When a user clicks this link, the system automatically captures the following information before redirecting to your Telegram Bot:

  • Visitor IP address
  • Browser and device information
  • Custom parameters carried in the URL (e.g., utm_source=agent001)

This means you can generate a unique short link for each reseller. All users entering through that link are automatically tagged with a “source label.” You can view and export this data anytime in the TG-Staff console, and integrate it with your CRM or settlement system for fully automated attribution.


ComparisonRegular Telegram Bot LinkTG-Staff Diversion Link
Domaint.me or Bot custom domainapp.tg-staff.com (official domain)
Tracking AbilityNone (only carries start parameter)Automatically captures IP, device, custom parameters
Attribution TagRequires manual parsing of start parameterBuilt-in channel tag and note field
Data ReportsNoneConsole provides click and conversion statistics
ValidityPermanentNo expiration (within plan validity)

Simply put, a regular link is a “blind box”—you have no idea who clicked it or where they came from; a diversion link is “transparent”—every visitor’s profile and source are recorded.


The following operations are all based on the TG-Staff console (https://app.tg-staff.com/)。请确保你的账号已绑定 Bot and at least have the Standard plan (free trial also works).

Step 1: Create a Project and Customer Service Agents

  1. Log in to the console, go to the “Project Management” module, create or select the Bot project you want to promote.
  2. In “Agent Management,” add customer service agents (Staff). If you operate alone, add at least one agent account and grant it project permissions.
  3. Ensure the “Session Diversion” rule for this project is enabled (default is on). It is recommended to select “Online First” mode, so when a user enters via a reseller link, the system automatically assigns them to an online agent, reducing wait time.
  1. Go to the “Diversion Links” module and click “Create Diversion Link.”
  2. Fill in the following information in the popup:
    • Channel Name: Use the reseller’s nickname or ID, such as Affiliate_Alice or Reseller_Bob_01.
    • Notes: Record the reseller’s promotion method (e.g., “WeChat group/Twitter/email list”) for later analysis.
    • Custom Parameters: Optional but strongly recommended. For example, utm_source=alice&utm_medium=social. These parameters are appended to the short link and automatically recorded when a visitor clicks.
  3. Click generate, and the system will return a short link like https://app.tg-staff.com/abc123.
  • Give the generated short link to the corresponding reseller and inform them: This link is exclusive; do not share it with other resellers.
  • It is recommended to click the link in different browsers or incognito mode to verify it redirects to your Bot correctly and triggers the welcome message or menu.
  • Return to the console’s “Diversion Links” list and check if the link’s “Visit Count” has increased. If it shows 1, tracking is working.

Attribution Logic for Affiliate and Reseller Settlement

With diversion links, attribution becomes simple and quantifiable. Here are two common attribution models and their application in TG-Staff:

  • First-Click Attribution: The user first enters through reseller A’s link. Even if they enter through other channels later, the initial source remains reseller A. Suitable for “acquisition”-oriented settlement models.
  • Last-Click Attribution: Based on the last diversion link the user clicked. Suitable for “conversion promotion” scenarios, such as reseller B sending a link with discount information, and the user clicks and completes a purchase immediately.

Specific Operational Suggestions:

  1. In the console’s “User Profile” module, view the source field (first source/last source) for each user.
  2. Export the user list (CSV format) and integrate user IDs with your payment system or CRM.
  3. During monthly settlement, filter out paying users with “Source = Reseller A’s link” and multiply by the agreed commission rate.

Data Export Tips

In the TG-Staff console, you can view the visitor details of each diversion link, including source, device, and first visit time. It is recommended to export data once a week and sync it with the CRM system to avoid data loss.


Best Practices for Data Tracking and Report Export

To make settlements more transparent and reduce disputes, it is recommended to establish the following data tracking process:

  1. Regularly check split link statistics: Go to the “Split Links” module, where each link displays the total number of clicks. Click into the details to see each visitor’s IP, device, first visit time, and subsequent session records.
  2. Export user profiles: In the “User Profiles” module, filter by time range and export a CSV file containing the “First Source” field. This file can be directly sent to agents for settlement confirmation.
  3. Combine with content moderation (Pro version): If you are concerned that agents may send prohibited content (such as false promises or sensitive words) during promotion, you can enable the “Content Moderation” feature in the Pro version to detect risky words before agents send messages and record trigger logs. This is especially important for maintaining brand image.

Frequently Asked Questions

Q: Can split links track whether a user has completed a paid subscription?
A: Split links record the initial source and behavior data of visitors entering the Bot. If you associate user IDs with your payment system, you can view the user’s overall session records through the User Profiles module to help determine conversions. TG-Staff itself does not directly handle payment callbacks; it is recommended to integrate with third-party payment platforms.

Q: Can an agent use multiple split links?
A: Yes. You can generate multiple split links for the same agent for different promotion channels (e.g., social media, email lists, blogs) and distinguish them by channel name or custom parameters.

Q: Do split links have an expiration date or click limit?
A: Split links generated with Standard and higher plans have no expiration date or click limit and can be used long-term. However, it is recommended to regularly check the link status to ensure the Bot is online.

Q: How can I protect split links from being maliciously copied by others?
A: Split links are generated based on the TG-Staff domain, and each link is bound to a unique channel label. If abnormal sources are detected, you can view visitor IP and device information in the console to quickly identify the issue and replace the link.

Q: Can I create split links during the free trial?
A: The free trial includes Standard features, allowing you to create split links. After the trial expires, you need to subscribe to Standard or Pro to continue using them.


Conclusion and Next Steps

With TG-Staff split links, you can say goodbye to the traditional distribution model of “manual reconciliation, disputes, and data blind spots” and establish independent, automated, and verifiable attribution links for each affiliate or agent. This not only saves settlement time but also provides a foundation for scaling your distribution system—whether you have 5 or 500 agents, every commission can be clearly traced.

Sign up for a free trial now, create your first TG split link for your distribution system, and experience the efficiency gains from accurate attribution.

Get Started Now

Create independent TG split links for your distribution system to achieve precise attribution and automated settlement. Register for Free Trial | View Docs | Contact @tgstaff_robot