Viber

Documentation Index

Fetch the complete documentation index at: https://moengage.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

MoEngage and Viber

​

Use cases

• Personalized messaging: Send personalized messages based on user preferences.
• Rich media content: Include images, videos, and files in Viber messages.
• Automated campaigns: Send messages on a schedule or trigger them based on user actions.

​

Methods to send messages via Viber integration

• Integration via native: Use MoEngage campaigns with Viber APIs directly.
• Integration via Infobip: Send messages through the Infobip connector.
• Integration via 8x8 connector: Send text, media (images, videos, files), and call-to-action (CTA) button messages through the 8x8 Chat Apps API.

​

Integration via native

​

Step 1: Connect Viber on the App marketplace

1. On the left navigation menu in the MoEngage dashboard, click App marketplace.
2. On the App Marketplace page, search for Viber.
3. Click the Viber tile.
4. On the Viber page, go to the Integrate tab.
5. Open the integration dropdown and click Send messages (Native).
6. Enter the following details:

   Field	Required	Description
   Connection name	Yes	Name of the Viber connection.
   Viber Auth Token	Yes	Your Viber auth token. The token is generated when you create the bot; admins can view it on the bot edit info screen or in the Viber Admin Panel. For more information, see Authentication token.
   Sender Name	Yes	The sender name displayed to recipients.
   Sender Avatar URL	No	URL for the sender avatar. Note: Maximum size is 100 KB. Recommended resolution is 720×720 pixels.

   
7. Click Connect. Your Viber connection is integrated.

​

Step 1.1: Collect users’ Viber IDs

​

Step 1.2: Save users’ Viber IDs in MoEngage

• Pass the data using the Track User API.
• Upload it using User Imports in MoEngage.

​

Step 2: Create a Viber campaign in MoEngage

1. On the left navigation menu, click Engage, and then click Campaigns.
2. On the All campaigns page, click + Create campaign.
3. In the Create campaign dialog, under Connected Apps, click Viber, and then select a delivery type.
4. Under Select audience, click Filter users by.
5. On the User property tab, select users for whom viber_id exists (you can combine this with other segment criteria).
6. In step 2 (Content), select the native message connector and specify the content to send.
7. Enter the following details:

   Field	Required	Description
   Connector	Yes	Select Send messages (Native).
   Connections	Yes	Select the connection you added in the App marketplace.
   Receiver ID	Yes	Recipient’s unique Viber user ID. You can use personalization.
   Tracking ID	Yes	Tracks messages and user replies. The tracking_data value you send is returned with the user’s reply. Maximum 4096 characters.

8. Select the Message type to send. Supported types are Text, Picture, and Video. Based on the type, enter the fields in the following tables.

​

Native message type fields

9. Test the campaign using Test. If your test user receives the message, the setup is ready.
10. Publish the campaign.

​

Integration via Infobip

​

Step 1: Connect Viber on the App marketplace

1. On the left navigation menu, click App marketplace.
2. Search for Viber.
3. Click the Viber tile.
4. Go to the Integrate tab.
5. Open the integration dropdown and click Send messages (Infobip).
6. Enter the following details:

   Field	Required	Description
   Connection name	Yes	Name of the Viber connection.
   API Base URL	Yes	Unique API base URL for your Infobip account. See Infobip base URL.
   API Key	Yes	Your Infobip API key. See API authentication.

   
7. Click Connect.

​

Step 1.1: Collect users’ Viber IDs

​

Step 1.2: Save users’ Viber IDs in MoEngage

​

Step 2: Create a Viber campaign in MoEngage

1. Click Engage > Campaigns.
2. Click + Create campaign.
3. Under Connected Apps, click Viber and select a delivery type.
4. Under Select audience, click Filter users by.
5. On the User property tab, select users for whom viber_id exists.
6. In step 2 (Content), select the Infobip connector and specify content.
7. Enter the following details:

   Field	Required	Description
   Connector	Yes	Select Send messages (Infobip).
   Connections	Yes	Select the connection from the App marketplace.
   Sender ID	Yes	Unique identifier for your Viber account (alphanumeric or numeric). You can use personalization. Note: Maximum 11 characters.
   User mobile number	Yes	User’s mobile number. You can use personalization. Note: For India, use DLT parameters; for Turkey, IYS regulations; for South Korea, use case-dependent parameters.

8. Select the Message type: Text, Image, Video, or File.

​

Infobip message type fields

9. Test the campaign. If the test user receives the message, the setup is ready.
10. Publish the campaign.

​

Integration via 8x8 connector

​

Step 1: Connect Viber on the App marketplace

1. On the left navigation menu, click App marketplace.
2. Search for Viber and click the Viber tile.
3. Go to the Integrate tab.
4. Click Add integration, then Send messages (8x8).
5. Enter the following details:

   Field	Required	Description
   Connection name	Yes	Name for this connector instance (for your reference in MoEngage).
   8x8 Subaccount ID	Yes	Your 8x8 Chat Apps API Subaccount ID. In the 8x8 Connect portal, go to Channels under Messaging Apps and copy Subaccount ID.
   8x8 API Token	Yes	Your 8x8 Chat Apps API token. In the portal, go to API Keys and copy the API Key.

6. Click Connect.

​

Step 2: Create an 8x8 connector campaign in MoEngage

1. Click Engage > Campaigns.
2. Click + Create campaign.
3. Under Connected Apps, click Viber and select a delivery type.
4. Under Select audience, click Filter users by.
5. Select users for whom viber_id exists.
6. In step 2 (Content), select the 8x8 Viber connector and specify content.
7. Configure campaign fields and message content:

​

8x8 message type fields

{
  "filesize": 200000,
  "duration": 15,
  "thumbnail": "https://example.com/thumb.jpg"
}

​

Message combinations

• Text + button: Text message with a CTA button.
• Image + button: Image with a CTA button.
• Video + button: Video with a CTA button.
• Media only: Send only an Image, Video, or File by setting Content Type and Media URL (and Video Content Details for video).

​

Analytics and delivery tracking

• Connected App Campaign Sent: Triggered when the 8x8 API accepts the message request (HTTP 200).
• Connected App Campaign Failed: Triggered when the 8x8 API returns a non-200 response.

​

Send a Viber message to a channel or group

1. Create a MoEngage user for the channel or group. Set the Viber ID to the channel or group ID.
2. Create a segment that includes only that user. If multiple users are in the segment, the message is sent to the channel or group multiple times.
3. In step 2 of campaign creation, enter the channel or group Viber ID (personalization supported).

​

Campaign analytics

• Attempted: After frequency capping (FC) exclusions, the number of users who qualified for the campaign and to whom MoEngage attempted delivery.
• Failed: Users for whom Viber did not send a message, or users for whom MoEngage could not resolve user or event attributes used in the campaign.
• Successfully sent: The campaign is marked successful when Viber APIs accept the send request (HTTP 200) for users, groups, or rooms. For response details, see Viber REST Bot API documentation.