TG-Staff 团队 avatar TG-Staff 团队

TG-Staff Referral Program: Partner Attribution and Efficient Handoff via Telegram Bot + Split Links

tg-staff Recommended partner Telegram Bot Attribution

TG-Staff Partner Program: Implementing Partner Attribution and Efficient Handling with Telegram Bot + Split Links

In B2B SaaS, Web3, and cross-border businesses, partner programs are one of the core channels for low-cost customer acquisition. However, many teams encounter several common issues during implementation: traffic from partners cannot be accurately attributed, users are lost due to delayed responses after inquiries, and manual commission tracking is time-consuming and error-prone. If you are using or planning to build a Telegram Bot as a customer service entry point, TG-Staff’s Partner Program feature—combined with split links and Bot automation—can help you solve these problems.

This article will take a practical approach to detail how to deploy partner-specific traffic generation links using TG-Staff, achieving a closed loop from referral, handling, attribution, to conversion.


Why Do Partner Programs Need Dedicated Bots and Attribution Capabilities?

Traditional partner programs typically rely on the following methods:

  • Manual tracking: Partners submit user information via screenshots or spreadsheets, and operations staff manually verify, which is inefficient and prone to omissions.
  • Generic links: All partners use the same link, making it impossible to distinguish sources, and attribution relies on users proactively reporting.
  • No instant handling: Users click the link and are directly redirected to a Bot or webpage without real-time human agent response, leading to significant potential customer loss during peak inquiry times.

These issues are particularly prominent in cross-border, Web3, and global business scenarios. For example, a DeFi project collaborates with multiple KOLs for promotion. Users brought by each KOL need to enter through a dedicated portal, and it must be clearly recorded which users come from which partner for commission settlement. Relying solely on manual invitation code entry would significantly reduce conversion rates.

The core solution is to generate a dedicated, trackable traffic generation link for each partner, combined with Bot auto-replies and human agent handling, ensuring every referral is recorded, handled, and converted.


TG-Staff Partner Program Core Workflow: Referral → Handling → Attribution

TG-Staff’s partner program is based on three core components: split links, Bot automation flows, and user profiles with attribution data. The entire workflow is as follows:

  1. Partner receives a dedicated split link → publishes it in communities, official website, or ad channels.
  2. Visitor clicks the link → redirected to your Telegram Bot.
  3. Bot automatically sends welcome messages, menus, or collects information.
  4. If there is an inquiry → assigned to an online agent via session routing rules.
  5. All visitor data (IP, browser info, URL parameters) is automatically recorded in the user profile.

In the TG-Staff console, you can generate a unique split link for each partner. This link is a short URL under the TG-Staff official domain (e.g., https://app.tg-staff.com/{code}), and each link can carry custom URL parameters to identify the partner.

Key Actions:

  • Create a new link in the “Split Links” module, setting a link name (e.g., “KOL_A”).
  • Embed the partner ID in the URL parameters, e.g., ?partner=kol_a.
  • The system automatically generates a short link, which can be directly copied and given to the partner.

The generated link can be deployed in the following scenarios:

  • Partner’s Telegram channel or group
  • Social media posts (Twitter, LinkedIn, Facebook)
  • Dedicated landing page on the official website
  • Ad campaigns (Google Ads, Facebook Ads)

Step 2: Visitor Click → Bot Auto-Response → Agent Handling

When a visitor clicks the split link, they are automatically redirected to your Telegram Bot. At this point, TG-Staff’s visual command flow triggers preset auto-replies:

  • Welcome message (e.g., “Welcome to XYZ Project, I am your assistant”)
  • Multi-step menu (e.g., “Select inquiry type: 1. Product Introduction 2. Partnership Inquiry 3. Technical Support”)
  • Information collection (e.g., collect user email or wallet address)

If the visitor has further inquiries, the session enters the agent queue. TG-Staff supports two types of session routing rules:

Routing RuleDescriptionUse Case
Round RobinAssigns to agents with permissions in sequenceFew agents, balanced workload
Online FirstPrioritizes agents currently onlinePeak inquiries, need fast response

You can also limit agent scope in project settings, e.g., only allow specific agent groups to handle sessions from partner channels, ensuring professionalism.

Step 3: Automatic Attribution Data Capture and Statistics

This is the core value of the partner program. Before redirecting, the split link automatically captures the following data:

  • Visitor IP (for geographic analysis)
  • Browser User-Agent (device and OS information)
  • URL parameters (including partner identifier, e.g., partner=kol_a)

This data is written into TG-Staff’s user profile. When the user later interacts with the Bot or agent, all behaviors are linked to this attribution record. The Pro version also provides more detailed statistics, making it easy to view conversion funnels by partner dimension.

Attribution Configuration Reminder

When creating a split link, ensure you embed the partner ID in the URL parameters (e.g., ?partner=xxx). TG-Staff automatically captures this parameter and records it in the user profile, requiring no additional development.


If you have already registered for TG-Staff (free trial for 3 days), here are the specific configuration steps:

  1. Create a Project: Create a new Bot project in the console and bind your Telegram Bot Token.
  2. Configure Bot Profile: Edit the avatar, name, and description in the “Bot Profile” section without needing to jump to BotFather.
  3. Set Up Auto-Replies: Go to the “Visual Command Flow” and drag and drop to configure welcome messages, menu options, and auto-reply logic.
  4. Generate Diversion Links: Create links in the “Diversion Links” module and set partner identification parameters.
  5. Configure Session Diversion: In “Project Settings”, select the diversion rule (round-robin or online priority) and specify the customer service scope.
  6. Invite Agents: Add team members in “Agent Management”. Each agent has a separate account to log into the Web portal and handle users.
  7. Test the Link: Open the diversion link in a browser to confirm it redirects to the Bot and triggers auto-replies.

Real-World Scenario: How a Web3 Project Boosts Partner Conversions with a Referral Program

Imagine you run a Web3 exchange and collaborate with 5 KOLs for promotion. Previously, you gave each KOL a generic Bot link. Users had to manually enter an invite code upon entry, and KOL commission settlement relied on your weekly manual data export. The problems were obvious:

  • Users often forgot to enter the invite code, leading to attribution failures.
  • During peak consultation times, users waited long, with a churn rate as high as 40%.
  • Manual statistics were time-consuming, requiring 2 days of manual reconciliation each month.

After using the TG-Staff referral program, you generated a unique diversion link for each KOL (e.g., https://app.tg-staff.com/abc?partner=k ol_a). KOLs share the link on their communities and Twitter. When users click:

  • They automatically redirect to the Bot and see a welcome message: “Welcome to XYZ Exchange, recommended by KOL_A.”
  • If they need help, they click the “Contact Support” menu, and the session is immediately assigned to an online agent.
  • Agents see user profiles in the Web portal, including a “Source: KOL_A” tag.

Results: Attribution accuracy increased from 70% to 100%, user wait time reduced to under 30 seconds, and conversion rate improved by about 25%. When settling commissions monthly, simply export user profile data from TG-Staff and filter by partner.


Advanced Referral Program: Combining Content Moderation and User Profiling to Optimize Partnership Quality

For Web3, exchange, NFT, and similar projects, partner traffic may bring high-risk inquiries (e.g., users asking how to deposit/withdraw, or agents mistakenly sending payment addresses). TG-Staff Professional Edition offers Content Moderation (Internal Control Management), which can play a role in partner referral sessions:

  • Risk Word Monitoring: Configure wallet address-related keywords (e.g., TRC20/ERC20 address fragments). Before an agent sends a message, the system automatically detects and triggers a pop-up for double confirmation or blocks sending if a match is found.
  • Audit Logs: All triggered records (agent, session, time, risk word) are traceable for compliance review.
  • User Profile Analysis: Use the statistics feature in the Professional Edition to analyze user quality from different partner channels (e.g., average session duration, conversion rate, complaint rate) and optimize referral strategies.

Advanced Tips

For Web3 projects requiring compliance and internal controls, specific wallet addresses can be added to risk phrases to prevent agents from mistakenly or improperly sending payment information during partner referral conversations. This not only protects users but also reduces compliance risks for partners.


Frequently Asked Questions

Q: Where can I view the attribution data captured by the referral link?
A: In the TG-Staff console under “User Profile”, you can see the IP, browser information, and URL parameters (including partner identifiers) captured when each user enters via a referral link. The Pro version also provides more detailed statistics, with the ability to filter by partner.

Q: Is there an expiration date for a partner’s exclusive referral link?
A: Referral links are valid indefinitely by default, unless manually deleted or deactivated in the console. It is recommended that partners use the same link long-term for consistent attribution. If a temporary campaign link is needed, you can add a note with the campaign date in the link name.

Q: Can a project have multiple referral links for different partners?
A: Yes. TG-Staff supports generating multiple referral links (Standard plan and above) for the same Bot project, each with different parameters to distinguish partners. You can manage them in bulk in the console and view click statistics for each link.

Q: If a partner’s visitor arrives outside business hours, can the Bot reply automatically?
A: Yes. TG-Staff’s visual command flow allows you to set up automatic replies for non-business hours (e.g., “Thank you for your inquiry. Our agents will reply during business hours. Please leave your question here.”) to ensure a good visitor experience. You can also configure automatic collection of user information for priority handling when agents come online.

Q: Does the TG-Staff referral program support Stripe and USDT payments?
A: TG-Staff itself supports Stripe and USDT (TRC20) for subscription payments. However, commission settlements within the referral program are handled by you—TG-Staff provides attribution data, and you can calculate commissions externally (e.g., in Excel or a custom backend) based on that data.


Summary and Next Steps

TG-Staff’s Partner Program, through referral links + Bot automation + user profiles, offers a complete solution for partner traffic generation and attribution. It solves three major pain points of traditional referral programs: inaccurate attribution, untimely follow-up, and untraceable data. Whether you’re running a Web3 project, a SaaS business targeting global markets, or a cross-border community, this workflow can be implemented directly.

If you’re looking for a tool that can manage Telegram Bot customer service, partner traffic, and attribution data all in one, start with a free trial:

The core value of the TG-Staff Partner Program is that every partner referral can be recorded, followed up, and converted.