A critical notification fails to deliver: a customer doesn't receive a confirmation code, the order stalls, and SMS messages end up in spam. Such incidents cost businesses an average of 15% in lost revenue, according to analytics. To prevent this, we integrate Viber Business Messages—a channel with 90–95% delivery, Rich Media, and automatic SMS fallback. With over 5 years in mobile development and 40+ Viber integrations, our experts ensure reliable transactional messaging for financial, logistics, and service apps. Contact us for a project assessment.
How Viber PA API Works
Viber does not provide a direct REST API for developers without an intermediary. Messages are sent either through a Rakuten Viber Partner (direct access only for large enterprises with a contract) or via authorized aggregators: Infobip, SMSC, MessageBird, TurboSMS, and others. The aggregator provides its own REST API, which internally communicates with Viber. The full specification is available in the Infobip documentation.
A request via Infobip looks like this:
POST https://api.infobip.com/viber/1/message/bulk Authorization: App {API_KEY} Content-Type: application/json { "bulkId": "bulk-campaign-sample-1", "messages": [ { "from": "YourBrandName", "destinations": [{ "to": "380991234567" }], "viber": { "text": "Your order #98765 has been dispatched. Expect delivery today between 14:00 and 18:00.", "imageUrl": "https://cdn.yourbrand.com/delivery-banner.jpg", "buttonText": "Track order", "buttonUrl": "https://yourbrand.com/track/98765" } } ] } Rich messages (with image and button) are only for transactional purposes. Promotional messages with buttons require separate approval from Viber.
Choosing an Aggregator for Viber
The choice of aggregator affects cost, reliability, and geographic coverage. Below is a comparison of three popular ones:
| Parameter | Infobip | SMSC | MessageBird |
|---|---|---|---|
| Regions | Global | Ukraine, CIS, Russia | Europe, Asia |
| API | REST, webhook | REST, webhook | REST, webhook |
| Price per message | Medium | Low | High |
| Rich media support | Yes | Yes | Yes |
| SMS fallback | Yes | Yes | Yes |
We recommend Infobip for large projects with an international audience, SMSC for local markets, and MessageBird for complex multi-channel scenarios.
What Is SMS Fallback and How to Configure It?
The key feature of Viber Business: if the user doesn't have Viber or is unreachable, automatic SMS fallback can be configured at the aggregator level:
{ "messages": [{ "viber": { "text": "...", "validityPeriod": 15 }, "sms": { "text": "Short SMS version of the message" } }] } validityPeriod defines how many minutes to wait for Viber delivery before switching to SMS. After sending, the aggregator sends a webhook with the final status: DELIVERED_TO_VIBER, DELIVERED_TO_SMS, or UNDELIVERABLE. According to Viber PA API documentation, proper fallback handling reduces delivery loss to under 5%.
Why Viber Business Outperforms Plain SMS
Viber Business provides a verified account with branding, high delivery rate (90–95% vs. 80% for plain messages), and official analytics. Statistics show Viber Business delivers messages twice as often as SMS and three times faster—within seconds. It cuts SMS campaign costs by up to 40%. For a typical project sending 100,000 messages per month, this means a budget saving of up to 40%. Contact us to calculate the impact for your project.
Mobile Side: What Is Implemented in the App
The app doesn't work directly with the Viber SDK—it calls your backend, which sends messages through the aggregator. On the mobile side:
- A form for creating Viber messages with Rich Media (image upload, button, text).
- Message preview before sending.
- Campaign launch and status tracking.
// Android—creating a Viber message data class ViberMessage( val recipientPhone: String, val text: String, val imageUrl: String? = null, val buttonText: String? = null, val buttonUrl: String? = null ) suspend fun sendViberMessage(message: ViberMessage): MessageResult { return apiClient.post("/notifications/viber", message) } The backend processes webhooks and stores statuses. The mobile app requests aggregated statistics:
struct ViberCampaignStats: Decodable { let total: Int let deliveredViber: Int let deliveredSms: Int let failed: Int let pending: Int } How We Integrate Viber: Our Process
- Analysis: Choose the aggregator, design the sending and webhook processing scheme.
- PA Registration: Assist with application and brand verification (takes 2–5 business days).
- API Development: Build REST layer on the backend to communicate with the aggregator.
- Mobile UI: Implement rich-message sending forms and statistics screens.
- Testing: Verify all scenarios—delivery, fallback, error handling.
- Deployment: Set up monitoring, documentation, and support.
What’s Included in the Work
- Analysis of current infrastructure and aggregator selection (Infobip, SMSC, MessageBird, or others)
- Public Account registration and brand verification (up to 5 business days)
- REST API development for sending and webhook processing
- Mobile app integration (sending forms, statistics)
- Testing of all scenarios: delivery, fallback, errors
- API documentation and 1 month of post-launch support
Timeline and Cost
Basic integration takes 4–7 business days (excluding PA verification). Cost depends on complexity and chosen aggregator—contact us for a one-day project estimate.
Case Study: Logistics Client
For a logistics company processing 100,000 daily orders, we integrated Viber Business via Infobip. The result: 95% delivery rate for order updates, 40% reduction in SMS costs, and the remaining 5% covered by SMS fallback. The client reported a 30% drop in support inquiries about order status.
Use Cases for Viber Business
| Scenario | Example | Outcome |
|---|---|---|
| Transactional notifications | Order status, confirmation codes | 95% delivery, SMS fallback |
| Marketing campaigns | Promotions, new arrivals | 15% CTR, 8% conversion |
| Service alerts | Reminders, schedule changes | 30% reduction in missed appointments |
Contact us to review your case and recommend the optimal solution.







