Skip to content
Since98
Insights · AI & Automation

Zalo Bot API explained: OA messages, ZNS, Mini Apps and personal Zalo

“Zalo API” can mean several official routes: messages from your Official Account, ZNS notifications by phone number, a Zalo Mini App, or Zalo's own bot platform with a Bot API. A personal Zalo account has no official API for business automation. Pick the route by who starts the conversation and what the customer needs to receive.

02 — Short answers

Short answer

What is the difference between Zalo OA messages and ZNS?

Short answer
OA messages are a conversation: the customer follows or writes to your OA and you reply. ZNS sends a pre-approved template, such as an order or appointment confirmation, to a phone number, and each message has a fee.
How we do it
We map each message you want to send to the channel by asking who starts it and whether the customer already talks to your OA.
Limits
Zalo sets which messages count as replies, which templates pass approval and the ZNS fees. We confirm them for your account on the audit.

Can I automate my personal Zalo account?

Short answer
Not through an official API. Tools that log in as a personal account and send messages work outside Zalo's rules, and Zalo can restrict or block such accounts.
How we do it
When a team sells through personal Zalo, we plan a move of new chats to an OA rather than automating the personal accounts.
Limits
Moving customers to an OA takes time, and some customers prefer to keep chatting with the salesperson they know.

Five options, side by side

Most confusion comes from treating Zalo as one product. For a business it is several channels with different rules. The table compares them on the questions we ask first.

Zalo channels for business: a working comparison
OptionWho starts the messageWhat it needsTypical useMain limit
OA messagesThe customer writes or follows your OA; you replyA company OA and a developer app with message permissionsAnswering questions, bookings, an AI assistant in chatThe OA cannot freely message people who are not in a conversation
ZNSYour system, triggered by an eventAn approved template, the customer's phone number, a paid ZNS setupOrder, delivery and appointment noticesFixed templates only, a fee per message, no free-form chat
Zalo Mini AppThe customer opens the app inside ZaloA Mini App registered and reviewed by Zalo, and its own buildBooking forms, loyalty cards, simple catalogsA separate product to build and maintain
Zalo BotThe user opens or messages the botA bot created on Zalo's bot platform and its Bot APISimple scripted bots and notifications to people who chat with the botWhat it allows for business use, limits and fees: checked in current documentation
Personal ZaloA salesperson from a phoneNothing officialRelationship salesNo official API for automation; risk of blocks

Zalo sets the rules, fees and API access for each channel and changes them over time. We check the current Zalo documentation for your account on the audit; nothing here is a quote of Zalo's terms.

OA messages: where an AI assistant lives

An AI chatbot on Zalo works through OA messages. The customer writes, Zalo sends the message to your server, and your server replies under the OA name. This is the channel for questions, prices, bookings and hand-off to staff.

The key limit is initiative. An OA reply inside a conversation is treated differently from a message the OA sends on its own. Plan the assistant to answer and to hand over, and treat reminders as a separate decision.

ZNS: notifications by phone number

ZNS (Zalo Notification Service) sends structured messages from your OA to a phone number, even if the person has not written to you. Each template is reviewed by Zalo before use and each message has a fee.

ZNS fits transactional events: an appointment tomorrow, an order shipped, a payment received. It does not fit marketing blasts or open questions. If you want the customer to reply, the template should lead them into the OA chat, where the assistant can answer.

  • Good fit: confirmations and reminders tied to a real event
  • Poor fit: promotions to a bought phone list
  • Needs: consent and a clean phone number in your system

Zalo Mini App: when a chat is not enough

A Mini App is a small web application that opens inside Zalo. It suits tasks with several fields or choices, such as picking a service, a branch and a time slot, or showing a loyalty card.

It is a product, not a setting. Someone builds it, Zalo reviews it, and someone updates it. For most businesses a chat assistant comes first and a Mini App only when the chat starts to feel like a long form.

Zalo Bot: the newer bot platform

Zalo has a bot platform with its own Bot API for creating bots, closer in spirit to Telegram bots than to the OA. It is a separate route from the Official Account.

What it allows for business use, its limits and any fees change over time. We check the current documentation at developers.zalo.me and on the bot platform before choosing it for a project. For an AI assistant that works under your company's name, the OA is still the route we compare it against.

Personal Zalo: the trap

Many sales teams in Vietnam work from personal Zalo accounts. It feels natural to automate them. There is no official API for that, and the tools that do it imitate a person on a phone or in a browser.

The risk is not only a blocked account. Customer conversations stay on employees' phones, and when someone leaves, the history leaves with them. An OA keeps the conversation with the company.

How to choose

Start from the message, not from the technology. Write down the five messages you most need to send or answer, and for each one mark who starts it and whether the customer expects a reply.

  • Customer asks, you answer → OA messages, with an AI assistant if the volume justifies it
  • Your system reports an event → ZNS template
  • Customer fills in several choices → Mini App, or a booking link in chat
  • Salesperson keeps a relationship → personal Zalo, without automation, with new leads routed to the OA

What drives the running cost

Each channel has its own cost line. OA packages and ZNS fees go to Zalo; hosting, AI model usage and maintenance go to whoever runs the integration. Our AI lead assistant starts from $2,500 for the build; Zalo's own fees are separate and depend on your volume.

We put every cost line in one table on the AI audit ($900, 2 weeks), so you see the full monthly picture before anything is built.

03 — FAQ

Questions readers ask

Is there a Zalo bot like Telegram bots?

Yes, Zalo has a bot platform with its own Bot API. What it allows for business use, its limits and fees change, so we check the current documentation at developers.zalo.me before choosing it over an Official Account.

Can ZNS replace SMS for appointment reminders?

Often yes, for customers who use Zalo and agreed to receive notices. Keep an SMS or call fallback for those who do not, and check the template and fee rules first.

Can an AI chatbot send ZNS messages?

The chatbot itself answers in OA chat. Your system can send a ZNS template when an event happens, for example after the assistant books an appointment.

Do I need a verified OA for the API?

API features depend on the OA type and verification that Zalo requires. We check your OA status as the first step.

04 — Sources

Sources and notes

  1. 01Zalo for DevelopersOfficial documentation for OA API, ZNS and Mini Apps; rules and fees change
  2. 02Zalo Official AccountOA types and verification
  3. 03Our prices: AI lead assistant and AI auditOur published prices and terms on this site
05 — Author

Who wrote this

Dmitry DanilovArchitecture · AI · In web since 1998

One of the two founders of Since98. We write about what we set up for clients: what works, what it costs and where the limits are.

About the founders
06 — Articles

Read next

  • AI & Automation · 4 min read

    AI chatbot on Zalo OA: setup steps

    The setup order for an AI chatbot on a Zalo Official Account: accounts, webhook, permissions, reply rules and hand-off.

  • Build · 4 min read

    Zalo Mini App vs mobile app

    When a Mini App inside Zalo is enough, when you need a native iOS and Android app, and how to decide.

  • AI & Automation · 4 min read

    Personal data and AI chatbots

    What personal data an AI chatbot touches, and the consent, storage and deletion decisions to make with a lawyer before launch.

08

Next step

Describe the situation in a few lines. One of the founders replies and says whether we can help and what the first step would be.

Book an AI audit call
Or write in a messenger: