Getting started

Enabling Viber for your configuration involves gaining approval from Viber to use your channel for business messages, and registration in the Infobip back-end to be able to use it in the web interface and over API.

Enablement flow

Here you can see the registration and enablement procedure when adding Viber as a communication channel:

Enablement request

To request Viber enablement, in the web interface navigate to Channels and Numbers> Viber> Overview and use theSend request option. Provide your email address on which Infobip support can contact you to initiate Viber activation.

In the meantime, make sure to download the Warranty letter and Service Qualification Form ready to be completed and submitted. You can then familiarize yourself with business message Guidelines and Compliance.

Viber approval

Provide the completed warranty letter and service qualification form to Infobip.

Viber will review the application and approve it within 2-3 days, and will assign you a unique ServiceID number.

In addition to the forms, the following provisions are also required to gain approval:

• 6 logos in .PNG format with good quality and resolutions:
  • 50 x 50 pixels
  • 65 x 65 pixels
  • 100 x 100 pixels
  • 130 x 130 pixels
  • 256 x 256 pixels
  • 360 x 280 pixels
• Service name in the native language and English
• Service website
• Service description
• Service registered country or location
• Service industry type
• Monthly expected message value
• Service integration type (one-way or both one-way and two-way)
• Destinations or countries you will send messages to
• Type of messages you are sending (promotional or transactional)
• Introductory message example*
• Service estimated launch date

*Introductory messages towards customers cannot be promotional. Below you can see examples of what are considered promotional messages and what are not.

	One-way Message	Two-Way Message
Transactional	Dear Miss {name}, your order has now arrived at our shop and is ready for you to collect.	Dear Mr. {name}, your appointment to Dr. Smith has been scheduled for January 10th at 12:00 AM at our clinic on 125th Lincoln Street. Please make sure to bring all relevant documents with you. To change the time of your appointment or cancel, please reply to this message to contact the appointment center.
Promotional	Dear Ms. {name}, thank you for choosing to fly with {company name}. We have a mileage program that you might be interested in. Find out more (link or button).	Last day of our special summer sale! Discounts for all online store purchases! Reply with a #SummerSale to receive a coupon code.

Test sender

While waiting for Viber's approval, you can use the demo sender to test the service in Broadcast. To create the test broadcast, carry out the instructions in one of the following sections:

• Import data
• Enter data manually

Import data

You can import the data for the test broadcast from either a file or an existing broadcast.

1. On the Infobip web interface (opens in a new tab), go to Channels and Numbers > Viber.

2. Click Start test.

3. Click Import data.

   

4. Follow one of these options:

   • File: Imports data for the To field. Click Upload file. To add data to the other fields, refer to the Enter data manually section.
   • Broadcast: Imports data for all fields. Choose from the list of broadcasts.
   

5. If required, modify the data in the fields.

6. Click Continue to preview.

7. If you want to make changes, click Back and modify the data.

8. If everything looks correct, click Launch.

Enter data manually

1. On the Infobip web interface (opens in a new tab), go to Channels and Numbers > Viber.

2. Click Start test.

3. Enter data for the following fields:

   • To: Contact information of the recipients. You can add this data in one of the following ways:
     • Choose from the list of senders.
     • To import senders from People, click Add from People.
     • Type the phone numbers of the recipients.
   • From: Choose from a list of senders or type the phone number of the sender.
   • Depending on the type of message that you want to send, enter the information in one or more of the following fields:
     • Content: Type the text message to send to the end user.
     • Rich Content Message > Image URL: Enter the URL for the image to send to the end user.
     • Rich Content Message > Button Text and Button URL: Add the text to display on the call-to-action button and the URL for the button.

   You can send one of the following message options:

   • Text
   • Image
   • Text + image + call-to-action button
   
   • (Optional) Tracking and URL Shortening: 
     • Track URL clicks: Enable this field to identify which campaign links were clicked, how many times, and by whom. If you enable URL tracking, URL shortening is enabled automatically. If you deactivate URL shortening, URL tracking is disabled automatically.
     • Shorten URLs: Enable this field to reduce the length of URLs. For more information, refer to the URL Shortening and Tracking section.
   
   • (Optional) Advanced: Complete one or more of the following fields:
     • Validity period and Validity period unit: Enter the validity period of the broadcast in either hours or minutes.
     • Message sending speed and Message speed unit: Enter the number of messages to send each second, minute, hour, or day.
     • Enable delivery reports over API: Enable this field to forward delivery reports to a defined endpoint.
     • Data Payload: Add additional information such as name and address. Choose from the available data.
   
   • (Optional) Scheduling Options: Complete one or more of the following fields:
     • Communication start: Choose the data and time from which the communication process should start.
     • Timezone: Choose the time zone for the communication and message delivery times.
     • Delivery time window: Choose the days on which the message should be sent and the start and end times to send the messages.
   
   • (Optional) Enable Failover to SMS: Enable this field to add SMS as the fallback option in case message sending fails over Viber. Any settings and scheduling options from Viber will be applied to the SMS failover. Enter the following information:
     • Select sender: Choose from a list of senders or type the phone number of the sender.
     • SMS message: Type the message to send to the recipients.
     • Special characters: To add special characters from selected languages, choose from the list.
     • Track URL clicks: Enable this field to identify which campaign links were clicked, how many times, and by whom. If you enable URL tracking, URL shortening is enabled automatically. If you deactivate URL shortening, URL tracking is disabled automatically. For more information, refer to the URL Shortening and Tracking section.
     • Shorten URLs: Enable this field to reduce the length of URLs.
       For more information, refer to the URL Shortening and Tracking section.
     • Validity period and Validity period unit: Enter the validity period of the broadcast in either hours or minutes.
   

4. Click Continue to preview.

5. If you want to make any changes, click Back and modify the data.

6. If everything looks correct, click Launch.

Registration in Infobip

Once approved by Viber, you'll need to sign our Messaging Services Agreement (MSA), or the MSA Addendum to include Viber if you are already using our other services. Infobip then completes the integration process and enables the service.

You can now use the approved sender.