Actions23
- Address Book Actions
- Advanced Actions
- BlackList Actions
- One Time Password Actions
- Other Actions
- Shortener Actions
Advanced → Promotional Viber
AI-generatedSummary
Send promotional Viber messages with customizable text, sender, button caption and URL to multiple phone numbers with optional scheduling, duplicate checking, country code, and expiration settings.
Inputs
- Number — One or more recipient phone numbers, each added as separate entries in international format (including prefix) or using country code ISO 3166-1 alpha-2 format to form the full number.
- Text (required) — UTF-8 encoded text of the message to send (maximum 612 characters or 268 if Unicode is used).
- Sender (required) — Identifier to display as the sender of the message.
- Expiration — Time limit after which an alternative channel will be used if the Viber message cannot be delivered.
- Button Caption (required) — Text to display on the message's action button.
- Button URL (required) — URL to open when the button is pressed.
- Country — Country code (ISO 3166-1 alpha-2) to append to numbers without full international format for correct routing. Defaults to the user's set timezone country if omitted.
- Schedule — Scheduled sending time as a Unix timestamp or ISO 8601 formatted string.
- Duplicates Check — Option to prevent sending duplicate messages to the same number with the same text within a 5-minute interval; can be turned On or Off.
Output shape
a single JSON response object containing the API response to the promotional Viber message sending request
The operation returns the raw response from the Bulkgate API. If multiple numbers are specified, the response reflects the batch sending status. Error responses include failure details. No pagination applies.