Docs

Send a Viber Single Message

Sends a Viber single message with Routee.

POST

Query

Field selectionChoose which fields should be included in the response. Learn more
string

Comma-separated response fields to include.

Body

Arguments
stringrequired

The unique sender id. You can find it at [Routee Platform-applications page](https://dev.routee.net/#/management/applications).

stringrequired

The phone number the message is about to be sent to. Format with a '+' and country code e.g., +3069xxxxxxxx (E.164 format).

object

The body containing the content of the message.

string

The text of Viber message. Maximum number of characters supported in a Viber message is 1000 characters. Use [~{labelName}] in order to send personalized messages, by using the labels of your contacts. [Text only messages are billed as Transactional. All the other message types are charged as Promotional].

string

The URL of the image (recommended image size: 400KB for optimal delivery; image URL length: max 1000 characters; only valid and secure URL starting with https://).

object

Represents the action (button) of the Viber message.

string

The displayed text on the button (1-30 characters).

string

The target URL of the Viber action.

object

Represents the Viber file of the Viber message.

stringrequired

The name of the file. Max size 25 chars.

stringrequired

Type of Viber message file. The supported file types are following: For document: doc, .docx, .rtf, .dot, .dotx, .odt ,odf, .fodt, .txt, .info; For PDF: pdf, .xps, .pdax, .eps; For Spreadsheet: .xls, .xlsx, .ods, .fods, .csv, .xlsm, .xltx .

stringrequired

The URL of the document (recommended file size: 600KB for optimal delivery) (document URL length: up to 1000; only valid and secure URL starting with https://).

object

Represents the Viber video of the Viber message.

stringrequired

The URL where the video is hosted (1000 max chars, only https).

stringrequired

The URL of a thumbnail for the video (1000 max chars, only https).

numberrequired

The file size in MB (positive number, 200 max).

numberrequired

The video’s duration in seconds (positive number, 600 max).

number

Time range until message expires. TTL range in seconds: 30 - 86400 seconds. If it is not set, the default range is 14 days.

string

Defines the callback URL that will receive all the individual messages' progress of the Viber campaign.

string

Defines the callback URL that will receive the inbound messages.

string

A generic label which can be used for tagging the Viber message. Maximum length is 350 characters.

boolean

Indicates a Viber Single is a Viber Session if the value is true. False by default. Learn more about session messaging at our [documentation](https://docs.routee.net/docs/send-a-viber-session).

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is
One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.
Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.
Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.