> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/technical-guides/communication-gateways/supported-viber-gateways.md).

# Supported Viber gateways

Smartico sends Viber business messages to players through Viber providers. Depending on the provider, a message can carry an image and a button, and can fall back to SMS when Viber delivery fails.

Viber gateways are configured in the Back-Office under **Label Settings → Gateways → Instant messages**. For the Viber asset itself, see [SMS, Viber, and WhatsApp](https://help.smartico.ai/welcome/products/crm-automation/communication-channels/sms-viber-and-whatsapp).

***

## How Viber Gateway Configuration Works

Viber gateways are added in the Back-Office under **Label Settings → Gateways → Instant messages**. Adding a gateway opens a wizard:

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-096fdb405f830ee8cca6d0c659fa43b87d34eb4f%2Fa56a1c8a5c-viber-type-5555422a-324150.png?alt=media" alt=""><figcaption><p>Label → Gateways → Instant messages → Create: 1 — Instant messages, 2 — Type: Viber, 3 — the Viber providers</p></figcaption></figure></div>

1. **Add IM gateway**: Select **Type: Viber**, then select the provider from the list. The list shows only the providers of the selected type.
2. **Conditions**:
   * **Name**: A name for internal identification.
   * **Brand**: On multi-brand labels, restrict the gateway to one brand, or leave **Any**.
   * **Set as default gateway**: Only one gateway can be the default at a time. Turn off the current default first.
   * **Gateway selection properties**: If gateway selection properties are set up for your label, the screen shows one field per property, named after the property (such as country or language). Pick the values for which this gateway is used during automatic selection. Ask your Smartico Success Manager to set the properties up.
3. **Authentication & Configuration**: Enter the credentials and settings the provider needs. The fields depend on the provider (see the catalog below).
   * **Additional parameters**: A key-value editor to pass extra settings that the form does not show. Use it only for keys your Smartico contact names for the provider.
   * **Callback URL**: For providers that report delivery statuses to Smartico, the full Callback URL for your environment is shown on this screen. Copy it into the provider account (or into the callback field of the form, when there is one).
4. **"From" config**: Enter the Viber sender name registered with the provider.

If you change "From" values that existing campaigns use, a **'From' changes** screen asks you to confirm how those campaigns are updated before saving.

***

## Supported Viber Gateways Catalog

Below is the list of Viber providers supported by Smartico, with the fields the Back-Office asks for (names as in the wizard) and the provider-side setup.

***

### 1. AlphaSMS Viber

* **Provider links**: [Website](https://alphasms.ua) · [JSON API request format (auth = API key from the account)](https://docs.alphasms.ua/ru/api/json/) · [Send Viber text (JSON API)](https://docs.alphasms.ua/ru/api/json/viber/text/) · [Message status (JSON API)](https://docs.alphasms.ua/ru/api/json/message_status/) · [Callback notifications](https://docs.alphasms.ua/ru/api/http/callback/)
* **Back-Office Configuration Fields**:
  * `URL` *(Required)*: URL of AlphaSMS API.
  * `API_KEY` *(Required)*: Authentication for the AlphaSMS API.
  * `Viber Signature` *(Optional)*: Viber sender name configured in AlphaSMS. Default is the From field.
  * `Fallback to SMS` *(Optional, Default: `Off`)*: Redirect messages to SMS if Viber fails.
  * `Viber Lifetime` *(Optional)*: Viber message lifetime in seconds. Min value is 60 (1 minute), Max value is 86400 (24 hours). If not specified, the default value will be 120.
  * `Shorten url in Alpha` *(Optional, Default: `Off`)*: AlphaSMS shortens links and tracks clicks (charged by AlphaSMS).
* **What this gateway supports**:
  * Supports an image and a button from the Viber asset, and an optional **Fallback to SMS** when Viber delivery fails.
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

### 2. BSG Viber

* **Provider links**: [Website](https://bsg.world) · [BSG API v1.0 - Viber (api.bsg.world/rest/viber/create, X-API-KEY)](https://docs.bsg.dev/api/api-v.1.0/viber) · [Quick start / platform registration](https://docs.bsg.dev/quick-start)
* **Back-Office Configuration Fields**:
  * `API Endpoint URL` *(Required, Default: `https://api.bsg.world/rest/viber/create`)*: Enter the URL for BSG SMS endpoint where the SMS request will be sent.
  * `API Key` *(Required)*: Enter the API key for authenticating with the BSG service.
  * `Sender ID` *(Required)*: Enter the sender ID that will appear on the recipient's phone.
* **What this gateway supports**:
  * Supports an image, a button caption and a button link from the Viber asset.
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

### 3. Infobip Viber

* **Provider links**: [Website](https://www.infobip.com) · [Send Viber messages (API)](https://www.infobip.com/docs/api/channels/viber/viber-business-messages/outbound-message/send-viber-messages) · [Receive Viber delivery reports (notifyUrl)](https://www.infobip.com/docs/api/channels/viber/viber-business-messages/message-status-reports/receive-outbound-viber-message-delivery-reports) · [API authentication / API keys](https://www.infobip.com/docs/essentials/api-essentials/api-authentication) · [Viber Business Messages: sender setup](https://www.infobip.com/docs/viber)
* **Back-Office Configuration Fields**:
  * `API Endpoint URL` *(Required)*: Enter the URL for Infobip Viber endpoint where the SMS request will be sent.
  * `API Key` *(Required)*: Enter your Infobip API key.
  * `Callback URL` *(Required)*: Enter the URL where Infobip will send the delivery status updates.
* **What this gateway supports**:
  * Supports an image, a button caption and a button link from the Viber asset.
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

### 4. Kyivstar Viber Promotional

* **Provider links**: [Website](https://kyivstar.ua/) · [Kyivstar API Portal (EN): OAuth2 token, SMS and Viber endpoints, webhooks](https://api-gateway.kyivstar.ua/en/)
* **Back-Office Configuration Fields**:
  * `Viber API URL` *(Required, Default: `https://api-gateway.kyivstar.ua/rest/v1/viber/promotion`)*
  * `Authentication URL` *(Required, Default: `https://api-gateway.kyivstar.ua/idp/oauth2/token`)*
  * `Client ID` *(Required)*
  * `Client Secret` *(Required)*
  * `Message TTL (seconds)` *(Optional)*
* **What this gateway supports**:
  * Kyivstar Viber **promotional** messages. Supports an image, a button caption and a button link (a button needs an image).
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

### 5. MessageWhiz Viber

* **Provider links**: [Website](https://mmdsmart.com/messagewhiz/) · [MessageWhiz API – 2-way messaging: Send message (POST /chats/api/v1/messages, used for Viber)](https://sms.messagewhiz.com/api-doc#tag/2way-messaging-API/operation/SendMessage) · [MessageWhiz API – 2-way webhooks (status / inbound)](https://sms.messagewhiz.com/api-doc#tag/2way-webhooks-API) · [MMDSmart Viber channel overview](https://mmdsmart.com/viber/)
* **Back-Office Configuration Fields**:
  * `API Endpoint URL` *(Required, Default: `https://sms.messagewhiz.com/chats/api/v1/messages`)*: Enter the URL for MessageWhiz Viber endpoint where the SMS request will be sent.
  * `API Key` *(Required)*: Enter your MessageWhiz API key.
* **What this gateway supports**:
  * Supports an image, a button caption and a button link from the Viber asset.
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

### 6. UniTalk Viber

* **Provider links**: [Website](https://unitalk.cloud) · [UniTalk API reference (API key from my.unitalk.cloud > API, Authorization header)](https://unitalk.cloud/api-references/)
* **Back-Office Configuration Fields**:
  * `URL` *(Required, Default: `https://api.unitalk.cloud/api/message/send`)*: URL of UniTalk Viber API.
  * `AUTHORIZATION` *(Required)*: Full Authorization value for the UniTalk API (with the prefix).
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

## Viber Gateways Listed Under Custom IM

The following Viber providers are selected with **Type: Custom IM** in the wizard. Their message content (for example the template name and its variables) comes from extra fields in the asset, which Smartico enables for your label on request.

***

### 7. AlphaSMS Viber (Custom IM)

Listed in the wizard under **Type: Custom IM**.

* **Provider links**: [Website](https://alphasms.ua) · [JSON API request format (API key / auth)](https://docs.alphasms.ua/api/json/) · [Send Viber with SMS fallback (JSON API)](https://docs.alphasms.ua/api/json/viber/resending_sms/) · [Send Viber text (JSON API)](https://docs.alphasms.ua/api/json/viber/text/) · [Webhook: delivery report (JSON API)](https://docs.alphasms.ua/api/json/webhook/)
* **Back-Office Configuration Fields**:
  * `URL` *(Required)*: URL of AlphaSMS API.
  * `API_KEY` *(Required)*: Authentication for the AlphaSMS API.
  * `Viber Signature` *(Optional)*: Viber sender name configured in AlphaSMS. Default is the From field.
  * `Fallback to SMS` *(Optional, Default: `Off`)*: Redirect messages to SMS if Viber fails.
  * `Viber Lifetime` *(Optional)*: Viber message lifetime in seconds. Min value is 60 (1 minute), Max value is 86400 (24 hours). If not specified, the default value will be 120.
  * `Shorten url in Alpha` *(Optional, Default: `Off`)*: AlphaSMS shortens links and tracks clicks (charged by AlphaSMS).
* **What this gateway supports**:
  * Same AlphaSMS Viber integration as above, listed under **Type: Custom IM**, for assets that use custom Viber layouts.
* **Provider-Side Setup**:
  * Set the **Callback URL** from the gateway configuration screen in the Back-Office as the delivery status URL in your provider account (or paste it into the callback field of the form, when there is one).
  * Register your Viber business sender name with the provider.

***

## Frequently Asked Questions (FAQ)

### Where do I find the Callback URL for delivery reports?

Open the gateway in **Label Settings → Gateways → Instant messages** and go to the **Authentication & Configuration** screen. The Callback URL is generated for your environment and shown there for every provider that reports statuses. Do not build it by hand.

### How does automatic gateway selection work when several Viber gateways are configured?

When a campaign uses automatic selection, Smartico picks the gateway at send time from the gateways whose **Brand** and gateway selection property values match the player. Use **Set as default gateway** on the gateway that should be used by default.

### What should I do if our preferred Viber provider is not listed?

1. **Your secured gateway**: Connect your own sending service through the [Secured Messaging Gateways (Email/SMS/IM)](https://help.smartico.ai/welcome/technical-guides/communication-gateways/secured-messaging-gateways-email-sms-im.md) API.
2. **Request a new integration**: Contact your Smartico Customer Success Manager or Integration Manager with the provider's API documentation.

### Where are the general instructions for instant message gateways?

See the [Instant Messages Gateway guide](https://help.smartico.ai/welcome/technical-guides/communication-gateways/instant-messages-gateway-guide.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartico.ai/welcome/technical-guides/communication-gateways/supported-viber-gateways.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
