Introduction
Viber is a cross-platform voice-over-IP and instant messaging software application that is secure, fast, and synchronized across all devices. Through Viber, brands can engage with their users using rich messaging with which they can easily interact.
MoEngage <> Viber
MoEngage and Viber integration allows you to leverage advanced segmentation, predictive capabilities, personalization, and triggering features to message your users on the Viber Bot through the Viber APIs.
Use Cases
The integration with MoEngage helps you with the following use cases:
- Personalized Messaging: You can send personalized messages to users based on their preferences.
- Rich Media Content: You can make messages more visual with images, videos, and files through Viber messages.
- Automated Campaigns: You can send messages automatically at scheduled times or trigger messages based on user actions.
Methods to Send Messages via Viber Integration
You can send messages via Viber integration with the following methods:
- Native APIs: You can use MoEngage campaigns to send messages using Viber APIs.
- Infobip Connector: You can send messages to your Viber users using the Infobip connector.
Integration via Native
library_add_check |
Prerequisites
|
Viber allows you to send promotional and non-promotional messages to users, provided your brand has secured their consent. Users must have subscribed to your Viber bot to receive messages.
info |
Information
|
Step 1: Connect Viber on the App Marketplace
To connect Viber on the App marketplace, perform the following steps:
- On the left navigation menu in the MoEngage dashboard, click App marketplace.
- On the App Marketplace page, search for Viber.
- Click the Viber tile.
- On the Viber page, go to the Integrate tab.
- Click the
down arrow key and then click Send messages (Native).
- Enter the following details:
Field Required Description Connection name Yes Name of the Viber connection. Viber Auth Token Yes
Your Viber Auth token. The authentication token is generated upon bot creation, and the account’s admins can view it on the “edit info” screen of their bot or on the Viber Admin Panel. For more information, refer here.
Sender Name Yes
The sender’s name to be displayed.
Sender Avatar URL Optional
This is the sender’s avatar URL.
Note: The avatar's maximum size must not exceed 100 KB. The recommended resolution is 720x720 pixels.
- Click Connect. Your Viber connection is now integrated.
Step 1.1: Collect Users' Viber IDs
To send messages in Viber, you must collect your users’ Viber IDs to identify and interact with them consistently. Viber users' IDs are generated by Viber and can be used when interacting with Viber APIs.
Step 1.2: Save the Users' Viber IDs on MoEngage
After obtaining a list of Viber users' IDs, you must add them to MoEngage as a viber_id, a custom-tracked user attribute or property. You can do one of the following:
- Pass this data to MoEngage using the User Data API.
- Upload it using User Imports inside MoEngage.
Step 2: Create a Viber Campaign on MoEngage
To create a campaign on MoEngage, perform the following steps:
- On the left navigation menu in the MoEngage dashboard, click Engage, and then click Campaigns
- On the All campaigns page, click + Create campaign.
- On the Create campaign dialog box, under Connected Apps, click Viber and then click the most suitable delivery type.
- Under Select audience, click Filter users by.
- On the User property tab, select the segment of users for whom Viber_id exists (you can combine it with other segment criteria).
- In step 2 of the Campaign Creation, select the native message connector and specify the content you want to send out.
- Enter the following details:
Field Required Description Connector Yes Select Send messages (Native) in this list. Connections Yes Select the connection that you added to the MoEngage App marketplace. Receiver ID Yes Type the Receiver ID. It is the recipient's unique Viber user ID. You can also use personalization here. Tracking ID Yes This allows the account to track messages and user’s replies. The sent tracking_data value will be passed back with the user’s reply. You can enter a maximum of 4096 characters.
-
Select the Message Type you want to send. The supporting message types are Text, Picture, and Video. Based on the selected message type, enter the following details:
If you select Text, enter the following details:
Field Required Description Message Content Yes Text of the message you want to send. You can also use personalization here.
Note: You can enter a maximum of 7000/768 characters.
Media URL No Leave this blank.
Video Size No Leave this blank. Video Duration No Leave this blank. If you select Picture, input the following fields:
Field Required Description Message Content Yes The description of your picture message. You can also use personalization here.
Note: You can enter a maximum of 7000/768 characters.Media URL Yes This is URL of the image being sent. It must be a valid URL starting with https:// or http://. The supported image types are .jpg, .jpeg, and .png. The recommended resolution is 800 x 800 pixels. You can also use personalization here.
Video Size No Leave this blank. Video Duration No Leave this blank. If you select Video, input the following fields:
Field Required Description Message Content No Leave this blank.
Media URL Yes This is URL of the video being sent. It must be a valid URL starting with https:// or http://. It must supported video types are 3gp, m4v, mov, and mp4. You can also use personalization here.
Note: The maximum allowed video size is 200 MB.Video Size Yes This is the size of the video in bytes. Video Duration Yes This is the duration of the video. This is required with a maximum limit of 180 seconds. -
Your campaign is now ready to be tested and sent. Using the Test functionality, you can also test your connector configuration.
If your test user successfully receives the message, your setup is ready.
-
Publish the campaign.
Integration via Infobip
library_add_check |
Prerequisites
|
Step 1: Connect Viber on the App Marketplace
To connect Viber on the App marketplace, perform the following steps:
- On the left navigation menu in the MoEngage dashboard, click App marketplace.
- On the App Marketplace page, search for Viber.
- Click the Viber tile.
- On the Viber page, go to the Integrate tab.
- Click the
down arrow key and then click Send messages (Infobip).
- Enter the following details:
Field Required Description Connection name Yes Name of the Viber connection. API Base URL Yes
This is a unique API base URL provided by each Infobip client to identify the source of each API request. For more information, refer here.
API Key Yes It is your Infobip API key. For more information, refer here. - Click Connect. Your Viber connection is now integrated.
Step 1.1: Collect Users' Viber IDs
To send messages in Viber, you must collect your users’ Viber IDs to identify and interact with them consistently. Viber users' IDs are generated by Viber and can be used when interacting with Viber APIs.
Step 1.2: Save Users Viber IDs on MoEngage
After obtaining a list of Viber users' IDs, you must add them to MoEngage as a viber_id, a custom-tracked user attribute or property. You can do one of the following:
- Pass this data to MoEngage using the User Data API.
- Upload it using User Imports inside MoEngage.
Step 2: Create a Viber Campaign on MoEngage
To create a campaign on MoEngage, perform the following steps:
- On the left navigation menu in the MoEngage dashboard, click Engage, and then click Campaigns
- On the All campaigns page, click + Create campaign.
- On the Create campaign dialog box, under Connected Apps, click Viber and then click the most suitable delivery type.
- Under Select audience, click Filter users by.
- On the User property tab, select the segment of users for whom viber_id exists (you can combine it with other segment criteria).
- In step 2 of the Campaign Creation, select the send message Infobip connector and specify the content you want to send out.
- Enter the following details:
Field Required Description Connector Yes Select Send messages (Native) in this list. Connections Yes Select the connection you added to the MoEngage App marketplace. Sender ID Yes Type the Sender ID. This is a unique identifier of your Viber account. It can be alphanumeric or numeric. You can also use personalization here.
Note: You can enter a maximum of 11 characters.User mobile number Yes Type the user's mobile number. You can also use personalization here.
Note:
- You must use the Distributed Ledger Technology (DLT) parameters to send SMS messages to phone numbers registered in India.
- You must use the IYS regulations parameters to send SMS messages to phone numbers registered in Turkey.
- You must use the use case-dependent parameters to send SMS messages to phone numbers registered in South Korea.
-
Select the Message Type you want to send. The supporting message types are Text, Image, Video, and File. Based on the selected message type, enter the following details:
If you select Text, input the following fields:
Field Required Description Message Yes Content of the message being sent. You can also use personalization here.
Note: You can enter a maximum of 1000 characters.
Button Text No This is the text that will appear on the action button. You can also use personalization here. It is required only if adding a button.
Note: You can enter a maximum of 30 characters.
Button Action URL No This is the URL users are directed to or the action performed when pressing the action button. You can also use personalization here. It is required only if adding a button.
Note: You can enter a maximum of 1000 characters.Media URL Yes Leave this blank.
Video Duration No Leave this blank.
Thumbnail URL No Leave this blank.
File name No Leave this blank.
If you select Image, input the following fields:
Field Required Description Message No Text to be displayed alongside the image. It is required when sending a message with a button and an image. You can also use personalization here. Button Text No This is the text that will appear on the action button. You can also use personalization here. It is required only if adding a button.
Note: You can enter a maximum of 30 characters.Button Action URL No This is the URL users are directed to or the action performed when pressing the action button. You can also use personalization here. It is required only if adding a button.
Note: You can enter a maximum of 1000 characters.Media URL Yes This is the URL of the image being sent. It must be a valid URL starting with https:// or http://. The supported image types are .jpg, .jpeg, and .png. The recommended resolution is 800 x 800 pixels.
Video Duration No Leave this blank.
Thumbnail URL No Leave this blank.
File name No Leave this blank.
If you select Video, input the following fields:
Field Required Description Message No Leave this blank.
Button Text No This is the text that will appear on the action button. You can also use personalization here.
Note: You can enter a maximum of 30 characters.Button Action URL No This is the URL users are directed to or the action performed when pressing the action button. You can also use personalization here. It is required only if adding a button.
Note: You can enter a maximum of 1000 characters.Media URL Yes This is the URL of the video being sent. It must be a valid URL starting with https:// or http://. The supported video types are 3gp, m4v, mov, and mp4. The maximum video size is 200 MB.
Note: You can enter a maximum of 1000 characters.
Video Duration Yes This is the duration of the video, with a maximum limit of 180 seconds. You can also use personalization here. Example:
PT5S
Thumbnail URL Yes This is the URL of the thumbnail being sent. It must be a valid URL starting with https:// or http://. The supported thumbnail types are .jpg, .jpeg, and .png. The recommended resolution is 800 x 800 pixels. You can also use personalization here.
File name No Leave this blank.
If you select File, input the following fields:
Field Required Description Message No Leave this blank.
Button Text No Leave this blank.
Button Action URL No Leave this blank. Media URL Yes This is the URL of the file being sent. It must be a valid URL starting with https:// or http://. Supported file types are .doc, .docx, .rtf, .dot, .dotx, .odt ,.odf, .fodt, .txt, .info, .pdf, .xps, .pdax, .eps, .xls, .xlsx, .ods, .fods, .csv, .xlsm, and .xltx.
Note: The maximum allowed file size is 200 MB.Video Duration No Leave this blank.
Thumbnail URL No Leave this blank.
File name Yes This is the name of the attached file being sent (file extension included). The supported file extensions are *\.(docx?|dotx?|xlsx?|f?ods|f?odt|rtf|odf|txt|info|pdf|xps|pdax|eps|csv|xlsm|xltx)$. You can also use personalization here.
-
Your campaign is now ready to be tested and sent. Using the Test functionality, you can also test your connector configuration.
If your test user successfully receives the message, your setup is ready.
-
Publish the campaign.
Send a Viber Message to the Channel or Groups
- Create a new user in MoEngage to message a channel or group. Ensure the Viber ID here is your Channel or group ID.
- Select the user by creating a segment for it. Ensure only one user is included in the segment. When multiple users are selected for the campaign, the message gets sent to the channel or group many times.
- In Step 2 of Create Campaign, enter the Viber ID of your channel or group. You can also use personalization here.
Campaign Analytics
MoEngage campaigns provide powerful analytics that allow you to analyze your campaign performances. Each channel in MoEngage provides in-depth metrics that help you quantify your campaign goals. For more information on the MoEngage Analytics functionalities, refer to Campaign Analytics.
By default, we provide the following metrics for Viber campaigns:
- Attempted: After removing the users who breached the frequency capping (FC), Attempted is calculated as the number of users who qualified for the Viber campaigns and to whom we attempted to send messages.
- Failed: Number of users for whom Viber did not send any message or the users for whom we failed to find any value against the user or event attributes used in the campaign.
- Successfully sent: The campaign is marked as successful when Viber APIs accept the request to send the message to users/groups/rooms (with a 200 status code). For more information on Viber Message API responses, refer to their help documentation.