Skip to content
Since98
Documentation · REST and MCP · for Zalo OA / ZBS

Zalo ZNS API and MCP server: prices, template checks, error codes

The data behind our ZNS cost calculator, open to code and AI assistants: a REST API and a remote MCP server. No key and no sign-up, and nothing is sent to Zalo. Every response links the official Zalo page behind each figure and carries the data version. Independent tool, not affiliated with Zalo or VNG.

02 — Start

Quick start

MCP server URL. Add it as a remote (custom) MCP server in your client:

https://since98.vn/api/mcp/zalo

Or call the REST API directly:

curl "https://since98.vn/api/v1/zalo/message-cost?template_type=custom&buttons=business_website&count=10000"
OpenAPI: /api/v1/zalo/openapi.json
03 — Short answers

How it works

How do I give an AI assistant current ZNS prices and Zalo rules?

Short answer
Add a remote MCP server with the URL https://since98.vn/api/mcp/zalo. It uses Streamable HTTP, needs no key and no sign-in, and exposes 7 read-only tools: message cost, OA plan comparison, template check, sending rules, channel choice, error codes and data info.
How we do it
The server is stateless: every POST is answered on its own, without sessions. Current clients and older clients that start with initialize are both supported. Tools return structured content with an output schema, and every result links the official Zalo page each figure comes from.
Limits
60 requests per minute and 2,000 per day per IP address, shared with the REST API and our other tools. Figures that Zalo does not publish come back as null with a status, never guessed.
04 — Clients

Connect the MCP server

  1. Claude (web and desktop app)

    1. Open Customize → Connectors, choose “+ Add” → “Add custom connector”. On Team and Enterprise plans, an owner adds it in Organization settings → Connectors.
    2. Enter a name, for example Zalo business reference, and the URL https://since98.vn/api/mcp/zalo.
    3. Choose “No sign in” for authentication and click Add.
    4. In a chat, ask for example: “What do 10,000 ZNS order updates with a website button cost, by phone and by UID?”
    Client documentation
  2. Claude Code

    1. Run the command below in a terminal.
    2. Check the connection with /mcp inside a session.
    Terminal
    claude mcp add --transport http since98-zalo https://since98.vn/api/mcp/zalo
    Client documentation
  3. Cursor

    1. Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).
    2. Reload the MCP list in Cursor settings.
    mcp.json
    {
      "mcpServers": {
        "since98-zalo": {
          "url": "https://since98.vn/api/mcp/zalo"
        }
      }
    }
    Client documentation
  4. VS Code (GitHub Copilot)

    1. Open the Command Palette and run “MCP: Add Server”.
    2. Choose HTTP, paste https://since98.vn/api/mcp/zalo and give the server an ID, for example since98-zalo.
    3. Use it in Copilot Chat in agent mode.
    Client documentation
  5. Windsurf

    1. Add the server to ~/.codeium/windsurf/mcp_config.json.
    2. Refresh the MCP servers in Cascade.
    mcp_config.json
    {
      "mcpServers": {
        "since98-zalo": {
          "serverUrl": "https://since98.vn/api/mcp/zalo"
        }
      }
    }
    Client documentation
  6. ChatGPT

    1. On chatgpt.com, open the plugins page and choose “+” → “Add custom MCP server”.
    2. Paste https://since98.vn/api/mcp/zalo as the server URL and choose no authentication.
    3. Availability depends on your ChatGPT plan and workspace settings.
    Client documentation
  7. Any other MCP client

    1. Add a remote (custom) MCP server by URL: https://since98.vn/api/mcp/zalo.
    2. Transport: Streamable HTTP. No key, no OAuth, no headers needed.
05 — Tools

MCP tools

This list is generated from the same definitions the server registers, so it matches what tools/list returns.

estimate_message_costZBS template message cost (Zalo)
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}.
oa_plan_compareZalo OA plan comparison
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}.
validate_templateCheck a ZBS template draft (formal rules)
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}}.
check_sending_rulesCheck ZBS sending window, quota and promotion limits
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}.
choose_channelChoose a Zalo channel for a task
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}.
error_lookupZalo error code lookup
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}.
data_infoZalo reference data: sources and gaps
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: {}.
06 — REST

REST API

Reference endpoints accept GET with query parameters (lists comma-separated, for example buttons=business_website,call_phone) and answer with a short public cache. validate-template takes only POST with a JSON body, because a template draft is your text: it answers no-store, and GET returns 405. JSON responses, CORS open for any site. The REST endpoints and the MCP tools share the same input schemas and the same response format.

Endpoints
EndpointParametersMCP tool
GET /api/v1/zalo/message-costtemplate_type, delivery, buttons, image, quick_reply, count, delivery_rate, vat_rate, quota_levelestimate_message_cost
GET /api/v1/zalo/oa-plansneeds_api, api_requests_per_minute, replies_outside_48h_per_month, staff, features, term_monthsoa_plan_compare
POST /api/v1/zalo/validate-templatetemplate_type, tag, name, title, paragraphs, table, buttons, quick_replies, logo, images, paramsvalidate_template
GET /api/v1/zalo/sending-rulestag, send_time, daily_volume, quota_level, promo_sent_to_user_today, promo_sent_to_user_this_month, sent_last_7_days, deliverycheck_sending_rules
GET /api/v1/zalo/choose-channeltask, last_interaction_hours, is_followerchoose_channel
GET /api/v1/zalo/errorscode, tableerror_lookup
GET /api/v1/zalo/meta—data_info

Cost of 10,000 custom messages with a button to your website

curl "https://since98.vn/api/v1/zalo/message-cost?template_type=custom&buttons=business_website&count=10000"
Response (real output on the current data, long lists shortened)
{
  "template_type": "custom",
  "template_name": "Template tuỳ chỉnh (the \"other types\" row)",
  "delivery": "phone",
  "count": 10000,
  "delivery_rate": 1,
  "currency": "VND",
  "vat_basis": "excluded",
  "lines": [
    {
      "item": "template_type",
      "code": "custom",
      "name": "Template tuỳ chỉnh (the \"other types\" row)",
      "count": 1,
      "unit_price": 300,
      "amount": 300,
      "in_visible_price_table": true,
      "verified": "page_opened"
    },
    {
      "item": "button",
      "code": "business_website",
      "name": "Đến trang của doanh nghiệp (business website)",
      "tier": "flat",
      "count": 1,
      "unit_price": 100,
      "amount": 100,
      "in_visible_price_table": true,
      "verified": "page_opened"
    }
  ],
  "per_message": 400,
  "complete": true,
  "total_max": 4000000,
  "delivered_estimate": 10000,
  "total_estimated": 4000000,
  "plan_required": {
    "plans": [
      {
        "id": "growth",
        "name": "Tăng trưởng",
        "price_12m": 2500000,
        "price_6m": 1400000,
        "vat": "included_10pct"
      },
      {
        "id": "comprehensive",
        "name": "Toàn diện",
        "price_12m": 6000000,
        "price_6m": 3400000,
        "vat": "included_10pct"
      }
    ],
    "cheapest": "Tăng trưởng",
    "standard_plan": "Tiêu chuẩn: campaign tool in OA Manager only, Tag 3 only.",
    "legacy_plans": [
      "Dùng thử",
      "Nâng cao",
      "Premium"
    ],
    "note": "Sending template messages through the API or the ZBS Account needs a verified OA on Tăng trưởng or Toàn diện (or a legacy plan still running). OA plan prices include 10% VAT.",
    "source_url": "https://zalo.solutions/oa/pricing"
  },
  "quota": {
    "daily_quota": 20000,
    "days_needed": 1,
    "start_level": 20000,
    "penalty_zone": false
  },
  "warnings": [],
  "notes": [
    "Only delivered messages are charged: a template sent by phone is charged if delivered within 7200 seconds (2 hours).",
    "Template message prices exclude VAT, as on Zalo's ZBS pricing page; Zalo does not name the VAT rate for them.",
    "… 2 more"
  ],
  "sources": [
    {
      "parameter": "template_prices.types.custom",
      "url": "https://zalo.solutions/business-message/pricing",
      "verified": "page_opened",
      "effective_from": "2026-03-16"
    },
    {
      "parameter": "template_prices.buttons.business_website",
      "url": "https://zalo.solutions/business-message/pricing",
      "verified": "page_opened",
      "effective_from": "2026-03-16"
    },
    "… 4 more"
  ],
  "data_version": "2026.11.21",
  "affiliation": "Independent reference tool, not affiliated with Zalo or VNG.",
  "disclaimer": "Reference only: no messages are sent and nothing is passed to Zalo. Prices and rules as published by Zalo on the retrieval date; check the linked official page before relying on them."
}

Check a template draft (POST only)

curl -X POST "https://since98.vn/api/v1/zalo/validate-template" \
  -H "Content-Type: application/json" \
  -d '{"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}}'
Response (real output on the current data, long lists shortened)
{
  "template_type": "custom",
  "tag": 1,
  "valid": true,
  "errors": 0,
  "warnings": 0,
  "issues": [],
  "rules_checked": [
    "custom_title",
    "content_formal",
    "custom_text_blocks",
    "logo_or_image",
    "buttons_count",
    "button_text_length",
    "button_url_length",
    "logo",
    "tag_personalisation"
  ],
  "moderation": "Only formal technical parameters are checked here. Zalo reviews the content of every template (2-3 working days); an approved template cannot be edited, only replaced by a new one.",
  "notes": [
    "Lengths are counted in characters as written in the draft, including parameter placeholders such as <customer_name>.",
    "The submitted text is not stored or logged."
  ],
  "data_version": "2026.11.21",
  "affiliation": "Independent reference tool, not affiliated with Zalo or VNG.",
  "disclaimer": "Reference only: no messages are sent and nothing is passed to Zalo. Prices and rules as published by Zalo on the retrieval date; check the linked official page before relying on them."
}

Smallest OA plan with the Open API for eight staff accounts

curl "https://since98.vn/api/v1/zalo/oa-plans?needs_api=true&staff=8"
Response (real output on the current data, long lists shortened)
{
  "term_months": 12,
  "requirements": {
    "needs_api": true,
    "api_requests_per_minute": 0,
    "replies_outside_48h_per_month": 0,
    "staff": 8,
    "features": []
  },
  "currency": "VND",
  "vat_basis": "included_10pct",
  "recommended": {
    "id": "growth",
    "name": "Tăng trưởng",
    "price": 2500000,
    "monthly_estimate": 208000
  },
  "reason": "Tăng trưởng is the smallest plan that meets the requirements; 15 staff accounts; Open API up to 100 requests per minute.",
  "plans": [
    {
      "id": "basic",
      "name": "Cơ bản",
      "price": null,
      "price_12m": null,
      "price_6m": null,
      "price_status": "not published by Zalo",
      "per_month_approx": null,
      "vat": "included_10pct",
      "staff": 3,
      "open_api": false,
      "api_rate_limit_per_min": null,
      "replies_outside_48h_included": null,
      "replies_overage_per_month": null,
      "monthly_estimate": null,
      "features": [
        "chat_basic",
        "basic_automation",
        "search_in_zalo_share_qr"
      ],
      "fits": false,
      "why_not": [
        "allows 3 staff accounts; you need 8",
        "no Open API"
      ],
      "note": "No price on the page. News of 01.06.2026: a verified OA without a purchase gets the Cơ bản rights, and an OA returns to Cơ bản when a paid plan ends."
    },
    {
      "id": "standard",
      "name": "Tiêu chuẩn",
      "price": 1000000,
      "price_12m": 1000000,
      "price_6m": null,
      "per_month_approx": 83000,
      "vat": "included_10pct",
      "staff": 5,
      "open_api": false,
      "api_rate_limit_per_min": null,
      "replies_outside_48h_included": null,
      "replies_overage_per_month": null,
      "monthly_estimate": 83000,
      "features": [
        "chat_basic",
        "chat_advanced_labels_assign_notes",
        "group_chat_gmf",
        "voice_call_basic",
        "mobile_chat_tool",
        "basic_automation",
        "chat_menu",
        "extensions",
        "articles_comments_campaign_tool",
        "advanced_reports_activity_log_crm",
        "search_in_zalo_share_qr",
        "follow_invitations"
      ],
      "fits": false,
      "why_not": [
        "allows 5 staff accounts; you need 8",
        "no Open API"
      ],
      "note": "Annual term only: the FAQ says 6 months exist only for Tăng trưởng and Toàn diện."
    },
    "… 2 more"
  ],
  "notes": [
    "OA plan prices INCLUDE 10% VAT (stated on the page). Plans apply from 01.06.2026 to verified OAs only.",
    "Consultation messages (Tin Tư vấn) are free within 48 hours of the user's last interaction; outside that window they use the plan allowance and then cost 55 VND each (incl. VAT).",
    "… 3 more"
  ],
  "sources": [
    {
      "parameter": "oa_plans.plans",
      "url": "https://zalo.solutions/oa/pricing",
      "verified": "page_opened",
      "effective_from": "2026-06-01"
    },
    {
      "parameter": "oa_plans.feature_matrix",
      "url": "https://zalo.solutions/oa/pricing",
      "verified": "page_opened",
      "effective_from": "2026-06-01"
    },
    "… 3 more"
  ],
  "data_version": "2026.11.21",
  "affiliation": "Independent reference tool, not affiliated with Zalo or VNG.",
  "disclaimer": "Reference only: no messages are sent and nothing is passed to Zalo. Prices and rules as published by Zalo on the retrieval date; check the linked official page before relying on them."
}

Can a Tag 3 message go out at night

curl "https://since98.vn/api/v1/zalo/sending-rules?tag=3&send_time=21:30&daily_volume=15000"
Response (real output on the current data, long lists shortened)
{
  "tag": 3,
  "tag_name": "Promotion (Hậu mãi)",
  "allowed": true,
  "violations": [],
  "warnings": [
    "The sending windows by tag apply from 2026-10-15 (marked as expected) but were announced on 2026-11-16; the dates in the announcement conflict."
  ],
  "window": {
    "from": "07:00",
    "to": "22:00",
    "timezone": "Asia/Ho_Chi_Minh (UTC+7)",
    "send_time": "21:30",
    "inside": true
  },
  "quota": {
    "level": 20000,
    "daily_volume": 15000,
    "remaining": 5000,
    "start_level": 20000,
    "penalty_zone": false,
    "upgrade": {
      "current_level": 20000,
      "next_level": 50000,
      "conditions": "Up one level when the quality rating is Good over the last 7 days and the messages successfully sent in those 7 days reach 2 x the current daily quota (40,000).",
      "sent_needed_in_7_days": 40000,
      "review": "The next review is 7 days after a quota change; a new OA's first review is on day D+8 from its first send.",
      "downgrade": "Down one level when the quality rating is Bad over the last 7 days, or at once when complaints in a day exceed 2% of the daily quota (checked hourly, at most once a day). Below 0.1% complaints per day is safe."
    }
  },
  "promotion_limits": {
    "per_day": 1,
    "per_month": 30
  },
  "notes": [
    "Tag 3 goes to the inbox of OA followers and to Business Box for non-followers.",
    "Only to users who already had a transaction with the business; exception: OTP when creating a new account."
  ],
  "sources": [
    {
      "parameter": "sending.send_window_by_tag",
      "url": "https://zalo.solutions/news/thong-bao-vv-cap-nhat-co-che-cua-zbs-template-message/eou7dloqfopa2puvj2h0e9wy",
      "verified": "page_opened",
      "effective_from": "2026-10-15"
    },
    {
      "parameter": "sending.night_error_133",
      "url": "https://developers.zalo.me/docs/zbs-template-message/bang-ma-loi/",
      "verified": "page_opened"
    },
    "… 3 more"
  ],
  "data_version": "2026.11.21",
  "affiliation": "Independent reference tool, not affiliated with Zalo or VNG.",
  "disclaimer": "Reference only: no messages are sent and nothing is passed to Zalo. Prices and rules as published by Zalo on the retrieval date; check the linked official page before relying on them."
}

What error -133 means

curl "https://since98.vn/api/v1/zalo/errors?code=-133"
Response (real output on the current data, long lists shortened)
{
  "code": -133,
  "found": true,
  "matches": [
    {
      "table": "zbs",
      "table_name": "ZBS Template Message error table",
      "context": "send_phone",
      "meaning": "This type cannot be sent at night (22:00-07:00).",
      "check": "Send Tag 2 and Tag 3 between 07:00 and 22:00 Vietnam time.",
      "source_url": "https://developers.zalo.me/docs/zbs-template-message/bang-ma-loi/"
    }
  ],
  "notes": [],
  "data_version": "2026.11.21",
  "affiliation": "Independent reference tool, not affiliated with Zalo or VNG.",
  "disclaimer": "Reference only: no messages are sent and nothing is passed to Zalo. Prices and rules as published by Zalo on the retrieval date; check the linked official page before relying on them."
}
07 — Rules

Limits, privacy, money and data version

Limits

Each IP address can make 60 requests per minute and 2,000 per day, REST and MCP together, shared with our other tools. Over the limit, the REST API answers 429 with a Retry-After header, and the MCP server returns an error with the same wait time.

Need a higher volume, bulk processing of your own database, or these tools built into your system? Write to us at [email protected] or through the contact page.

Reference endpoints are publicly cacheable for a short time; errors, meta and openapi.json for longer. validate-template is never cached.

What we keep and what we never ask for

The tools take no access tokens, OA IDs, app secrets or phone numbers and send nothing to Zalo. A template draft sent to validate-template is checked in memory and not stored or written to logs.

For the rate limit the application keeps a counter per IP address in memory until the time window ends, and a daily count of calls per tool, saved in our database without IP addresses or inputs. The logs of our web server and Cloudflare record technical request data (time, IP address, path), not the request body.

API and MCP privacy

Money, VAT and delivery

Amounts are whole VND. Template message prices exclude VAT, as on Zalo's page; pass vat_rate (a share, for example 0.1) to add VAT at your rate. OA plan prices include 10% VAT, as on the plans page.

By phone only delivered messages are charged; by UID, messages Zalo processes. delivery_rate (0–1) gives an estimate for the charged share; totals are rounded to the dong, halves up. Journey templates have a “from” price, and the response marks the totals as minimums.

Data version and verification status

Every response contains data_version, the affiliation line, a disclaimer and the official page of each figure with its status: seen on the page, seen only in the service data the pricing page loads, or not published. data_info returns the full list of sources, gaps, conflicts between Zalo's pages and the change log.

Text fields in responses are in English. The prices in this version are those in force from 16 March 2026; the OA plans those in force from 1 June 2026.

08 — Gaps

Unpublished figures and conflicting pages

What Zalo does not publish

We do not guess these figures. The calculator returns no price for them, and the API returns null with a status.

  • The price of the Cơ bản OA plan: the page lists its rights, and Zalo's news says a verified OA gets them without a purchase. page checked
  • The carousel price: absent from the visible table; 900 VND appears only in the service data. page checked
  • A separate price for the quick response template: in the table it falls under “other types”. page checked
  • UID prices of buttons and add-ons item by item: the page shows only the final UID price in its calculator. page checked
  • A fee for template review: not mentioned. page checked
  • The price of OA broadcasts above the free allowance of 4 a month per follower. page checked
  • The price of transaction messages sent through the OA API outside ZBS. page checked
  • The VAT rate for template messages: the pricing page only says that prices exclude VAT. page checked
  • A Mini App publishing fee or sales commission. page checked
  • The conditions for the journey price “from 200”: available from Zalo support only. page checked
  • The details of the payment request template update: only the news headline is public. page checked

Where Zalo's pages disagree

Where two official pages give different figures, we name both and say which one the calculator uses.

  • Template prices: the rendered pricing page and Zalo's announcement give the current figures; the raw page code before the data loads still holds lower figures, probably older ones, which Zalo does not explain. We use the current figures. [1][2]
  • Number of buttons: the technical specs allow 3, the CTA guide says 2. The calculator accepts 3; the template check warns above 2. [1][2]
  • Night window: the announcement of 16 November 2026 lets Tag 1 go round the clock and limits Tag 2 and Tag 3 to 07:00–22:00; the error tables describe a night ban without naming the tags, and the archived ZNS table gives a different hour. We follow the announcement, whose start date (15 October 2026) is earlier than its publication. [1][2][3]
  • OTP by UID: the pricing page and the error table say OTP goes by phone only, while the service data lists a UID price. We treat OTP as phone only. [1][2]
  • The cards of Zalo's calculator show UID prices (“from 210”), the table shows phone prices. Both are correct; they describe different sending methods. [1]
  • The price announcement is dated later than the dates in its own text. We use 16 March 2026, which also matches the date in the service data. [1]
  • The e-invoice button: a news item put it under the website category, the price table lists it as its own category. The price is the same either way: the first one is free. [1][2]
09 — Sources

Official pages used

We read every figure on Zalo's own pages and keep the link, the date and how we saw it: in the page table, only in the service data the page loads, or not published. The texts are our own summaries.

Reference figures, not a quote from Zalo. Check the linked official page before you rely on them.

Independent tool, not affiliated with Zalo or VNG.

10 — FAQ

Developer questions

Do I need an API key or a Zalo token?

No. Both the REST API and the MCP server are open and read-only, and they never ask for Zalo credentials. Only the per-address rate limit applies.

Does the API send messages through Zalo?

No. It returns prices, rules and checks from a dataset of Zalo's published pages. To send messages you need your own OA, a plan with API access and Zalo's API.

Why is validate-template POST only?

A template draft is text you wrote. A GET query string ends up in proxy and web-server logs; a request body does not. The endpoint answers no-store and does not keep the draft.

Where is the machine-readable description?

The OpenAPI document is at /api/v1/zalo/openapi.json. MCP clients get the tool input and output schemas from tools/list.

11 — Contact

Questions and data errors

Found a price that does not match Zalo's page, or need a different limit for a project? Write to us; one of the founders replies.