Zalo OAInstall

Summary

Sends a ZBS Template Message to a phone number

Inputs

• phone (required) — Recipient phone number in international format (e.g., 84987654321 or +84987654321)
• templateId (required) — ID of the approved ZBS template
• templateData (required) — JSON object containing template variables
• trackingId — Optional custom tracking ID (max 48 characters)
• sendingMode — Send mode: 1 for normal (within limit) or 3 for over‑limit (requires whitelisting)

Output shape

an object containing the Zalo API response (e.g., success flag, message data)

Returns the API response; rate‑limit or token errors are thrown as NodeOperationError; token refresh must be handled separately.

Examples

Example 1: Send a promotional message to a new customer

phone: 84912345678, templateId: TMPL123, templateData: {"customer":"Nguyễn Văn A","amount":"100.000"}, sendingMode: 1

Links

• n8n community nodes installation guide