Skip to main content
Glama

Zalo Business Reference (ZBS Template Message, OA)

Server Details

ZBS (ZNS) message prices, OA plans, template checks, sending rules and Zalo error codes. Unofficial.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
since98vn/vietnam-mcp-servers
GitHub Stars
0
ChatGPT
–
Claude
–

TDQS

A4/5.0

Scored across 7 tools

Disambiguation4/5

Each tool maps to a distinct reference concern: sending-window rules, channel choice, pricing, OA plan comparison, template validation, error decoding, and data provenance. There is mild overlap between check_sending_rules and estimate_message_cost (both touch daily quota) and between choose_channel and check_sending_rules (both touch sending windows), but the descriptions make the boundaries clear enough for correct selection.

Naming Consistency4/5

All names are snake_case and readable, with four verb_noun forms (check_sending_rules, choose_channel, estimate_message_cost, validate_template). Three are noun-first (data_info, error_lookup, oa_plan_compare), which is a minor deviation rather than a real inconsistency.

Tool Count5/5

Seven tools is well within the ideal 3-15 range and each covers a genuinely different reference area of the Zalo ZBS/OA domain. Nothing looks redundant or like filler, and the surface is small enough for an agent to hold in mind.

Completeness4/5

For a reference-only server, coverage is strong: rules, channel guidance, cost estimation, plan selection, template validation, error lookup, and data provenance are all present. Minor gaps exist around a dedicated tag/template-type catalog lookup and OA quota upgrade guidance beyond the single rule check, but agents can work around these with the existing tools.

Available Tools

7 tools
check_sending_rulesCheck ZBS sending window, quota and promotion limitsA
Read-onlyIdempotent
Inspect

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}.

Inputs: tag (required), delivery, send_time, quota_level, +4 more. Returns: tag, quota, window, allowed, +5 more

choose_channelChoose a Zalo channel for a taskA
Read-onlyIdempotent
Inspect

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}.

Inputs: task (required), is_follower, last_interaction_hours. Returns: task, notes, disclaimer, affiliation, +3 more

data_infoZalo reference data: sources and gapsA
Read-onlyIdempotent
Inspect

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: {}.

Inputs: no named parameters. Returns: sources, data_date, disclaimer, affiliation, +3 more

error_lookupZalo error code lookupA
Read-onlyIdempotent
Inspect

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}.

Inputs: code (required), table. Returns: code, found, matches, disclaimer, +2 more

estimate_message_costZBS template message cost (Zalo)A
Read-onlyIdempotent
Inspect

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}.

Inputs: count, image, buttons, delivery, +5 more. Returns: count, lines, notes, quota, +12 more

oa_plan_compareZalo OA plan comparisonA
Read-onlyIdempotent
Inspect

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}.

Inputs: staff, features, needs_api, term_months, +2 more. Returns: notes, plans, reason, disclaimer, +3 more

validate_templateCheck a ZBS template draft (formal rules)A
Read-onlyIdempotent
Inspect

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}}.

Inputs: tag, logo, name, table, +7 more. Returns: valid, errors, issues, warnings, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      LoginWA MCP: WhatsApp OTP, device status, send message, and broadcast for AI agents. LoginWA hosts the WhatsApp session, so no VPS, no Baileys to babysit, no reconnect loops. Free tier 100 messages a month, paid from $1. Pricing: https://loginwa.com/pricing
      8
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to run one or many LINE Official Accounts through natural language, covering broadcasts, Flex and tappable Rich Messages, rich menus, audiences, coupons, insights, and LINE Shopping. Includes quota and quiet-hour guardrails, Thai-localized templates, and zero-setup image hosting with verification before a send is reported as successful.
      141 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to send WhatsApp, Telegram, SMS, VK/OK, and MAX messages, files, and bulk mailings, and to manage delivery status, webhooks, and sub-accounts.
      19
      336 npm
      18
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.