Viber Business Message icon

Viber Business Message

Send messages through the Rakuten Viber Business Messages API

Actions8

Message → Send Text + Button

AI-generated

Summary

Send a text message to a Viber phone number, optionally with a button that opens a URL. The selected reach controls whether Viber sends it to all devices or smartphones only.

Inputs

  • Destination (required) — Complete destination phone number using digits only.
  • Label (required) — Choose Transaction or Promotion; sent as the message label for Viber’s internal use.
  • Reach — Choose All Devices (default) or Smartphone Only.
  • Message Text (required) — Text to send, up to 1000 characters. Supports Viber markdown and newline escapes.
  • Button Caption — Optional button label, up to 30 characters. Leave empty to hide the button.
  • Button / Action URL — Optional URL opened when the button is pressed.
  • Simplify — Defaults to true. Return status, sequence, message token, and session ID when present; turn off to include the full Viber response and request body.
  • Additional Fields — Optional sequence number, reporting tag, TTL, and tracking data. A sequence of 0 defaults to the current timestamp; TTL of 0 omits it and uses Viber’s default. Tracking data is included in the message.

Output shape

One output item per input item, each containing a JSON object.

With Simplify enabled, the JSON contains status, seq, messageToken, and sessionId when Viber returns one. With Simplify disabled, it contains the full Viber response and _requestBody. API failures throw unless Continue On Fail is enabled, in which case that input item gets an error field. A nonzero TTL must be between 30 and 1209600 seconds. If either button field is provided, the operation includes the provided caption and/or URL; otherwise it sends empty button fields.

Examples

Example 1: Send a promotional message to smartphones with an action button.

Set Label to Promotion, Reach to Smartphone Only, provide Message Text, Button Caption, and Button / Action URL.

Example 2: Send text without a visible button.

Leave Button Caption and Button / Action URL empty; the request includes empty button fields.

Links

Discussion