Module 1: Viber Message Types
1. Transactional Messages
Message Format: Plain text (including links and files), up to 1000 characters.
Message Content: Notifications related to specific user actions or status, such as order confirmation, login alerts, or service warnings.
Example Scenarios:
| Scenario Category | Specific Content |
|---|---|
| Orders & Reservations | Sending order confirmations, booking confirmations, receipts |
| Travel Notifications | Travel status updates (e.g., shipped, delivered, etc.) |
| Date Reminders | Notifications for upcoming appointments, bookings, trips |
| Account Security | New login to user account |
| Password Management | Password expiration reminders, password change notifications |
| Transaction Notifications | Transaction completion notifications |
| Service Alerts | Service-related reminders (e.g., upcoming service interruptions) |
| Subscription & Payments | Subscription renewal payment reminders |
2. Promotional Messages
Messages Format: containing images, videos, or buttons (including image-based OTP).
Message Content: Contains commercial promotions, offers, discounts, or calls to action. When a message contains both transactional and promotional information, it must be sent as a promotional message.
Example Scenarios:
| Scenario Category | Specific Content |
|---|---|
| Seasonal Promotions | New product launches, special promotions / discount campaigns |
| Add-on Recommendations | Cross-selling or upselling of complementary products |
| Cart Reminders | Abandoned cart reminders |
| Financial Promotions | Financial product offers (excluding loans) |
| Non-Gambling Activities | Sweepstakes or prize draws (non-gambling) |
| Membership Benefits | Exclusive offers for club members |
| Gifts & Rewards | Gift giveaways, reward distributions |
3. Session Messages
Supports plain text, plain image, or plain file only.
Session Conditions:
When an end user initiates a conversation, if the business sends a session-type message, a 24-hour session window is triggered.
Session Limitations:
- Each session allows up to 60 messages to be sent to the user. Once the limit is reached, the session ends.
- Within a session, a business can send up to 10 consecutive session-type messages without requiring a user response. · The 11th consecutive message will result in an error and will not be sent. · Only after the user responds can the business continue sending session-type messages within the same session.
Note: Currently, the NXLink platform does not support session messages. To use session-based billing, you must integrate via the API.
4. OTP Templates
Viber provides 9 fixed OTP templates officially. · When sending Viber messages, businesses can specify the corresponding template ID to send directly without additional approval.
Note: NXLink does not support this type of message.
- It is only available through NXCloud API integration.
- For details, please refer to the Viber Message API Integration Documentation.
Module 2: Viber Billing Methods
Transactional, OTP Template, and Promotional messages → billed per successfully delivered message.
Session-Based Billing (not supported by NXLink at the moment)
- You are billed per session (per session ID) rather than per individual message sent.
- Each session ID is billed based on the predefined target country/region rate.
- All other message types can still be used within a session, but they will be charged individually per message at the normal rate. Only session-type messages are included in the session-based billing.
- If you initiate a chat with a session-type message and the user has not interacted with you in the past 24 hours, you will be charged the “outside session” rate per message. Once the user responds, a new session begins, and billing switches to the session-based rate.