Viber Business Message icon

Viber Business Message

Send messages through the Rakuten Viber Business Messages API

Actions8

Message → Send Video

AI-generated

Summary

Send a video to a Viber Business Messages recipient using the selected video layout. Include a video URL, thumbnail, file size, and duration; the node adds tracking data automatically when required by the selected message type and returns either a simplified status response or the full Viber payload.

Inputs

  • Destination (required) — Complete recipient phone number using digits only.
  • Label (required) — Select Transaction or Promotion; Viber uses this label internally.
  • Layout — Choose Video Only, Video + Text, Video + Text + Button (opens the video), or Video + Text + Action Button (opens a URL). Defaults to Video + Text.
  • Video URL (required) — HTTPS URL ending in .mp4. The host must allow HEAD requests and return Content-Length.
  • Thumbnail URL (required) — Static image URL used as the video preview.
  • File Size (Bytes) (required) — Video size in bytes; the node rejects values over 200 MB.
  • Duration (Seconds) (required) — Video duration in seconds; the node rejects values over 600 seconds.
  • Message Text — Optional caption shown with layouts that include text. The node checks that it does not exceed 1000 characters.
  • Button Caption — Optional button text for either button layout; the node checks that it does not exceed 30 characters.
  • Button / Action URL — Destination URL for the Action Button layout, which opens a URL. The Video + Text + Button layout uses the video URL as its action.
  • Simplify — Defaults to true. When enabled, return status, sequence, message token, and session ID if present; when disabled, return the full response with the request body.
  • Additional Fields — Optional sequence number, reporting tag, TTL, and tracking data override. Sequence defaults to the current timestamp when zero; TTL defaults to 14 days when zero and otherwise must be 30–1,209,600 seconds. Tracking data is included automatically for video message types that require it; a supplied value overrides the default empty value.

Output shape

One output item for each input item, containing a JSON response object.

With Simplify enabled, the JSON contains status, seq, messageToken, and sessionId when provided. With it disabled, the JSON contains the full Viber response plus _requestBody. If Continue On Fail is enabled, failed items contain an error field. Nonzero Viber status responses are raised as errors.

Links

Discussion