Steps:

Initial Requirements

For successful integration, the following initial steps need to be carried out:

1. An active Viber account - The account must be created on the platforms that support bots, e.g. iOS, Android, etc. To create an account, you can download the Viber mobile or desktop version
2. Active Viber Bot – You can create your Viber Bot here

• To create a Bot with the same account you will need to sign in with the phone number that has been used during the account creation.

 

 

• Account authentication token – Once the Bot is created a unique account identifier will be generated, it will be available for the administrator account across various platforms where the account has been used.

 

• Account authentication token
• A valid and certified URL – The URL that is being used for the Viber Webhook must have an SSL certificate. In this example, a certificate from GoDaddy has been used. More about the certificates you can read here or under the requirements of the Viber official page. Note: Self-signed certificates are not supported.

Setting up Account Webhook

To set up Viber Account Webhook you need to Post the following API using Kryon Studio “Call Rest API Method” Advanced Command

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

Post Data

{   "url":"https://myhost.com",   "event_types":s      "delivered",      "seen",      "failed",      "subscribed",      "unsubscribed",      "conversation_started"   ],   "send_name": true,   "send_photo": true}

The Advanced Command in Kryon Studio will look like as below:

 

 Once all the above-mentioned steps are complete, you can send messages to the people or group of people from Kryon Studio on Viber. It’s important to remember that a message can be sent from the Viber Bot only to the people who have subscribed to the bot. Usually. The user is being subscribed to the bot after her/his first message to it. To send messages to the subscribed user you need the User ID. It’s recommended to record the subscriber ID of each subscriber as there is no API for now to get all subscribers’ IDs of the account.

Alternatively, you can get the subscriber’s ID if you add them temporarily as a member of the group/bot. Once you add any of the subscribers as a member you can run the following API call to get the info data of the account where you will see all the members’ IDs. The member IDs usually are the same as the subscriber IDs.

Resource URL

https://chatapi.viber.com/pa/get_account_info

Post Data

{}

The above API response will have the following structure where the IDs highlighted  in green are the member IDs, which can be used for sending messages

 

In Kryon Studio the Advanced Command will look like as below:After having all the relevant user IDs you can use Kryon Studio for any API calls for sending messages. Below are sample calls for various types of messages:

Resource URL for getting user details

https://chatapi.viber.com/pa/get_user_details

Post Data for getting user/subscriber information

{   "id":"vN3HQZKrTS2wqg8EyZ2RkQ=="}

Resource URL for sending messages

https://chatapi.viber.com/pa/send_message

Post Data for sending text messages

{   "receiver":"$SuscriberID$",   "min_api_version":1,   "sender":{      "name":"Kryon Viber",      "avatar":""   },   "tracking_data":"tracking data",   "type":"text",   "text":"Hello World"}

Post Data for sending messages with pictures

{     "receiver":"$SuscriberID$",   "min_api_version":1,   "sender":{        "name":"Kryon Viber",      "avatar":""   },   "tracking_data":"tracking data",   "type":"picture",   "text":"Photo description",   "media":""}

Post Data for sending messages with URL

{   "receiver":"$SuscriberID$",   "min_api_version":1,   "sender":{      "name":"Kryon Viber",      "avatar":"http://avatar.example.com"   },   "tracking_data":"tracking data",   "type":"url",   "media":"https://kryonsystems.com"}

Post Data for sending messages with file attachments

{     "receiver":"$SuscriberID$",   "min_api_version":1,   "sender":{        "name":"Kryon Viber",      "avatar":""   },   "tracking_data":"tracking data",   "type":"file",   "media":"http://www.images.com/file.doc",   "size":10000,   "file_name":"name_of_file.doc"}

For more information or other Post Data, you can visit Viber for Developer page. I hope this article will help you to automate your processes connected to your Viber account. For any further assistance please let us know by leaving comments on KryoNet.

For similar guides, for other messenger apps, you can check also the below links

Sending Notification from Slack
Sending Notification from Telegram