Viber Business MessageInstall

Summary

Sends an image or animated GIF to a Viber Business recipient, optionally including text and an action button. Choose an image layout for all devices, smartphones, or a session; button layouts support optional message text and button details.

Inputs

• Destination (required) — Recipient’s complete phone number using digits only.
• Label (required) — Classifies the message as a transaction or promotion for Viber’s internal purposes.
• Layout — Select image-only or text-and-image-with-button, and choose the supported device reach. Defaults to Image Only (All Devices).
• Image URL (required) — HTTPS URL to a PNG, JPEG, or GIF image, with a file extension.
• Animated GIF — Marks the image as an animated GIF when the selected image type supports it. Recipient devices need Viber 28.1 or later.
• Button Caption — Optional button text, up to 30 characters; shown for button layouts.
• Button / Action URL — Optional URL opened when the button is pressed; shown for button layouts.
• Message Text — Optional text shown with the image; used by button layouts.
• Simplify — Defaults to true. When enabled, returns status, sequence, message token, and session ID when present; otherwise returns the full Viber response with the request body.
• Additional Fields — Optional sequence, reporting tag, TTL (30–1,209,600 seconds; 0 uses the service default), and tracking data. Sequence defaults to a timestamp when set to 0.

Output shape

One n8n output item per input item, containing the Viber send response or an error item when continue-on-fail is enabled.

With Simplify enabled, the response contains status, seq, messageToken, and sessionId when provided. With it disabled, the full API response is returned with _requestBody. The request is sent to the Viber Business Messages API; nonzero Viber status codes raise an error.

Links

• n8n community nodes installation guide