Viber: Difference between revisions

Latest revision as of 09:18, 27 November 2024

You can integrate Viber chatbots with Planfix to efficiently receive and process customer messages.

Important notice: As of February 5, 2024, Viber has updated its policies for creating chatbots — it is now a paid feature. However, if your chatbot was created before this date, it will continue to function under the previous terms.

Features

Conveniently manage customer requests from Viber within the unified Planfix interface.
Automatic storage of customer contact information.
Quick replies are available to efficiently respond to frequently asked questions.

How to create a chatbot in Viber

Submit a form to create a bot in Viber.
The Viber team will reach out to you to discuss the next steps.
Once your inquiry is approved, you will receive an API key that you will need to integrate with Planfix.

How to connect a chatbot to Planfix

In Planfix, go to the Account management - Integrations - Messengers.

Open Viber and add a public account. In the window that appears, paste the API key you received from the Viber team.

In the same window:

Select templates for creating contacts and tasks.
Specify additional users that are included in the communication as assignees.

Once the key is added, your account will be connected to Planfix.

Additional settings

In addition to the main integration settings, the following additional settings are available:

Create a new task if there are no active tasks with this contact.

If this option is enabled, a new task will be created if the contact's previous task has been deleted, completed, or is inactive. A link to the previous task is automatically added to the description of the new task.

Send messages on behalf of another user.

With this option, the customer receives the notifications personally from the employee who wrote the message in Planfix.

How the integration works

To send a message to your Viber bot account, the user must follow a special link in which {botname} is replaced by the name of your bot's name:

viber://pa?chatURI={botname}

For example, here is the link to our support bot:

viber://pa?chatURI=planfix

When a Viber user sends a personal message for the first time, a new task is created in Planfix with the customer as the assigner of the task.
The assignee will be the employee specified in the task template for the integration.
The system will assign the account owner or employee configuring the integration if no assignee is specified.

Each additional message from the user is added to their task.
If the user is mentioned in the "Notify", your replies in Planfix will be sent to the user in Viber, including the message text and attached files.

Limitations

Public chats in Viber are not supported.
You can only get the customer's phone number if they provide it in the dialog.

@@ Line 28: / Line 28: @@
 In the same window:
 *Select templates for creating contacts and tasks.
-*Specify additional users that are included in the communication as assignees.
+*Specify [[Connecting additional employees|additional users that are included in the communication as assignees]].
 Once the key is added, your account will be connected to Planfix.
 https://s.pfx.so/pf/wZ/dYGuZz.jpg
 ==Additional settings==
 In addition to the main integration settings, the following additional settings are available:
@@ Line 43: / Line 44: @@
 With this option, the customer receives the notifications personally from the employee who wrote the message in Planfix.
-==General information==
+==How the integration works==
-Users must follow a special link to write to your Viber bot:
+To send a message to your Viber bot account, the user must follow a special link in which {botname} is replaced by the name of your bot's name:
+<pre>viber://pa?chatURI={botname}</pre>
-viber://pa?chatURI={botname}
+For example, here is the link to our support bot:
+<pre>viber://pa?chatURI=planfix</pre>
-Put your bot's name in place of {botname}. For example, [https://planfix.com/support/ here's the link to the bot] for our support team:
+*When a Viber user sends a personal message for the first time, a new task is created in Planfix with the customer as the assigner of the task.
+*The assignee will be the employee specified in the task template for the integration.
-viber://pa?chatURI=planfix
+*The system will assign the account owner or employee configuring the integration if no assignee is specified.
-You can place this link anywhere on your site or on social media. Check out our site for an example
-If a client has the desktop version of Viber installed, or if they are using a mobile phone, then when they click this link the bot will be added to their Viber contact list, and you will be able to chat with the client through Planfix by linking the bot to the service.
-If the client doesn't have the desktop version of Viber (which is often the case) then nothing will happen in their browser when they click this link. If this is the case, we recommend clicking the link on a mobile device or downloading the desktop version of Viber.
-Viber does not show you the client's phone number in the chat; you can only get their number through Viber if they send it to you.
-==Creating a Viber bot account==
-You can create a bot account at [https://partners.viber.com/login this link].
-https://pic.planfix.ru/pf/4n/vnST11.png
-Once you have created the bot account, you will get an API key, which you will need in order to link the bot to Planfix:
-https://pic.planfix.ru/pf/RD/yHF9We.png
-==Linking a bot or public Viber account to Planfix==
-'''Step 1:''' Copy the '''API key''' of your public account or bot account in the Viber app.
-'''Step 2:''' In Planfix, go to '''Account management / Integrations / Messengers''' (available for account administrators). Click '''Viber''':
-https://pic.planfix.ru/pf/99/7Pll0m.png
-In the panel that opens, click Add public account and paste the API key in the field that appears:
-https://pic.planfix.ru/pf/DJ/YIusNL.png
-After you have added the key, your account will be linked to Planfix.
-https://pic.planfix.ru/pf/Es/Nx70tE.png
-==Using Planfix to manage messages from Viber users==
-'''A user's first message.'''
-When a Viber user writes a message to your account for the first time, the following will happen in Planfix:
-*A contact card will be created for this user, with their name and avatar from Viber
-*A new task will be created, where the user will be the assigner and their message will be the task text.
-https://pic.planfix.ru/pf/RC/qYWY8M.png
-In the integration settings, you can select templates that will be used to create contacts and tasks for messages from Viber:
-https://pic.planfix.ru/pf/3a/e7wTwl.png
-Each subsequent message from this user will be added to their task as a new action. All types of message content are added: text, photos, geotags, contacts, doodles.
-Your responses in Planfix where the user is highlighted in the "Notify" section will be sent to them on Viber. In addition to the message text, any files attached to the message will be sent, including images.
-==Additional integration settings==
-https://pic.planfix.ru/pf/Xq/Yrf6p3.png
-*Create a new task if there are no active tasks with this contact
-Using this option means a new task will be created if there is [[Task status types | no active task]] (with any active status) with this client:
-https://pic.planfix.ru/pf/c0/DELilb.png
-By default, this checkbox is checked. When the checkbox is checked, a new task will be created if the previous task with this client has been deleted or completed, or is inactive. In this case, a link to the previous task will automatically be added to the description of the task created:
-https://pic.planfix.ru/pf/AB/6pUT5M.png
-When the checkbox is unchecked, all messages from the client will be sent to the original task with this client, regardless of its current status.
-*Send messages using an employee's name
-By default, clients receive Viber messages from your public account. If this setting is used, clients will receive notifications from the specific employee who writes to them in Planfix.
-https://pic.planfix.ru/pf/V5/RPhIFM.png
+https://p.pfx.so/pf/Ga/AOFF1E.jpg
+*Each additional message from the user is added to their task.
+*If the user is mentioned in the "Notify", your replies in Planfix will be sent to the user in Viber, including the message text and attached files.
+==Limitations==
+*Public chats in Viber are not supported.
+*You can only get the customer's phone number if they provide it in the dialog.

Navigation menu

Go To