Viber Business MessageInstall

Summary

Send an approved Viber template to a destination phone number, substituting template variables supplied as key-value fields or a JSON object. Choose the template’s language and delivery reach; the operation posts the message through the Viber Business Messages API.

Inputs

• Destination (required) — Complete phone number using digits only, without spaces, a plus sign, or special characters.
• Label (required) — Select Transaction or Promotion; this declares the message’s nature for Viber internal purposes and does not affect billing.
• Reach — Send to all devices (default) or smartphones only.
• Template ID (required) — ID of the approved template to send.
• Template Language (required) — Locale code that must match a language configured for the template, such as en or he.
• Parameters Input — Choose key-value pairs (default) or JSON for supplying template variables.
• Template Parameters — In key-value mode, add variables by their template-defined names and values. Values are limited to 125 characters; OTP templates require a non-empty pin.
• Template Parameters (JSON) — In JSON mode, provide an object of template variables and values. OTP templates require a non-empty pin.
• Simplify — Defaults to true: return status, sequence, message token, and session ID when present. Turn off to return the full Viber response with the request body.
• Additional Fields — Optional sequence (uses a timestamp when set to 0), reporting tag, TTL in seconds (0 uses Viber’s 14-day default; nonzero values must be 30–1209600), and tracking data.

Output shape

One n8n item per input item, each containing a JSON response.

By default, each response includes status, seq, messageToken, and sessionId when present. With Simplify disabled, the full Viber response is returned with _requestBody. Viber rejections and invalid inputs raise errors; with Continue On Fail enabled, an item contains {"error":"..."} instead.

Links

• n8n community nodes installation guide