Viber
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.
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.
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:
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:
In the panel that opens, click Add public account and paste the API key in the field that appears:
After you have added the key, your account will be linked to Planfix.
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.
In the integration settings, you can select templates that will be used to create contacts and tasks for messages from Viber:
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
- 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:
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:
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.
