TG-Staff 团队 avatar TG-Staff 团队

Step-by-Step Guide to Building a Telegram Customer Service Knowledge Base: Bot Command Flow + Agent Quick Replies + Document Links

Telegram Customer Service System Knowledge Base Bot Commands

Step-by-Step Guide to Building a Telegram Customer Service Knowledge Base: Bot Command Flows, Agent Quick Replies, and Document Links

For teams using Telegram Bot for customer service, handling a high volume of repetitive frequently asked questions (FAQ) is a daily reality. Relying solely on human agents to reply to every query not only is inefficient but can also lead to inconsistent response quality due to different communication styles. Building a structured Telegram customer service knowledge base to standardize answers is key to improving efficiency and reducing onboarding time for new agents.

This article focuses on three practical knowledge base formats—Bot command flows, agent quick replies, and external document links—and walks you through starting from scratch to create a deployable, iterable customer service knowledge base. Whether you are a small startup team or a mid-to-large operations team requiring compliance, this guide provides actionable steps and best practices.

Why Does a Telegram Customer Service Team Need a Knowledge Base?

In the Telegram ecosystem, customer service scenarios are often “high-frequency, decentralized, and real-time.” A typical scenario: a user contacts the Bot asking “How do I get a refund?” or “When will my order ship?” Without a knowledge base, agents must type manually or switch between documents to find answers. This leads to three core issues:

  1. Low reply efficiency: The same questions are answered dozens of times daily, wasting agents’ time.
  2. Inconsistent replies: Different agents may provide varying answers, affecting user experience and brand image.
  3. Long onboarding time: New agents need extensive time to learn common questions before working independently.

A structured knowledge base effectively addresses these issues. In a Telegram environment, knowledge bases typically exist in three forms:

  • Bot command flows: Use a visual flow editor to turn FAQs into menu-based interactions, allowing users to self-serve answers.
  • Agent quick replies: Pre-store standard responses for high-frequency questions in the web agent interface, enabling one-click insertion during chats.
  • External document links: Host complex or lengthy content (e.g., product manuals, policy documents) on external platforms and send links via Bot messages.

These three forms can be combined, or you can start with one based on team size.

Before diving in, let’s quickly compare the use cases, pros, and cons of each format to help you decide.

FormatUse CaseProsCons
Bot command flowsHigh-frequency, standardizable FAQs (e.g., pricing, shipping, refunds)Self-service, 24/7 availability, no human intervention neededCannot handle complex or personalized questions; requires regular maintenance
Agent quick repliesStandard scripts for agents (e.g., greetings, policy explanations)Ensures reply consistency, speeds up agent typingRequires manual selection by agents; still depends on human involvement
External document linksLong, complex content (e.g., product manuals, API docs, legal terms)Complete content, easily updatable without modifying Bot flowsUsers must navigate to an external page, potentially breaking the experience

Recommendation: If your team is just starting, prioritize Bot command flows for the top 5–10 most common questions. As the business grows, gradually add agent quick replies and document links.

Step 1: Build a Self-Service FAQ Menu with Bot Command Flows

Using TG-Staff’s visual command flow editor as an example, setting up an FAQ menu takes just a few steps. Before starting, map out the FAQ hierarchy using Excel or a mind map to avoid confusion from too many nodes.

Steps:

  1. Log in to the console: Visit https://app.tg-staff.com/ and enter your Bot project.
  2. Open the command flow editor: In the left menu, find “Command Flows” and click “New Flow.”
  3. Design the welcome message: Drag a “Send Message” node and enter a welcome message, e.g., “Welcome to XX Customer Service! Please choose what you’d like to know:” Add buttons below, such as ”📦 Shipping & Logistics,” ”💰 Refund Policy,” and ”📞 Contact Human Agent.”
  4. Create sub-menus: For each button, create a sub-flow. For example, clicking ”📦 Shipping & Logistics” leads to another “Send Message” node with content: ”- Shipping time: orders ship within 24 hours\n- Track your order: reply with order number\n- FAQ: …” and add a “Back to Main Menu” button.
  5. Set as default flow: Save the flow and set it as the “Default Flow.” This way, any message a user sends to the Bot will first trigger this welcome menu.

Design Suggestions

It is recommended that the process hierarchy does not exceed 3 levels. If there are many FAQs, consider placing common questions in the first two levels and directing complex questions to human agents or external documentation.

After completing the above steps, your bot will have a 7x24 self-service FAQ menu, allowing users to quickly get standard answers without waiting for a human agent.

Step 2: Configure Agent Quick Replies to Boost Human Agent Efficiency

When a user’s issue cannot be resolved through the self-service menu and is transferred to a human agent, Agent Quick Replies come into play. They help agents send standard answers with a single click in real-time chats, eliminating repetitive typing.

Steps:

  1. Enter Quick Reply Management: In the TG-Staff console, navigate to the “Agent” or “Settings” module and find the “Quick Replies” feature.
  2. Create a Template: Click “New Template”, enter an easily searchable title (e.g., “Refund Policy - Standard”), and fill in the complete reply text in the content area. The text supports Markdown format and can include links.
  3. Organize by Category: It is recommended to categorize quick replies by topic (e.g., “Shipping”, “After-sales”, “Product Inquiry”) for quick filtering. If you have more than 20 templates, consider creating category folders.
  4. Use in Chat: When an agent is chatting with a user, click the “Quick Reply” button above the input box or in the sidebar, search or browse templates, click to insert the content into the input box, make minor edits if needed, and send.

Best Practices:

  • Regularly (e.g., weekly) review the most frequently used quick replies by agents, optimize them, and upgrade them to Bot command flows, achieving a transition from manual to self-service.
  • For policy or compliance content (e.g., refund procedures), always use quick reply templates to ensure consistent responses from all agents.

For scenarios requiring detailed explanations (e.g., product manuals, API documentation, full user agreements), it is not suitable to include them directly in Bot messages or quick replies. In such cases, integrating external document links is the best choice.

Steps:

  1. Choose a Document Hosting Platform: Common options include Notion, Feishu, GitHub Pages, Read the Docs, etc. Ensure your document content is up-to-date and access permissions are set correctly.
  2. Embed Links in Bot Flows: In the command flow editor, paste the document link directly into a “Send Message” node. You can also use Markdown to make the link more visually appealing: [点击查看完整版退款政策](https://your-docs-link.com).
  3. Embed Links in Quick Replies: When creating quick reply templates, you can also insert document links. It is recommended to add a brief description before and after the link, e.g., “For detailed information on the refund policy, please refer to our official documentation: [link]”.
  4. Use Split Links to Track Sources: If you want to analyze which document page users came from to the Bot, use TG-Staff’s Split Link feature. Generate a unique short link for each document page (e.g., https://app.tg-staff.com/refund-policy), and when users click it to jump to the Bot, the source information (IP, browser, URL parameters) is captured.

Access Permission Notice

If your external document requires login to view, clearly inform users in the bot reply, for example: “Please log in with your corporate email to view the full document.” Avoid users seeing a login page after clicking the link, which may cause a fragmented experience.

By integrating external documentation, you can keep Bot messages concise while providing a complete path to information.

Step 4: Establish a Knowledge Base Update and Quality Control Mechanism

A knowledge base is not a one-time setup but an asset that requires continuous iteration. An outdated reply can be worse than no reply. Establishing an update and quality control mechanism is key to ensuring the long-term effectiveness of your knowledge base.

Use Content Moderation to Avoid Sending Incorrect Information

In TG-Staff Pro, the Content Moderation (Internal Control) feature helps you monitor agent replies and prevent the sending of outdated or incorrect information. For example, when product prices or refund policies are updated, old reply templates that haven’t been deleted might still be used by agents.

Configuration Method:

  1. In the console’s “Content Moderation,” create a new risk phrase group.
  2. Add key information from the old version (e.g., old prices, old contact details) as risk words.
  3. Set the rule to “Popup for confirmation on hit” or “Block sending.”
  4. When an agent attempts to send a reply containing the old information, the system will intercept and prompt. The agent must confirm or modify before sending.

This feature is especially useful for teams in Web3, exchanges, or NFTs that require compliance and internal controls. It can be used to monitor agent messages for incorrect wallet addresses or outdated contract information.

Regularly Review and Iterate the Knowledge Base

We recommend conducting a knowledge base review weekly or bi-weekly. The review can be based on:

  • User Profiles and Statistics: TG-Staff Pro provides user profiling and statistics, allowing you to see which questions are frequently asked or which Bot flow nodes have the highest user drop-off rates.
  • Agent Feedback: Agents are most aware of which questions lack standard answers or which quick replies need updating during their daily work.
  • User Message History: Regularly check conversations that were transferred to human agents, and add high-frequency questions to the Bot command flow.

Through the cycle of “analyzing high-frequency questions → updating quick replies or Bot flows → monitoring results,” your Telegram customer service knowledge base will become increasingly robust, ultimately achieving the ideal state where “users self-solve 80% of common issues, and human agents focus on complex scenarios.”

Frequently Asked Questions

Q: After updating content in the knowledge base, will the Bot command flow update automatically?

A: Yes. If you use TG-Staff’s visual command flow editor, after editing and saving the flow, the Bot will take effect immediately without needing to redeploy or restart. Quick reply template updates also take effect in real-time.

Q: Is there a limit on the number of quick reply templates?

A: Currently, the number of quick replies in TG-Staff is not related to your plan. We recommend categorizing them based on actual usage to avoid excessive templates that hinder search efficiency. If you have more than 50 templates, consider creating category folders and using the search function for quick access.

A: Yes. Diversion links can capture source information (IP, browser info, URL parameters) to analyze which documentation page the user entered the Bot from, helping you adjust documentation content and promotional strategies. This is very useful for attribution analysis in ad campaigns and content marketing.

Q: Can I test all knowledge base features during the free trial?

A: During the 3-day free trial, you can use all features of the Standard plan (including Bot command flows, quick replies, session diversion, etc.). Pro features (like content moderation) are not available during the trial, but you can refer to this article to plan your workflow and enable them after upgrading.

Q: Should I build the Bot self-service flow first or configure agent quick replies first?

A: We recommend building the Bot self-service flow first. Creating a self-service menu for the top 5-10 most common questions can immediately reduce 30%-50% of repetitive inquiries for human agents. Then, configure agent quick replies for the remaining human-handled scenarios to ensure consistency and efficiency in human responses.


Act Now: Sign up for TG-Staff’s 3-day free trial and start building your Telegram customer service knowledge base: https://app.tg-staff.com/

Read official documentation to learn more about the command flow editor: https://docs.tg-staff.com/

Having issues? Contact our 24/7 online customer service Bot: https://t.me/tgstaff_robot