ZBS (ZNS) message prices, OA plans, template checks, sending rules and Zalo error codes. Unofficial.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Check whether a ZBS template send is allowed: the sending window by tag in Vietnam time (Tag 1 round the clock, Tag 2 and 3 07:00-22:00; for Tag 1 at night a warning notes the -133 wording; the conflicting announcement dates are named), the OA daily quota (levels 1000, 5000, 20000, 50000, unlimited; default 20000), Tag 3 limits per user (1 per day, 30 per month), and the quota upgrade conditions (Good quality over 7 days and 2 x the daily quota sent in 7 days). Reference only, nothing is sent. Examples: {"tag":3,"send_time":"21:30","daily_volume":15000}; {"tag":2,"send_time":"06:30"}; {"tag":3,"promo_sent_to_user_today":1}; {"tag":1,"quota_level":20000,"sent_last_7_days":45000}.
Template tag: 1 transaction, 2 customer care, 3 promotion.
How messages are addressed: "phone" (phone number, default) or "uid" (Zalo user ID for this OA; cheaper, not for OTP, quick response, journey or carousel).
Planned send time, HH:MM in Vietnam time (UTC+7).
OA daily quota level for template messages: 1000, 5000, 20000, 50000, unlimited (default 20000, where a new OA starts; 1000 and 5000 are penalty levels).
Template messages the OA plans to send that day (all templates).
Messages sent successfully in the last 7 days (to check the quota upgrade volume condition).
Tag 3 messages this OA has already sent to the same user today (before this one).
Tag 3 messages this OA has already sent to the same user this month (before this one).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http zalo-business-reference https://since98.vn/api/mcp/zalo
Check whether a ZBS template send is allowed: the sending window by tag in Vietnam time (Tag 1 round the clock, Tag 2 and 3 07:00-22:00; for Tag 1 at night a warning notes the -133 wording; the conflicting announcement dates are named), the OA daily quota (levels 1000, 5000, 20000, 50000, unlimited; default 20000), Tag 3 limits per user (1 per day, 30 per month), and the quota upgrade conditions (Good quality over 7 days and 2 x the daily quota sent in 7 days). Reference only, nothing is sent. Examples: {"tag":3,"send_time":"21:30","daily_volume":15000}; {"tag":2,"send_time":"06:30"}; {"tag":3,"promo_sent_to_user_today":1}; {"tag":1,"quota_level":20000,"sent_last_7_days":45000}.
| Argument | Type | Description |
|---|---|---|
| tag* | any | Template tag: 1 transaction, 2 customer care, 3 promotion. |
| delivery | string | How messages are addressed: "phone" (phone number, default) or "uid" (Zalo user ID for this OA; cheaper, not for OTP, quick response, journey or carousel). |
| send_time | string | Planned send time, HH:MM in Vietnam time (UTC+7). |
| quota_level | any | OA daily quota level for template messages: 1000, 5000, 20000, 50000, unlimited (default 20000, where a new OA starts; 1000 and 5000 are penalty levels). |
| daily_volume | integer | Template messages the OA plans to send that day (all templates). |
| sent_last_7_days | integer | Messages sent successfully in the last 7 days (to check the quota upgrade volume condition). |
| promo_sent_to_user_today | integer | Tag 3 messages this OA has already sent to the same user today (before this one). |
| promo_sent_to_user_this_month | integer | Tag 3 messages this OA has already sent to the same user this month (before this one). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tag"
],
"properties": {
"tag": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"enum": [
"1",
"2",
"3"
],
"type": "string"
}
],
"description": "Template tag: 1 transaction, 2 customer care, 3 promotion."
},
"delivery": {
"enum": [
"phone",
"uid"
],
"type": "string",
"description": "How messages are addressed: \"phone\" (phone number, default) or \"uid\" (Zalo user ID for this OA; cheaper, not for OTP, quick response, journey or carousel)."
},
"send_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Planned send time, HH:MM in Vietnam time (UTC+7)."
},
"quota_level": {
"anyOf": [
{
"enum": [
"1000",
"5000",
"20000",
"50000",
"unlimited"
],
"type": "string"
},
{
"type": "number"
}
],
"description": "OA daily quota level for template messages: 1000, 5000, 20000, 50000, unlimited (default 20000, where a new OA starts; 1000 and 5000 are penalty levels)."
},
"daily_volume": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "Template messages the OA plans to send that day (all templates)."
},
"sent_last_7_days": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "Messages sent successfully in the last 7 days (to check the quota upgrade volume condition)."
},
"promo_sent_to_user_today": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Tag 3 messages this OA has already sent to the same user today (before this one)."
},
"promo_sent_to_user_this_month": {
"type": "integer",
"maximum": 10000,
"minimum": 0,
"description": "Tag 3 messages this OA has already sent to the same user this month (before this one)."
}
},
"additionalProperties": false
}Suggest which Zalo channel fits a business task, by simple published rules: ZBS template message (with the template type, tag, price and window), a free consultation reply within 48 hours of the user's last interaction (paid outside 48 hours, not allowed after 7 days), an OA broadcast to followers, or a Mini App. Tasks: otp, order_status, delivery_tracking, payment_request, appointment_reminder, customer_reply, service_rating, promotion, voucher, birthday_greeting, news_to_followers, catalog_checkout. Optional: last_interaction_hours, is_follower. Reference only. Examples: {"task":"order_status"}; {"task":"customer_reply","last_interaction_hours":30}; {"task":"promotion","is_follower":true}.
| Argument | Type | Description |
|---|---|---|
| task* | string | What you need to send: otp, order_status, delivery_tracking, payment_request, appointment_reminder, customer_reply, service_rating, promotion, voucher, birthday_greeting, news_to_followers, catalog_checkout. |
| is_follower | boolean | The user follows the OA. |
| last_interaction_hours | integer | Hours since the user's last interaction with the OA (message, call, menu tap...). Decides whether a free reply is possible. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task"
],
"properties": {
"task": {
"enum": [
"otp",
"order_status",
"delivery_tracking",
"payment_request",
"appointment_reminder",
"customer_reply",
"service_rating",
"promotion",
"voucher",
"birthday_greeting",
"news_to_followers",
"catalog_checkout"
],
"type": "string",
"description": "What you need to send: otp, order_status, delivery_tracking, payment_request, appointment_reminder, customer_reply, service_rating, promotion, voucher, birthday_greeting, news_to_followers, catalog_checkout."
},
"is_follower": {
"type": "boolean",
"description": "The user follows the OA."
},
"last_interaction_hours": {
"type": "integer",
"maximum": 87600,
"minimum": 0,
"description": "Hours since the user's last interaction with the OA (message, call, menu tap...). Decides whether a free reply is possible."
}
},
"additionalProperties": false
}Return the data version and retrieval date, the official Zalo pages used, what Zalo does not publish (Cơ bản plan price, broadcast price above the free allowance, Mini App fees, the VAT rate for template messages, and others), where Zalo's own pages disagree (maximum buttons, night window, OTP by UID, old fallback prices) and how this tool resolves it, the change log and the worked example. Use when the user asks how current or reliable the figures are. Takes no arguments: {}.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Explain a Zalo error code in plain words: which table it comes from (ZBS Template Message, the archived ZNS table, or the Official Account API; the same code can mean different things in different tables) and what to check. A positive number is also tried as negative. Examples: {"code":-133}; {"code":-100,"table":"oa_api"}; {"code":249}.
| Argument | Type | Description |
|---|---|---|
| code* | integer | Error code returned by Zalo, e.g. -133 (a positive number is also tried as negative). |
| table | string | Limit to one table: zbs (ZBS Template Message), zns_archive (old ZNS), oa_api (Official Account API). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"code"
],
"properties": {
"code": {
"type": "integer",
"maximum": 100000,
"minimum": -100000,
"description": "Error code returned by Zalo, e.g. -133 (a positive number is also tried as negative)."
},
"table": {
"enum": [
"zbs",
"zns_archive",
"oa_api"
],
"type": "string",
"description": "Limit to one table: zbs (ZBS Template Message), zns_archive (old ZNS), oa_api (Official Account API)."
}
},
"additionalProperties": false
}Estimate what Zalo charges for ZBS template messages (formerly ZNS): base price by template type (otp, voucher, payment_request, bus_ticket, custom = "other types", rating, quick_response, carousel, journey "from" price) for phone or UID sending, plus buttons by category (the first button to the OA page/Mini App/OA article and the first to an e-invoice page are free, others paid from the first), image module and quick reply. Returns the price per message with a line breakdown, the total if all messages are delivered, the estimate for delivery_rate (only delivered messages are charged), totals with VAT if you pass vat_rate (Zalo names no rate), the OA plan needed to send through the API, and days needed at the daily quota (default 20000, a new OA). OTP, quick response, journey and carousel by UID are rejected. Prices exclude VAT. Reference only, no messages are sent. Examples: {"template_type":"custom","buttons":["business_website"],"count":10000}; {"template_type":"custom","delivery":"uid","buttons":["oa_profile_page"],"count":5000,"delivery_rate":0.9,"vat_rate":0.1}; {"template_type":"otp","count":20000}.
| Argument | Type | Description |
|---|---|---|
| count | integer | Number of messages (1-100000000). Default 1. |
| image | boolean | Image module (1-3 images) included. Default false. Not allowed on OTP. |
| buttons | array | Extra buttons by category, one item per button (repeat a category for two buttons): oa_profile_page, business_mini_app, oa_article_or_other_zalo_asset, e_invoice_lookup, business_website, call_phone, business_app_page, other_website_or_mini_app, other_app_page, app_download_landing. The first button to the OA page / business Mini App / OA article (one category) and the first to an e-invoice page are free; others are paid from the first. Built-in type buttons (copy code, transfer, details) are free and not listed here. |
| delivery | string | How messages are addressed: "phone" (phone number, default) or "uid" (Zalo user ID for this OA; cheaper, not for OTP, quick response, journey or carousel). |
| vat_rate | number | Optional VAT rate as a share (e.g. 0.1) to add to the totals. Zalo's ZBS page says prices exclude VAT but names no rate, so the rate is yours. |
| quick_reply | boolean | Quick reply (response) buttons activated. Default false; always on for quick_response. |
| quota_level | any | OA daily quota level for template messages: 1000, 5000, 20000, 50000, unlimited (default 20000, where a new OA starts; 1000 and 5000 are penalty levels). |
| delivery_rate | number | Expected share of messages that get delivered and charged, 0-1 (default 1 = all). Only delivered messages are charged. |
| template_type | string | ZBS template type: otp, payment_request, voucher, bus_ticket, custom (the "other types" row: order status, reminders, notices), rating, quick_response, carousel, journey (special industries, price "from"). Default custom. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Number of messages (1-100000000). Default 1."
},
"image": {
"type": "boolean",
"description": "Image module (1-3 images) included. Default false. Not allowed on OTP."
},
"buttons": {
"type": "array",
"items": {
"enum": [
"oa_profile_page",
"business_mini_app",
"oa_article_or_other_zalo_asset",
"e_invoice_lookup",
"business_website",
"call_phone",
"business_app_page",
"other_website_or_mini_app",
"other_app_page",
"app_download_landing"
],
"type": "string",
"description": "Button category."
},
"maxItems": 20,
"description": "Extra buttons by category, one item per button (repeat a category for two buttons): oa_profile_page, business_mini_app, oa_article_or_other_zalo_asset, e_invoice_lookup, business_website, call_phone, business_app_page, other_website_or_mini_app, other_app_page, app_download_landing. The first button to the OA page / business Mini App / OA article (one category) and the first to an e-invoice page are free; others are paid from the first. Built-in type buttons (copy code, transfer, details) are free and not listed here."
},
"delivery": {
"enum": [
"phone",
"uid"
],
"type": "string",
"description": "How messages are addressed: \"phone\" (phone number, default) or \"uid\" (Zalo user ID for this OA; cheaper, not for OTP, quick response, journey or carousel)."
},
"vat_rate": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Optional VAT rate as a share (e.g. 0.1) to add to the totals. Zalo's ZBS page says prices exclude VAT but names no rate, so the rate is yours."
},
"quick_reply": {
"type": "boolean",
"description": "Quick reply (response) buttons activated. Default false; always on for quick_response."
},
"quota_level": {
"anyOf": [
{
"enum": [
"1000",
"5000",
"20000",
"50000",
"unlimited"
],
"type": "string"
},
{
"type": "number"
}
],
"description": "OA daily quota level for template messages: 1000, 5000, 20000, 50000, unlimited (default 20000, where a new OA starts; 1000 and 5000 are penalty levels)."
},
"delivery_rate": {
"type": "number",
"maximum": 1,
"description": "Expected share of messages that get delivered and charged, 0-1 (default 1 = all). Only delivered messages are charged.",
"exclusiveMinimum": 0
},
"template_type": {
"enum": [
"otp",
"payment_request",
"voucher",
"bus_ticket",
"custom",
"rating",
"quick_response",
"carousel",
"journey"
],
"type": "string",
"description": "ZBS template type: otp, payment_request, voucher, bus_ticket, custom (the \"other types\" row: order status, reminders, notices), rating, quick_response, carousel, journey (special industries, price \"from\"). Default custom."
}
},
"additionalProperties": false
}Compare the Zalo Official Account plans in force from 1 June 2026 (Cơ bản, Tiêu chuẩn, Tăng trưởng, Toàn diện) with prices including 10% VAT, staff accounts, Open API and its requests-per-minute limit, consultation messages outside the 48-hour window and features, and pick the smallest plan that meets your needs (needs_api, api_requests_per_minute, replies_outside_48h_per_month, staff, features, term_months 6 or 12), with the reason and the paid-reply overage. The Cơ bản price is not published by Zalo. Reference only. Examples: {}; {"needs_api":true,"staff":8}; {"replies_outside_48h_per_month":3000,"features":["chatbot"],"term_months":6}.
| Argument | Type | Description |
|---|---|---|
| staff | integer | Staff accounts that will work in the OA. Default 1. |
| features | array | Required features: chat_basic, chat_advanced_labels_assign_notes, group_chat_gmf, voice_call_basic, voice_call_advanced, mobile_chat_tool, basic_automation, chat_menu, chatbot, extensions, articles_comments_campaign_tool, advanced_reports_activity_log_crm, search_in_zalo_share_qr, follow_invitations, custom_url_priority_features_priority_support. |
| needs_api | boolean | The OA needs the Open API (for integrations or sending template messages through the API). Default false. |
| term_months | any | Plan term: 12 (default) or 6 months (6 months only for Tăng trưởng and Toàn diện). |
| api_requests_per_minute | integer | Peak OA API requests per minute (implies needs_api when above 0). |
| replies_outside_48h_per_month | integer | Consultation messages per month sent more than 48 hours after the user's last interaction (paid replies). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"staff": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Staff accounts that will work in the OA. Default 1."
},
"features": {
"type": "array",
"items": {
"enum": [
"chat_basic",
"chat_advanced_labels_assign_notes",
"group_chat_gmf",
"voice_call_basic",
"voice_call_advanced",
"mobile_chat_tool",
"basic_automation",
"chat_menu",
"chatbot",
"extensions",
"articles_comments_campaign_tool",
"advanced_reports_activity_log_crm",
"search_in_zalo_share_qr",
"follow_invitations",
"custom_url_priority_features_priority_support"
],
"type": "string",
"description": "Feature."
},
"maxItems": 15,
"description": "Required features: chat_basic, chat_advanced_labels_assign_notes, group_chat_gmf, voice_call_basic, voice_call_advanced, mobile_chat_tool, basic_automation, chat_menu, chatbot, extensions, articles_comments_campaign_tool, advanced_reports_activity_log_crm, search_in_zalo_share_qr, follow_invitations, custom_url_priority_features_priority_support."
},
"needs_api": {
"type": "boolean",
"description": "The OA needs the Open API (for integrations or sending template messages through the API). Default false."
},
"term_months": {
"anyOf": [
{
"type": "number",
"const": 6
},
{
"type": "number",
"const": 12
},
{
"enum": [
"6",
"12"
],
"type": "string"
}
],
"description": "Plan term: 12 (default) or 6 months (6 months only for Tăng trưởng and Toàn diện)."
},
"api_requests_per_minute": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Peak OA API requests per minute (implies needs_api when above 0)."
},
"replies_outside_48h_per_month": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "Consultation messages per month sent more than 48 hours after the user's last interaction (paid replies)."
}
},
"additionalProperties": false
}Check a ZBS template draft against the formal technical rules Zalo publishes: template name, title and text block lengths and parameter counts, table rows and cell lengths, number of buttons (2 vs 3 conflict reported as a warning), button text and URL length, parameters only in the URL path, one OA page button, logo PNG 400x96, image module 1-3 images 16:9 up to 500 KB, parameter types and sample lengths, and formal content hints (links or phone numbers in the text, icons, "anh/chị", superlatives in Tag 3). Types: custom, otp, rating, quick_response. Returns errors and warnings with the rule and the official page. Content is reviewed by Zalo, not here; the text is not stored. Example: {"template_type":"custom","tag":1,"title":"Order <order_code> confirmed","paragraphs":["Hello <customer_name>, your order <order_code> is on its way."],"buttons":[{"category":"business_website","text":"Track order","url":"https://shop.example.vn/track/<order_code>"}],"logo":{"format":"PNG","width":400,"height":96}}.
| Argument | Type | Description |
|---|---|---|
| tag | any | Template tag: 1 transaction, 2 customer care, 3 promotion. |
| logo | object | Logo file facts: format (PNG), width and height in px. |
| name | string | Template name (visible only to the business). |
| table | array | Table rows {name, value}. |
| title | string | Title; parameters as <param_name>. |
| images | array | Image module files: width, height (px), size_kb. |
| params | array | Declared parameters: name, Zalo type (customer_name, phone_number, address, code, custom_label, transaction_status, contact, personal_title, product_name, amount, time, bank_transfer_note, url_in_button, otp) and an optional sample value. |
| buttons | array | CTA buttons. |
| paragraphs | array | Text blocks (custom: 1-4; OTP and rating: one). |
| quick_replies | array | Quick reply button texts (quick_response templates). |
| template_type | string | Template to check: custom (default), otp, rating, quick_response. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"enum": [
"1",
"2",
"3"
],
"type": "string"
}
],
"description": "Template tag: 1 transaction, 2 customer care, 3 promotion."
},
"logo": {
"type": "object",
"properties": {
"width": {
"type": "integer",
"maximum": 100000,
"minimum": 1
},
"format": {
"type": "string",
"maxLength": 20
},
"height": {
"type": "integer",
"maximum": 100000,
"minimum": 1
}
},
"description": "Logo file facts: format (PNG), width and height in px.",
"additionalProperties": false
},
"name": {
"type": "string",
"maxLength": 500,
"description": "Template name (visible only to the business)."
},
"table": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"maxLength": 500
},
"value": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Table rows {name, value}."
},
"title": {
"type": "string",
"maxLength": 1000,
"description": "Title; parameters as <param_name>."
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"width": {
"type": "integer",
"maximum": 100000,
"minimum": 1
},
"height": {
"type": "integer",
"maximum": 100000,
"minimum": 1
},
"size_kb": {
"type": "number",
"maximum": 1000000,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Image module files: width, height (px), size_kb."
},
"params": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"type"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"type": {
"type": "string",
"maxLength": 100
},
"sample": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"maxItems": 30,
"description": "Declared parameters: name, Zalo type (customer_name, phone_number, address, code, custom_label, transaction_status, contact, personal_title, product_name, amount, time, bank_transfer_note, url_in_button, otp) and an optional sample value."
},
"buttons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"description": "Button link; parameters like <order_id> only in the path."
},
"text": {
"type": "string",
"maxLength": 500,
"description": "Button text."
},
"phone": {
"type": "string",
"maxLength": 100,
"description": "Call button number: fixed or one phone_number parameter."
},
"category": {
"enum": [
"oa_profile_page",
"business_mini_app",
"oa_article_or_other_zalo_asset",
"e_invoice_lookup",
"business_website",
"call_phone",
"business_app_page",
"other_website_or_mini_app",
"other_app_page",
"app_download_landing"
],
"type": "string",
"description": "Button category (to check the one-OA-page-button rule)."
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "CTA buttons."
},
"paragraphs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4000
},
"maxItems": 10,
"description": "Text blocks (custom: 1-4; OTP and rating: one)."
},
"quick_replies": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 10,
"description": "Quick reply button texts (quick_response templates)."
},
"template_type": {
"enum": [
"custom",
"otp",
"rating",
"quick_response"
],
"type": "string",
"description": "Template to check: custom (default), otp, rating, quick_response."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.