Build an AI chatbot easily with Zia Agent

Updated: Nov 8
AI has advanced quickly in recent years and keeps getting more useful for everyday work. Yet in Optimus's experience, very few companies use an AI chatbot, even though setting one up is now fairly easy.
Below, Optimus shows a simple, fast way to set up an AI chatbot with three tools:
Zia Agent: where you build the chatbot and store its knowledge base.
Zoho SalesIQ: an omnichannel chat tool that gives customers the chat window.
Zoho Sites: a sample website to embed the chat window.
The example in this post is a fictional furniture company called Oakline Furniture.
I. WHAT IS ZIA AGENT
Zia Agent is Zoho's platform for building AI agents. An agent has four parts:
Instructions: its role, how it addresses customers, and what it may and may not do.
Knowledge base: the documents the agent looks things up in, such as price lists, policies and FAQs.
Tools: actions the agent can take in Zoho apps, for example transferring a chat session to a staff member.
Model: the AI model that writes the answers, provided by Zoho or by OpenAI, Anthropic or Google.
You don't have to draw every conversation branch as you would for a scripted chatbot.
II. HOW THE PARTS FIT TOGETHER
Website (Zoho Sites) → chat window (Zoho SalesIQ) → Zia Agent → a sales consultant when needed.
The agent joins SalesIQ as a digital employee and takes chats like a human chat operator. When a customer wants to order or the agent can't answer, the chat session moves to a staff member. The website doesn't have to be Zoho Sites: the SalesIQ code snippet works on WordPress, Wix or a custom-built site. Beyond the website, SalesIQ also connects to Facebook Messenger, WhatsApp, Instagram, Telegram, LINE and Zalo, so the chatbot can advise customers automatically when they message the business page on these channels.
III. 5 STEPS TO SET UP THE CHATBOT
Step 1: Create the agent and knowledge base
In Zia Agents, go to Agent Studio › Create From Scratch and fill in:
Agent Name, Description, Role: the name and role, for example "Oakline Sales Assistant".
Model: choose Qwen 3.5 122B MoE, provided by Zoho. Add document lookup rules to the Agent Instruction (see the FAQ at the end).
Agent Instruction: keep it short and grouped: how to answer (in English, friendly and polite, at most about 100 words, one question per turn), scope (use only information in the documents, quote prices and order totals by the rules in the documents, never guess a price), when to hand over to staff (orders, showroom appointments, cases where the documents have no pricing rule), and what not to do (promise offers that are not in the documents).

Then go to Knowledge Base › Upload Files to upload price lists, delivery and warranty policies (.pdf, .txt, .md, .docx, or from WorkDrive, Zoho Learn or a web page). Wait until the documents finish processing before adding them to the agent.
Step 2: Add a SalesIQ tool
An agent running in SalesIQ needs at least one SalesIQ tool. Use the tool that transfers the chat session to a staff member (salesiq_transferConversation). In Set Parameters, choose a source for each parameter:
portalid: a fixed value, the SalesIQ portal name.
id (the chat session ID): let the Model fill it in.
department_id: a fixed value, the department that receives chats.

Leave no parameter on On-Trigger: an agent in SalesIQ isn't run by a trigger, so such a parameter would get no value.
Step 3: Test before going live
Click Test Agent and ask like a real customer: ask for prices, ask for a product you don't sell, push for a discount, go off topic. Asked the price of a product not in the documents, the agent must say it has no information and hand over to staff, never make up a number. Also test when no staff member is on duty: the agent must promise that someone will get back to the customer, not leave them waiting in the chat window. After each turn, open the Observability tab to see which documents the agent used, which tools it called, how long it took and how many tokens it spent.
Step 4: Add the agent to SalesIQ
Choose Deploy › Deploy as digital employee, then pick the SalesIQ portal, grant access, choose a role (Associate is enough) and a department, and give the agent a name and email. The agent appears in SalesIQ's operator list and takes chats before regular chatbots.
Use a name without diacritics (such as "Oakline Assistant"): in Optimus's test, a Vietnamese name with diacritics made the deploy step fail.
Step 5: Embed the chat window on the website
In SalesIQ, go to Settings › Brands › Website to get the chat window code. There you can also choose the language, edit the greeting and turn off items you don't need (Call, Articles, FAQs). In Zoho Sites, paste the code into Configurations › Code › Footer Code and publish.

The result: the agent looks up the documents, suggests products within the budget, works out the order total with the discount, states the installment terms and then asks whether the customer wants to be connected to staff to place the order.

IV. COSTS AND WAYS TO CONNECT A MODEL
Zia Agent charges nothing for the agent itself; the cost is in the model. SalesIQ is billed separately under its own plans. Per Zoho's price list at the time of writing:
Connection | Model | Billing |
Zoho Key System (ZKS), Zoho-hosted models | Standard tier: Qwen, GLM 4.7 Flash. Pro tier: GLM 5, a larger model | Standard and Pro are model tiers, not subscription plans. Each Pro token costs 3 times as much as a Standard token, so the free allowance is lower: Standard 30 million tokens/month, Pro 20 million tokens/month. Above the allowance, credits are deducted: US$1 for Standard and US$3 for Pro per 1 million tokens. Pro must be requested from Zoho and is only available in the US and IN data centers |
ZKS, external models through Zoho's key | OpenAI | Credits deducted at OpenAI's prices |
Bring Your Own Key (BYOK) | OpenAI, Anthropic, Gemini, DeepSeek, Cohere, SiliconFlow | You create an API key with the model provider (such as OpenAI or Anthropic) and paste it into Zia Agents. The provider bills the tokens actually used on your API account; no Zoho credits are deducted. Subscriptions such as ChatGPT Plus don't work for this |

US$1 = 1,000 credits, and new accounts get 5,000 free credits. Purchased credits roll over to the next month. The free token allowance applies only to Zoho-provided models, doesn't roll over and resets on the 1st of each month. External models used through Zoho's key draw directly on the account's credits.
By Optimus's measurements, each answer uses about 3,000 tokens with short documents and 13,000 tokens with documents covering more than 200 products, so the 30 million free Standard tokens cover roughly 2,000 to 10,000 answers a month, fewer for long conversations.
V. LESSONS FROM OPTIMUS'S OBOT
Obot, the Zoho advisor on optimus.vn, also runs on Zia Agent + SalesIQ. A few principles Optimus has learned:
Instructions decide how to answer; the knowledge base supplies the content. Keep prices, features and policies in the documents. The longer the instructions, the harder it is to stay consistent.
Keep each answer short. SalesIQ waits about 40 seconds for the agent (Optimus's measurement). Every document search or tool call takes time, and when it runs over, the customer sees a "busy" message.
Asking for a phone number before or after is a business choice. Asking for a name and phone number before advising means staff can always follow up, at the cost of losing some customers who only want a quick answer. Asking after advising makes it easier for customers to start, but they may leave before giving their number. The Oakline example above asks after. Either way, say clearly what the number will be used for and use it only for that.
After uploading new documents, wait a while before testing. A freshly uploaded document may not be usable right away even when the screen says it's done.
VI. LIMITATIONS
It doesn't message customers first. The agent only replies when a customer starts a chat.
AI can still give wrong answers, so always allow handover to staff.
CONCLUSION
Configuring Zia Agent and SalesIQ isn't hard. The real work is writing the instructions, preparing the documents and testing with real customer questions, and that is also what decides whether the bot helps you sell or annoys your customers.
FAQ
Can the agent save customer details to Zoho CRM?
Yes, if you add a Zoho CRM tool, for example one that creates leads. Test it thoroughly to avoid duplicate or wrong leads, and add only the tools you really need, because each tool slows down the answer.
Which model works for Vietnamese?
Start with Qwen 3.5 122B MoE, since it falls within the monthly free allowance (credits are deducted above it). In Optimus's test on documents covering more than 200 products, this model answered nearly as well as GPT 5.6 Sol and clearly better than Qwen 3.5 35B MoE. GLM 4.7 Flash gave quite a few wrong answers, so it isn't suited to advising customers. The document lookup rules in the Agent Instruction matter more than the choice of model: look up each point separately, and if nothing is found, change the keywords up to 3 times, then hand over to staff. Test with real customer questions. When prices and fees have clear calculation rules in the documents, the agent quotes them to the customer itself, with no staff needed. Leave stock levels, and cases the documents don't cover, for staff to confirm.
Can Zia Agent replace the scripted chatbot I already use?
You don't have to replace it entirely. In SalesIQ you can set up a chatbot that combines a script and AI: customers chat with the scripted chatbot by default, and when they want to chat in natural language, the chatbot calls Zia Agent. Unlike Step 4, the scripted chatbot still takes the chat first here, and this part needs its own configuration.
Optimus is a Zoho Authorized Partner in Vietnam. Contact contact@optimus.vn for advice on and implementation of an AI chatbot with Zia Agent and Zoho SalesIQ.

Comments