Qoder Assistant is a group chat Q&A bot that answers only from your knowledge base, privately checks with the colleagues you designate whenever it is unsure, and turns every confirmed answer into new knowledge.
1. What Is Qoder Assistant
Qoder Assistant is your team's group chat Q&A bot. Once it joins a group chat, team members simply ask their questions in the group and Qoder Assistant answers automatically. It has three defining characteristics:
- Grounded answers only: it answers strictly from the knowledge base you provide, and never makes things up
- Asks when unsure: when it runs into a question it is not confident about, it proactively checks with the colleagues you designate
- Gets smarter with use: answers confirmed by colleagues accumulate automatically and are reused directly next time
2. Creation and Configuration
2.1 Creating Qoder Assistant
Open the QoderWake console, click "Create Waker", choose the "Qoder Assistant (Q&A Bot)" template, fill in a name and description, and you are done.
After creation, the detail page displays a configuration guide. Just follow the prompts step by step.
2.2 Connecting to Group Chats
Open the Qoder Assistant detail page, select "IM" in the left sidebar, and go to the IM channel configuration page.
Supported channels:
- DingTalk (Alibaba team accounts support the AliDing bot only)
- Lark (currently under internal security review and not yet available)
- Click the "Configure" button for the channel you want
- Fill in the App ID and App Secret (or choose QR code mode)
-
Click "Add Pairing", select the channel, and fill in the pairing details:
- Conversation information: choose "Direct Message" or "Group Chat" as needed. For direct messages, providing the Open ID is recommended; if no Open ID is provided, a User ID is required; the display name is optional
- Runtime configuration: select the model and working directory as needed; if no working directory is selected, the default IM working directory is used
- Click "Create Pairing", then turn on the channel switch to activate it
Qoder Assistant uses workflow mode by default, with no manual selection required. The Open ID identifies a user within the current application, while the User ID is the account identifier inside your company or organization. Once pairing is complete, messages automatically enter the preset Q&A flow.After connecting, group members just ask questions as usual, with no extra steps required. Multiple channels can be connected at the same time.
2.3 Configuring the Knowledge Base
The knowledge base is the source of evidence for every answer Qoder Assistant gives. Qoder Assistant acquires knowledge by binding knowledge bases available on the platform.
Steps:
- Open the Qoder Assistant detail page, select "Knowledge Base" in the left sidebar, and click "Bind Knowledge Base"
- Choose "Select Existing" to bind a knowledge base already on the platform, or choose "Create and Bind" to create a new one
- Multiple knowledge bases can be bound
Recommendation: first create and upload your team's existing FAQ documents in the Knowledge Base module, then come back here and bind them.
2.4 Asking Colleagues for Help
When Qoder Assistant encounters a question the knowledge base does not cover, it automatically sends a direct message to the colleagues you designate to confirm the answer.
Select "Team Collaboration" in the left sidebar, click "Add Colleague", search by name or employee ID, and fill in the collaboration settings:
- Areas of expertise: for example "reimbursement, attendance"; Qoder Assistant routes questions by matching these areas
- Role: technical owner, business owner, and so on
- Permission checkboxes: enabled, can confirm answers, can be asked for help
2.5 Reply Requirements
Manage Qoder Assistant's reply behavior on the "Settings" page in the left sidebar:
- Reply style: professional and measured / concise and direct / lively and upbeat, chosen to match the tone of the group
- Reply language: follow the user / always Chinese / always English
- Business scope: tell Qoder Assistant which kinds of questions it is responsible for (it declines anything out of scope)
- Sensitive information: define the content types it must never reply with (such as account credentials); when encountered, it directs the user to contact the owner
- Disclaimer: can be enabled for external groups, appending a disclaimer to the end of every reply
3. How It Works
Everything Qoder Assistant does is driven by a preset WakerFlow workflow. When you create a Qoder Assistant, the system initializes this default flow automatically.
Default Flow Logic
Once a group message arrives, WakerFlow makes decisions in the following order:
- Primary decision: determine the message intent, whether it is a legitimate question, noise, out of scope, or an expert reply
-
Task execution:
- Legitimate question, then search the knowledge base, then reply if an answer is found
- No match in the knowledge base, then escalate to an expert request, then send a direct message to the relevant colleague
- Expert reply handling: the colleague confirms the answer, then it is posted back to the original group automatically, then the knowledge is stored
Viewing and Editing the Workflow
Open the Qoder Assistant detail page and select the "Workflow" tab in the left sidebar to see the workflow script:
- Canvas: view the entire flow structure visually and modify nodes by dragging
- Script: edit the JavaScript code directly
- Run history: review how each group message was processed and how long each step took
Tip: if you do not need a custom flow, leave the default as is. The default flow already covers the vast majority of group chat Q&A scenarios.
4. Reviewing Results
Q&A Records
The "Q&A Records" section in the left sidebar presents Qoder Assistant's operating data: total questions, reply rate, help requests, and failures. Filtering by group chat is supported. It makes clear at a glance which kinds of questions go unanswered, so you can top up knowledge exactly where it is needed.

5. FAQ
| Question | Answer |
|---|---|
| Are Qoder Assistant's answers accurate? | Qoder Assistant answers from knowledge base content first and hands off questions it is unsure about to colleagues for confirmation. That said, it is powered by a large language model, so we recommend piloting it with a small group, observing answer quality, and then expanding usage. |
| Can I use it without a technical background? | Yes. The knowledge base only requires uploading documents, and the remaining settings can be completed step by step by following the guide on the home page. |
| Does it support questions asked with images? | It can receive images, but it currently relies mainly on the text within them. Complex interfaces, charts, or questions conveyed by an image alone may be misunderstood, so adding a text description is recommended. |
| Will it interrupt colleagues too often? | Once a given type of question is confirmed, it is captured as knowledge and will not be routed again. Routing rules can be adjusted in the collaboration settings. |
| What should I do if an answer is inaccurate? | Add or correct the relevant content in the knowledge base, or adjust the business scope description under "Settings". |
| How do I review answer quality? | Check "Q&A Records" in the left sidebar, where you can filter question counts, reply rate, help requests, and other metrics by group. |
| I added the bot, but the group chat list is empty. What now? | This usually means DingTalk event subscription was not configured successfully. Delete the current DingTalk channel, run qoderwake channel dingtalk qr-start, authorize by scanning the QR code with DingTalk on your phone, and add the new bot to the group chat. The QR code flow configures event subscription automatically. |
A direct message request failed with HTTP 403 - IpNotInWhiteList. What now? | Open the corresponding application on the DingTalk Open Platform and add the egress IP of the server running QoderWake to the allowlist under "Permission Management / Development Configuration" or "Application Security Settings". |
| My original knowledge base disappeared after an update. Is the data lost? | The knowledge base is still associated with your platform account and no data has been lost. After upgrading to the latest version, simply bind the original knowledge base again. |
| A DingTalk document link returns 404 after being added to the knowledge base. What now? | DingTalk documents are access restricted and cannot be bound and read directly as a knowledge source. Export it to a supported file format and upload that, or convert it into publicly accessible content before importing. |
| Qoder Assistant answered with out-of-scope content or content from another version. What now? | Define the business scope and applicable version explicitly under "Settings", and bind only the knowledge bases for the matching product and version. Clean up or refresh outdated content promptly to reduce irrelevant recall. |
| How do I diagnose an abnormal answer? | Go to "Workflow, then Run History" to review how the message was processed, what the knowledge base recalled, and which tools were called, then adjust the knowledge base or reply settings based on what you find. |