Viber Routings

Set up chat routings for your Viber.

Set up Your Viber Bot Account

Install the Viber app on your phone or PC and create a new account.
Go to https://partners.viber.com/login and enter your number. You will receive a Verification code in Viber. Enter it to log in to your Viber Admin Panel.
Fulfil the application form to create a Viber bot under https://help.viber.com/hc/en-us/articles/15247629658525-Bot-commercial-model. Viber’s team will afterwards review your application and send you a feedback; hence you’ll be able to finish the registration process.
Create a Bot Account:
Select a profile picture, fill out the form (all fields are mandatory), check all the checkboxes at the bottom of the page and click Create.
Copy your Token and paste it into the API token field in the Connector details in the next step. Your customers can use the QR code to message you on Viber – you can copy it now or come back to this page later.
To include your account in Viber searches, open the Viber app on your mobile, go to More → Settings → My Bots → your bot → Edit info → Publish Your Bot to publish the account.
Set up your Connector and routing to your Viber queue (see next sections).

Learn how to work with Viber bot here.

Inbound Routings/Connectors

It is recommended to first create a corresponding Viber queue before creating a routing/connector so you can pair them in the routing/connector. You can however set up several routings'/connectors' destinations at the same Viber queue.

Go to Manage → Routings → Viber → Inbound routings. You will see an overview of your inbound routings/connectors.

You can view a diagram tree of each inbound routing/connector by clicking the grey tree button in the Actions column.

Click the Title of an inbound routing/connector to open its details or click Add new to create a new inbound routing/connector. The inbound routing/connector details will open.

AccessToken: will be filled in automatically after you save your routing/connector.

Title: enter a title.

Description: enter a description.

API Token: enter your Viber API token.

URL: not used.

Next destination: select where the chat should be routed.

You can select:

Terminate. The chat will end or be offline – select which Terminate option to use.
Queue. Select which queue the chat will be routed to.
Time condition. Decide where the chat will be routed depending on the date/time.
Decision tree. Route the chat to a chat bot.

Allow attachments: choose whether to allow uploads from customer or both directions.

Automessages

Route your web chat to automessages if you want to send customers messages.

To set up automatic messages, go to Manage → Routings → Viber→ Automessages. You will see an overview of your automessages.

You can view a diagram tree of each automessage by clicking the grey tree button in the Actions column.

Click the Title of an automessage to open its details or click Add new to create a new automessage. The automessage details will open.

When you are done creating or editing an automesaage, click Save to return to the automessage overview and make sure to click the Apply configuration changes button in the top right corner.

It will take a few minutes for the changes to take effect on your website. If you want to see them immediately, open your website in a new incognito mode window.

Sandbox

Set up your automessages in this column. If you are editing an automessage, you can compare your new settings to those currently in use in the Production column.

All fields are mandatory except Description and Text.

Fill out the Title and Description.

Next destination: select where the web chat should be routed next.

You can select:

Another automessage.
Terminate. The chat will end or be offline – select which Terminate option to use.
Queue. Select which queue the web chat will be routed to.
Time condition. Decide where the chat will be routed depending on the date/time.
Decision tree. Route the chat to a chat bot.

Message

Time: select the delay between when the chat is routed to the automessage and when the message is sent. The timer starts as soon as the chat is routed here – take this into account when setting up multiple messages (Time is not the interval between messages).

Text: enter your message.

Time Conditions

To set up your business hours and bank holidays, go to Manage → Routings → Viber → Time conditions. You will see an overview of your time conditions.

You can view a diagram tree of each time condition by clicking the grey tree button in the Actions column.

Click the Title of a time condition to open its details or click Add new to create a new time condition. The time condition details will open.

When you are done creating or editing a time condition, click Save to return to the time conditions overview and make sure to click the Apply configuration changes button in the top right corner.

Sandbox

Set up your time conditions in this column. If you are editing a time condition, you can compare your new settings to those currently in use in the Production column.

All fields are mandatory except Description.

Title: enter your time condition title. Select the title in Inbound routings/connectors to use the time condition in the routing/connector.

Description: enter a description.

Time group: select the Time group you would like to use from the drop down menu. You need to have at least one Time group set up to use Time conditions. You can also use the blue drop down menu to view or edit the selected time group or to create a new one – this will open Manage → Settings → Time groups.

If time matches: select what to do if the current day and time matches that of the time group.

You can select:

Terminate. The chat will end or be offline – select which Terminate option to use.
Queue. Select which queue the chat will be routed to.
Another time condition (we recommend to set up your time groups in a way that you don't need to route from a time condition to another one).
Decision tree. Route the chat to a chat bot.

If time does not match: select what to do if the current day and time does NOT match that of the time group. The options are the same as above.

Decision Trees

Viber Decision Trees are currently in Beta stage.

Use decision trees to set up your Viber chatbot.

Go to Manage → Routings → Viber → Decision trees. You will see an overview of your Decision trees.

You can view a diagram tree of each decision tree by clicking the grey tree button in the Actions column.

Click the Title of a decision tree to open its details or click Add new to create a new decision tree. The decision tree editor will open.

When you are done creating or editing a decision tree, click Save to return to the decision tree overview and make sure to click the Apply configuration changes button in the top right corner.

The decision tree editor will display a diagram of individual decisions. When creating a new decision tree, you will only see the first step, "Welcome message". Click a decision to select it, then click the edit button on the right hand side:

The decision details will open.

Fill out the decision Title and Description (optional) in the header, then set up your decision. We recommend reading through the templating language documentation.

Actions

Request: request data from a URL. Fill out the URL address where your data is stored and name the object that will contain the returned data so you can display it in the chat.

Send message: send a message in the web chat. Enter a default message and any language variations – the customer's language will be detected automatically.

Save data: store own data for later usage.

Create ticket: enter the ticket's Title, select a Category and enter a Comment.

Groups

Condition: set up conditional actions. First set up your condition parameters, click Done and then drag and drop actions into the fields in the condition.

Loop: walk through array items. If you use action Target, loop ends.

Targets

Target

Next destination: select if the target is another decision in the tree (Decision) or a final target such as a queue or a time condition (App).

If you have selected:
- Decision – choose a target decision from the drop down list or click the blue plus button to add a new decision. Type the new decision name. You can edit the new target decision in the diagram once you save the current one and return to the decision tree editor.
- App – select the target type (Terminate, Decision tree, Queue, Time condition) and the target.
Execution: select whether to go to the target as soon as the customer reaches the decision (Immediately) or whether action from the customer's side is necessary (When client choses it).

If you have selected When client choses it, select your Answer type:
- Pattern: the customer can type their answer. Enter a pattern in backslashes that the customer's answer must fit to trigger this action. E.g. /[0-9]{6}/ will fit if the customer enters at least a six digit number. See Regular expression syntax for more info.
- Similar: the customer can type their answer. Enter a list of words that will trigger this action separated by commas.

You can set up language variants in all combinations except Decision-Immediately and Decision-When client chooses it-Generated buttons.

Add another target to set up different targets depending on the customer's answer.

If you use Similar or Pattern as an answer in your decision, a "Default answer" radio button will appear next to each answer. Select the answer that should be triggered when the customer's answer does not fit any of the patterns or words.

Chatbots

Set up a connection to a third-party chatbot.

Go to Manage → Routings → Viber → Chatbots. You will see an overview of your chatbots.

Click the Title of a chatbot to open its details or click Add new to create a new one. The chatbot details will open.

When you are done creating or editing a chatbot, click Save to return to the chatbot overview and make sure to click the Apply configuration changes button in the top right corner.

It will take a few minutes for the changes to take effect on your website. If you want to see them immediately, open your website in a new incognito mode window.

Set up your chatbot set up in the Sandbox column. If you are editing a chatbot, you can compare your new settings to those currently in use in the Production column.

Title: enter a title.

Description : enter a description.

Fallback: select where the chat should be routed if the Callback URL is not available.

Callback URL: enter the endpoint where data from the chatbot should be sent. Filled in automatically – you do not need to change it.

Chatbot URL: enter the URL of your chatbot.

Send start message: forward the client initialisation message (if it exists) as part of the first chatbot request.

Send attachments: send the structure of any attachments the client sends.

Send customFields: select the custom input fields that should be sent to the chatbot.

Structure of Data Sent to the Chatbot

message = message object
interaction = interaction object
? = if empty, null is sent

'?name' => '{{message.name}}',
'?time' => '{{message.time_created}}',
'?direction' => '{{message.direction}}',
'conversation.name' => '{{interaction.name}}',
'conversation.title' => '{{interaction.title}}',
'conversation.time' => '{{interaction.time}}',
'conversation.response_url' => '{{config.callback}}?hash={{interactionHash}}',
'text' => '{{text}}',
'attachments' => object array, each object contains: 'title', 'type', 'size', 'link'

Example 1:

^{//request data - text message and list of attachments}
^{POST chatbotURL}
^{
^{"name": "messages_62fe1518a9820077126134",}
^{"time": "2022-08-18 12:31:52",}
^{"direction": "IN",}
^{"conversation": {}
^{"name": "web_62fe14acd567e380992326",}
^{"title": "",}
^{"time": "2022-08-18 12:30:04",}
^{"response_url": "https://XXX.daktela.com/external/web/api/chatbotUpdate?hash=b9f68fa377263e8f3018a405f25f44add10fab4c",}
^{"customFields": [}
^{
^{"name": "number",}
^{"title": "Number we want to know",}
^{"value": "22"}
^},{
^{"name": "...",}
^{"title": "....",}
^{"value": "...."}
^},
^]
^},
^{"text": "xxx",}
^{"attachments": [}
^{
^{"link": "https://xxx.daktela.com/external/web/chat_file.php?accessToken=on87q29oq60q02nqo6nr3oo7s5r7r607&chat=web_62fe14acd567e380992326&mapper=chatsMessage&name=29",}
^{"title": "Name of screenshot.png",}
^{"type": "image/png",}
^{"size": "122221"}
^},
^{
^{"link": "...",}
^{"type": "....",}
^{"size": "...."}
^}
^],
^{"referer": "https://xxx.com/demo/chat.html"}
^}

^{Example 2:}

^{//request data example - pressed quick reply button}
^{POST chatbotURL}
^{
^{"name": "messages_62fe1518a9820077126134",}
^{"time": "2022-08-18 12:31:52",}
^{"direction": "IN",}
^{"conversation": {}
^{"name": "web_62fe14acd567e380992326",}
^{"title": "",}
^{"time": "2022-08-18 12:30:04",}
^{"response_url": "https://XXX.daktela.com/external/web/api/chatbotUpdate?hash=b9f68fa377263e8f3018a405f25f44add10fab4c",}
^{"customFields": []}
^},
^{"quickreply":}
^{
^{"name": "quickReplyName1",}
^},
^{"referer": "https://xxx.com/demo/chat.html"}
^}

Expected Structure of Received Data

'conversation.name' – interaction name
'hash' – identifies into which conversation the incoming message belongs
'text' – incoming message
'transfer' – name of queue where the conversation should be transferred

Example:

^{//response example}
^{POST https://XXX.daktela.com/external/web/api/chatbotUpdate}
^{
^{"conversation": {}
^{"name": "web_62fe14acd567e380992326"}
^},
^{"text": "textMessage",}
^{"button": [}
^{
^{"text": "xxx.com",}
^{"url": "https://xxx.com/api/"}
^},
^{
^{"text": "...",}
^{"url": "...."}
^}
^],
^{"quickreply": [}
^{
^{"name": "quickReplyName1",}
^{"text": "Quick reply Name 1"}
^},
^{
^{"name": "...."}
^{"text": "...."}
^}
^],
^{"queue": "10001",}
^{"hash": "b9f68fa377263e8f3018a405f25f44add10fab4c",}
^}

Terminate

Set up how your chats will end in different scenarios.

Go to Manage → Routings → Viber → Terminate. You will see an overview of your terminate set ups.

You can view a diagram tree of each terminate set up by clicking the grey tree button in the Actions column.

Click the Title of a terminate set up to open its details or click Add new to create a terminate set up. The terminate details will open.

When you are done creating or editing a terminate set up, click Save to return to the terminate overview and make sure to click the Apply configuration changes button in the top right corner.

Set up your terminate set up in the Sandbox column. If you are editing a terminate set up, you can compare your new settings to those currently in use in the Production column.

Title: enter a title.

Description : enter a description.

Disconnection cause : select from the dropdown list. This is for internal use only – the customer will not see this info.

Queue: select which queue the chat will belong to if it is terminated using this set up.

If you want to receive missed chat notifications, you must select a queue.

Auto response: select a template to send to the customer if the chat is terminated using this set up.

Answered: toggle whether a chat terminated using this set up is logged as answered.