Viber: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
No edit summary
 
(16 intermediate revisions by the same user not shown)
Line 12: Line 12:
viber://pa?chatURI={botname}
viber://pa?chatURI={botname}


Put your bot's name in place of {botname}. For example, here's the link to the bot for our support team:
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:


viber://pa?chatURI=planfix
viber://pa?chatURI=planfix
Line 19: Line 19:
You can place this link anywhere on your site or on social media. Check out our site for an example
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 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.
 
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.
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 [this link].
==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:
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:
   
   
<screenshot>
https://pic.planfix.ru/pf/RD/yHF9We.png
 
 
   
   
Linking a bot or public Viber account to Planfix
==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:
'''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''':
   
   
<screenshot>
 
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:
In the panel that opens, click Add public account and paste the API key in the field that appears:
   
   
<screenshot>
 
https://pic.planfix.ru/pf/DJ/YIusNL.png
 
   
   
After you have added the key, your account will be linked to Planfix.
After you have added the key, your account will be linked to Planfix.
   
   
<screenshot>
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:
==Using Planfix to manage messages from Viber users==
●      A contact card will be created for this user, with their name and avatar from Viber
'''A user's first message.'''
●      A new task will be created, where the user will be the assigner and their message will be the task text.
 
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.


   
   
<screenshot>
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:
In the integration settings, you can select templates that will be used to create contacts and tasks for messages from Viber:
   
   
<screenshot>
 
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.
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.
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
 
==Additional integration settings==
   
   
<screenshot>
https://pic.planfix.ru/pf/Xq/Yrf6p3.png
   
   
●      Create a new task if there are no active tasks with this contact
*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 no active task (with any active status) with this client:
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:
   
   
<screenshot>
 
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:
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:
   
   
<screenshot>
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.
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
 
*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.
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.
   
   
<screenshot>
 
https://pic.planfix.ru/pf/V5/RPhIFM.png
 
 
 
== Go To ==
*[[Integrations]]
*[[Account Management]]
*[[Feature Description]]

Latest revision as of 20:46, 30 August 2020

You can link one or more special Viber accounts to Planfix and use Planfix tools to process messages received through the Viber account(s). The Viber accounts can be:

  • public Viber accounts (temporarily disabled)
  • Viber bot accounts (create one here)

Users' messages in chats with these accounts will become tasks in Planfix. A user can share text messages, images, contacts, and other information with you. All messages they send will be added as new actions to a task that is created for this communication. You can process these messages using all the tools available in Planfix, and whenever you add comments, images, or other files to the task and notify the user, they will be sent to the user in Viber.


General information

Users must follow a special link to write to your Viber bot:

viber://pa?chatURI={botname}

Put your bot's name in place of {botname}. For example, here's the link to the bot for our support team:

viber://pa?chatURI=planfix


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 this link.

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:

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:


7Pll0m.png


In the panel that opens, click Add public account and paste the API key in the field that appears:


YIusNL.png


After you have added the key, your account will be linked to Planfix.


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.


qYWY8M.png


In the integration settings, you can select templates that will be used to create contacts and tasks for messages from Viber:


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

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 no active task (with any active status) with this client:


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:


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.


RPhIFM.png


Go To