ZBS template message cost (Zalo)
estimate_message_costEstimate 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}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "estimate_message_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of messages (1-100000000). Default 1. | |
| image | No | Image module (1-3 images) included. Default false. Not allowed on OTP. | |
| buttons | No | 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 | No | 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 | No | 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 | No | Quick reply (response) buttons activated. Default false; always on for quick_response. | |
| quota_level | No | 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 | No | Expected share of messages that get delivered and charged, 0-1 (default 1 = all). Only delivered messages are charged. | |
| template_type | No | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| lines | Yes | ||
| notes | Yes | ||
| quota | Yes | ||
| sources | Yes | ||
| delivery | Yes | ||
| warnings | Yes | ||
| total_max | Yes | ||
| disclaimer | Yes | ||
| affiliation | Yes | ||
| per_message | Yes | ||
| data_version | Yes | ||
| plan_required | Yes | ||
| template_type | Yes | ||
| total_estimated | Yes | ||
| delivered_estimate | Yes |