Viber Connector Configuration & Deployment

Overview

Viber provides support to send send private messages to users. Viber Direct Messages enable businesses to take an interaction with a user as a private conversation via Viber Bot. Viber allow businesses to create Viber Bot (Admin account) and subscribe to it in order to receive events whenever a new message is received on your Viber Bot (Admin account).

Get Started - Setup Viber

In order to setup Viber, we first need to create a Viber account using our phone number (on mobile app). Download the Viber Mobile App and sign up using your mobile number.

Once done, now you need to visit Viber Admin Portal and Sign in using your mobile number (with which you have just registered on mobile App).

Once logged in, visit the menu item in left stating “Create Bot Account”. Fill out the form with the information. Please note here that “URI” is unique across Viber because it would be the unique name of your account across Viber. Sample Account Information form is given in the snapshot below.

Once created, it will assign you a unique “Token” that you can save for later use. However, it can still be accessed again from “Info” menu on the left or by selecting your account from top left menu.

Once bot is created, you can now open you Viber Mobile App, Select “More” from the bottom menu bar, Select “QR Code Icon” from the top right of the screen which opens. Scan the code of your bot account from your admin panel (as shown in the image above). Once scanned, you will be able to see your bot named account and you can chat with it from here.

For the first time, when you access it, it will show you an icon of “publish” on your bot. Select this icon to publish your bot as well. Please note here that by default, our bot will not show up in the search results because it’s a PAID feature. However, we can still able to access our account via QR code as we have mentioned above.

Unified Admin Configuration

In our CX Hybrid Chat application, we need to setup viber same like we setup any other connector. The detailed setups are mentioned below.

Channel Type

1. VIBER channel type should be already shown in the list here. If not please add one.

2. Select the MRD as CHAT for general chat feature or any other specifically created for VIBER.

3. Upload the icon (if not already uploaded)

4. Save

Channel Provider

1. Set any name i.e. Viber Provider.

2. Select Channel Type as “VIBER”.

3. Set “Provider Webhook” field as “<FQDN>/viber-connector”. E.g. https://cim.expertflow.com/viber-connector.

4. Add 2 Attributes as Custom Attributes

   1. VIBER-TOKEN (String2000)

   2. VIBER-ACCOUNT-NAME (String2000)

5. Save

Channel Connector

1. Set any name i.e. Viber Connector.

2. Select Channel Provider as “Viber Provider”.

3. In VIBER-TOKEN field, paste the Viber Token from the Viber Admin Panel → Bot Account → Info.

4. In VIBER-ACCOUNT-NAME field, paste the Viber Account Name from the Viber Admin Panel → Bot Account → Info.

5. Save.

Channel

1. Click on Viber to expand the panel and click on “Add new Channel”.

2. Set any name i.e. Viber.

3. Set ServiceIdentifier as “Account URI” from the Viber Admin Panel → Bot Account → Info. (Case sensitive)

4. Select the Bot from the drop down list.

5. Select “Viber Connector” from Channel Connector drop down list.

6. Set 180 as Customer Inactivity Timeout (sec). (You can change it as per your need)

7. Set ChannelMode as HYBRID.

8. Set Routing Mode as PUSH or PULL (As required).

9. Set Queue or List (As required).

10. Set Agent Selection Policy as LONGEST AVAILABLE.

11. Set 180 as Agent Request TTL (sec). (You can change it as per your need)

12. Save.

Setup Webhook

Once the Viber account is setup and Configurations on unified admin is already finished with working viber-connector on some instance, then we need to setup the webhook.

Snapshot is shown below:

Post Header

Add the below mentioned key value in the header of this post request. The token would be same as it is shown in the homepage of viber admin account (Viber Admin Panel → Bot Account → Info.)

Key: X-Viber-Auth-Token

Value: <viber-token>

Post Url
https://chatapi.viber.com/pa/set_webhook

Post Body

1. url will contain 2 parts.

   1. https://cim-dev3.expertflow.com/viber-connector/webhook (This is the FQDN and the ENDPOINT of the API we have created to receive webhook in our connector)

   2. /expertflowdemo (This is the Account URI of your Viber Bot Account through which it can be identified uniquely)

Post Response

If you receive a response with status equals 0 it means webhook is configured successfully on all the events. If status not equals to 0 then it means there is some issue. You can consult these error codes to identify the issue in this case.

After successfull webhook registration, you should be able to receive the chats on your viber connector and it should flow further to Hybrid Chat Agent accordingly.

For any other feature or details, please visit Viber documentation.