Chatbot

1.Chatbot (NLP)
-
The Agent Node within the task flow
-
Document Q&A in the Knowledge Base
1.1 Q&A Knowledge Base


1.2 Task Intent


1.3 Task Flow


-
Dialogue Node: Manages text output to the user, aimed at guiding the user to fill in a specific entity or obtain certain key information. Allowing the bot to recognize different intention.

-
Jump Node: Controls the flow by redirecting the conversation to another specified node, enabling branching paths.

-
Condition Node: Evaluates specific criteria (e.g., variables, user progress) to determine which path or option becomes available, enabling dynamic content.

-
Option Node: Presents the user with multiple choices or responses, allowing them to select and influence the direction of the dialogue.

-
Collection Node: Extract key information from the conversation according to established rules.

-
Operation Node: Perform operational actions at certain process nodes, such as creating a ticket, variable assignment, retrieving document answers, allocating traffic without direct user interaction.

1.4 Guiding Prompt

1.5 Transfer to Agent

-
Automatic Transfer: The system directly assigns an agent to take over the chat once a trigger condition is met.
-
Recommend Transfer: The system suggests transferring to an agent, allowing the customer to choose whether to proceed.


1.6 Intelligent Recommendation

-
FAQ Recommendations: Manually or system-generated FAQs (requires historic data) can be presented as a configurable list within the chat window. The display format and sorting logic are adjustable.
-
Convenient Navigation: Questions are categorized into broad scenarios, allowing users to easily navigate and find content relevant to their specific industry.
-
Quick Process: Pre-configured Task Flows automatically suggest related questions or issues, enabling customers to select their topic or explore other options.
-
Intent Prediction: AI analyzes the chat to predict and suggest the customer's potential intents.
-
Auto-Suggest: As the customer types, the system automatically suggests relevant questions from the FAQ, allowing them to complete their query with a click instead of typing it.
1.7 Chatbot Evaluation

1.8 Multi-language Settings


2.Chatbot (LLM)
2.1 Document Q&A (LLM)
-
In the bot's Knowledge Base, enable the Document Q&A feature.
-
Upload the relevant knowledge documents.
-
The system will process the files (retrieval, chunking, categorizing, and Q&A extraction), which usually takes 5-20 minutes, depending on the size of the document.


2.2 LLM Reply Node

2.3 Agent Node (LLM)
-
Create an Agent Node and click on it.



-
Go to the AI Platform to configure and select the related agent. Navigate to AI Center > AI Agent > Go to Configuration, click default for the Project Space.


-
Create and select the agent you want to use.


-
Go back to the Agent Node, turn on the Streaming Broadcast.


-
If needed, you can create a new variable to assign the agent's response for the following flow.

-
If you need to stream the output, make sure the PA platform stream output is on.
-
When the streaming broadcast is turned on, the judgment will be output after the speech broadcast is completed.
-
Please note that if the Agent broadcasts hang-up and transfers to manual speech, it is best not to configure the speech in the corresponding jump node to avoid repeated broadcasting.
-
Chatbot In Multi-Channels(Social Media & E-Commerce)
3.1 Whatsapp
3.1.1 Accounts Required for WhatsApp Registration
|
Account Name
|
Instructions
|
Priority
|
|---|---|---|
|
Meta Business Account
|
The Meta Business Account is the central platform for managing all Meta business assets, including WhatsApp, Instagram, and Facebook.
|
High
|
|
Facebook Personal Account (Operated by Zhongkejin)
|
To perform embedded registration on behalf of the client, the client must grant administrator privileges of their Meta Business Account to the Facebook personal account operated by Zhongke Jin. Alternatively, the client may provide their Facebook account credentials to manage the Meta Business Account.
|
High
|
|
WABA
|
The WhatsApp Business Account can only be registered through the embedded process provided by our partner Infobip. It is used to manage the WhatsApp Platform and integrate with the Instadesk online customer service system.
|
High
|
|
Sender
|
The Sender (message-sending identity) can only be registered through the embedded process provided by our partner Infobip, applied for within the same workflow as the WABA. It is used for sending WhatsApp messages and integrating with the Instadesk online customer service system.
|
High
|
|
Infobip Official Account (Zhongke Jin)
|
Supplier account used to access the WhatsApp API through an authorized supplier (for use by Zhongkejin personnel only.)
|
High
|
|
Infobip Account Balance (Zhongke Jin)
|
|
High
|
|
Meta Business Account verification
|
|
High
|
|
WABA Green Badge Verification
|
|
Low
|
3.1.2 Integration Process Instructions
-
Create Facebook Business Manager account (Meta Business Account)
|
Application Steps Description
|
Required Documents
|
Priority
|
|---|---|---|
|
Facebook account
|
High
|
|
Facebook Registration: Last name, First name, Phone number/email, password, date of birth, gender
|
High
|
|
|
High
|
-
Create WABA and Sender
-
WABA: WhatsApp Business Account
-
Sender: The sending account under WABA. One sender is bound to one phone number, and one WABA can have multiple Senders bound to it.
-
Application method: Applied with the assistance of ZKJ operations staff.

-
Meta Business Account Verification (Highly Recommended)
|
Account Type
|
Approved Sender with Limited Access
|
Approved Sender
|
|---|---|---|
|
Customizable
|
Business verification not completed
|
Business verification completed
|
|
Message Volume
|
A maximum of 50 template messages can be sent to end users within a 24-hour period
|
The number of template messages you can send to end users depends on your messaging tier.
|
|
Number of Senders (Phone Numbers)
|
Limited
Maximum of 2 unverified WhatsApp senders can be registered
|
Unlimited
More than 2 senders can be registered
|
|
Reply to Incoming Messages
|
Unlimited
|
Unlimited
|
-
Business Verification Methods & Required Documents
|
Application Steps
|
Required Documents
|
|
Priority
|
|---|---|---|---|
|
Verification Entry
Login using your Facebook account, then click the gear icon in the lower left corner to begin the Business Settings
|
Open website: https://business.facebook.com/
|
![]() |
|
|
|
![]() |
|
|
|
![]() ![]() ![]() |
|
|
Select verification method
4 methods are supported: email, phone, SMS, and domain verification. The official recommendation is to use email verification
|
|
![]() |
|
|
Upload Supporting Documents:
Note: If a appears during the submission process requiring identity verification for the Facebook account, please follow the platform's instructions. You can proceed with business verification after the Facebook account verification is passed.
|
|
![]() |
|
|
Obtain and submit the verification code
|
|
![]() ![]() ![]() |
|
|
View result
|
|
|
|
-
WABA Account Verified Badge Verification (Not Mandatory)
-
Contact the BSP to request access, this step ZKJ operation staff will help you with that if needed.
-
Appendix: Document Checklist
| Information | Description |
| Sender Phone Number | A phone number used to identify a WhatsApp Business API (WABA) account. The phone number (sender) must meet the following WhatsApp requirements: Must be in E.164 international format (country code + subscriber number, including area code, without the '+' symbol) and must be internationally reachable. Must remain active during verification to receive SMS or voice calls for 2FA and number ownership. Limitations: Short codes are not allowed. Toll-free numbers in international format are acceptable if they can bypass IVR during verification (if applicable). The number must not have been previously used with the WhatsApp Business API. If the number is already registered on Android, iPhone, or any business app, the associated account must be deleted before it can be registered as a business account. |
| Facebook Account | The Facebook account (Facebook Business Page) associated with the WABA sender. Meta reviews the Facebook account submitted for WABA registration. Common factors Meta considers include: Credibility of the Facebook account: Do the profile picture, cover photo, 'About' section, and general posts align with the business? Influence of the Facebook account: Does it have sufficient followers, user engagement, and general activity? Verified Facebook Business Pages (with a blue checkmark) have the highest success rate for WABA sender approval. |
| Facebook Business Manager ID or Meta Business ID | The Business ID corresponding to your Meta Business Account. Steps to find your Business ID: 1. Go to Business Settings. 2. Click Business Info. 3. Under Business Manager Info, you will see your ID number. |
| Admin Access to Facebook Account | The submitted Facebook account must have admin-level access. Alternatively, a Facebook Business Page can be created during the embedded registration process. |
| Business Name | The legal company name as shown on official documents. |
| Business Phone Number | The company's official phone number. This can be the same as the sender number. |
| Business Email Address | The email address of the company representative registering the WABA. |
| Business Website | The company's official website. The website must demonstrate a connection to your business, Facebook account, and the WABA registration information submitted to Meta. Important: When submitting a website for WABA registration, it is best to include the http:// or https:// protocol. If submitted without a protocol, it will default to https:// (HTTP Secure). E.g., www.infobip.com becomes https://www.infobip.com. If your website uses http:// (HTTP only), you must include the protocol. E.g., http://www.infobip.com, to prevent URL conversion. Later, in your WhatsApp sender profile, you can display up to two (2) websites. |
| Street Address | The company's street address as shown in business documents. |
| City | The city where the business is located, as shown in business documents. |
| State/Region/Province | The state, region, or province (as applicable) where the company is located, consistent with business documents. |
| Country | The country where the company is located, as shown in the business documents. Note: The WhatsApp Business Platform must not be used to send or receive any messages to or from the following countries: Crimea, Cuba, Iran, North Korea, and Syria. |
| Display Name | The name that will be displayed on the WhatsApp sender profile. The display name must not violate WhatsApp Business and Commerce Policies. It must also follow these guidelines: - Must accurately represent your business. - Must align with external branding. - Must have a clear connection to your business. - Must use correct formatting. |
| Business Category | The category selected from the options during WABA registration. |
| Description | The description that will be displayed in your WhatsApp sender profile. It can contain up to 256 characters. |
| About | The 'About' information that will be displayed in your WhatsApp sender profile. It can contain up to 130 characters. |
| Logo | The acceptable logo image size must be 300px by 300px. |
| Information | Example |
| Sender Phone Number | 44786006**** |
| Facebook Account | https://www.facebook.com/infobip/ |
| Facebook Business Manager ID or Meta Business ID | 12345678901**** |
| Admin Access to Facebook Account | Ensure you have administrator-level access to the submitted Facebook Account |
| Business Name | xxx PTE. LTD |
| Business Phone Number | +44 7860 06**** |
| Business Email Address | support@xxx.com |
| Business Website | https://www.xxx.com/ |
| Street Address | Room xx, xxx Street, District xxx, xxxx |
| City | Cyberjaya |
| State/Region/Province | Selangor |
| Country | Malaysia |
| Display Name | xxxxx |
| Business Category | xxxxx |
| Description | xxx's services include omnichannel communication, contact centers, chatbots, customer engagement, and customer data platforms. |
| About | Shaping the future of customer experience through contextual communication. |
| Logo |
3.1.3 Product Capability
-
Online Customer Service
-
Instant Alerts: Customer messages trigger immediate notifications.
-
Intelligent Routing: Automatically assigns conversations to available agents.
-
Immediate Response: Seamless connection for rapid engagement.
-
Multi-Format Support: Reply with text, images, rich media, videos, and more.

-
Supported Message Types:Message TypeReceive SupportSending SupportTextSupportedSupportedImageSupported(jpg、png、jpeg)Supported(jpg、png、jpeg)DocumentSupported(xlsx、xls、world、txt、ppt)Supported(xlsx、xls、world、txt、ppt)Formatted Media & TextSupportedNot SupportedLocationSupportedNot SupportedVideoSupportedSupportedAudioSupportedNot SupportedContactsSupportedNot SupportedEmojisSupportedSupportedCustomized EmojisSupportedSupportedInteractive ListSupportedNot SupportedReplySupportedNot SupportedRead/UnreadSupported
-
Chat Assignment Capability

-
Offline Messages
-
Timely reach of customer messages.
-
Immediate visibility of WhatsApp customer messages for agents as soon as they come online.

-
Message to Live Chat

-
Message to Ticket

-
Online Queue

-
AI Knowledge Base
-
Chatbot


-
Sending Template Messages
-
Analytics Report

3.2 Ebay
3.2.1 Pre-Operations
3.2.2 Integration Process
-
Login to both your Instadesk account and eBay store, ensuring both are opened in the same browser.
-
Then complete the following steps:






3.2.3 Additional Information
-
Click the Disable button in the lower-right corner of the channel card.
-
Then, click the Delete button in the lower-left corner to complete the unbinding process.

-
Name: ebay assignment 1
-
Type: Online Routing
-
Channel: Ebay Channel / ebay channel 1
-
Agent Group: ebay skill group 1
-
Name: ebay assignment 2
-
Type: Online Routing
-
Channel: Ebay Channel / ebay channel 2
-
Agent Group: ebay skill group 2

3.2.4 Product Capabilities
-
Agent Assignment Policy
-
Priority Assignment
-
Queue Priority Policy.

3.2.5 Online Customer Service
-
Offline Messages: When the intelligent assignment rules is set to Agents only or Agents first, and all agents are offline, incoming customer messages are automatically routed to the Offline Messages section in the Workspace. This ensures messages are captured and agents can view them when they go online.
-
Active Chat: When an agent is online, all real-time messages from a single customer are combined into 1 chat and displayed in the In Progress section of the Workspace.
-
Multiple Active Chats: When an online agent receives messages from multiple customers simultaneously, they can use the Online Queue feature to manage and prioritize these conversations efficiently.



-
Supported Message Types
|
Message Type
|
Instadesk supports both receiving and sending messages
|
|
Text
|
Supported
|
|
Pictures
|
Supported (jpg, png, jpeg)
|
|
Emojis
|
Supported
|

-
Request Order Information

-
Multi-language Translation
-
Click the Translate button in the dialog box. The entered text is automatically translated into the selected language.
-
Click Edit to automatically populate the translated text into the input field for sending.


-
AI Knowledge Base


-
Connection Message
-
Queue Position & Entry Notification
-
Queue Overflow & Timeout Reassurance
-
Queue End Notification
-
Agent Response Timeout Reassurance
-
Customer Response Timeout Reminder
-
No Agents Online Auto-Reply
-
Off-Hours Auto-Reply
-
Blacklist Reply

3.3 Facebook Messenger
-
The customer creates a Facebook account and s successful login.
-
Confirm Facebook authorization.
-
Contact the Product Manager (@黄思睿 ) to add the customer domain (domain.instadesk.com) to ZKJ’s Facebook Developer Console.

-
The customer logs into tenant account, Navigate to Configuration Management → Channel Management → Facebook → click "➕" to add channel.

-
Enter channel name, language, and remarks → Next → “Bind Facebook Page”.

-
In the pop-up, log in to Facebook and select the Facebook Page to bind (create one if none exists) → authorization.



3.4 Instagram
-
Customer creates an Instagram account and switches to a Professional Account.


-
Log in to Facebook, on the Facebook Page, link the Instagram account. Navigate to Facebook Page → Settings → Linked Accounts → Instagram.

-
The customer logs into tenant account, Navigate to Configuration Management → Channel Management → Instagram → click "➕" to add channel.

-
Enter channel name, language, remarks → Next → “Bind Facebook Page”.

-
After Facebook login, select the Facebook Page to be bound (if no Page has been created, please create one), and the authorization.


3.5 Line
-
Customer registers a personal or official Line account, creates a Developer Account (login via LINE Business ID).

-
Create a Line Provider.

-
Create a Messaging API channel, and record the Channel ID, Channel Secret, and Channel Access Token for the Messaging API channel.


-
The customer logs into tenant account, Navigate to Configuration Management → Channel Management → LINE → click "➕" to add channel.

-
Enter channel name, language, remarks → Next → input Channel ID / Secret / Access Token → Next → obtain Webhook URL.

-
Return to the LINE Developers Platform, select the application that needs to be configured, open the Messaging API settings page, and proceed with the Webhook URL configuration.

-
Open the LINE Official Account management platform, go to the account details page, click on Settings → Response settings, and configure the response mode for the channel as shown in the diagram below.



3.6 Telegram
-
To add a Telegram channel in Channel Management, you must obtain the Bot Token from Telegram Bot backend.

3.7 Amazon
-
To add an Amazon channel, Navigate to Configuration Management > Channel Management, you need to configure the store email and the corresponding authorized site within the channel settings.

-
As shown in the figure below, after clicking "Authorize," you will be redirected to the Amazon website, where you need to log in to your Amazon account and the authorization.

-
Enable the sidebar display permission for Amazon channel orders in Role Permissions, as shown in the image below.

-
After successful connection, Amazon messages will display order information on the right panel.

3.8 Shopify
3.8.1 Setup
-
Search for the Instadesk app in the Shopify App Store.

-
Install the Instadesk app.

-
Redirect to the integration page, manually enter the B-side subdomain prefix, and submit.


-
You will be redirected to the Instadesk B-side login page. Enter your account and password, then submit.

-
If you have previously logged in and the short-term cookie has not expired, the system will directly redirect you to the Shopify channel creation page (see Step 5).
-
If the short-term cookie has expired, you will be redirected to the B-side login page again (see Step 4).
-
Redirect to the Shopify channel creation page.

-
Automatically binds the Shopify store address without manual entry.

-
Shopify channel binding completed.

-
Open the pre-chat form.

-
Adjust Intelligent Conversation Routing: Change the routing source to Shopify Channel to start receiving chats.

3.8.2 Configuration
-
Log in to the Shopify store admin panel.

-
Navigate to: Online Store → Themes

-
Customize the theme currently in use — click Customize.

-
In the left panel, switch to App embeds, enable Online Customer Service, and click Save.

-
After saving the theme, refresh the storefront page. The online customer service entry will appear at the bottom-right corner of the store.

-
Customers initiate an online chat from the bottom-right corner of the store. To retrieve customer identity and order information on the B-side, the system must first collect the customer’s email or phone number (e.g., 13292214214) through the pre-chat form.


-
If the pre-chat form collects the customer’s email or phone number, the system can retrieve customer profile and order information from Shopify via API. If the pre-chat form is not enabled, this information cannot be retrieved.

-
For pre-sales scenarios, agents can search the product list to respond to customer inquiries accordingly.

-
The system supports sending orders or products as cards to C-end customers. Product cards support click-through to the product detail page.











