Is this article helpful?

We love to hear from you!

Table of Contents

Viber Quick Start

JQ Lee Updated by JQ Lee

Viber Logo

Getting a Viber Bot


  • A personal Viber account
To create a Viber Chatbot, read our guide.

Connecting a Viber Bot

Connecting an existing bot

Step 1: Go to Settings > Channels

Step 2: Click Add Channel > Viber > Connect an Existing Bot

Step 3: Sign in to Viber Admin Panel

Viber Admin Panel

Step 4: After signing in, select a Bot to connect to If you don't have a Bot, create a Bot account

Step 5: On the Bot Info page, locate the Token and add it to the corresponding field on the platform

Step 6: Click Complete to complete the setup in

Connecting a new bot

Step 1: Go to Settings > Channels

Step 2: Click Add Channel > Viber > Create A New Bot

Step 3: Sign in to Viber Admin Panel

Step 4: After signing in, click Create Bot Account and add the required information

Step 5: Add the token to the corresponding field on the platform

Step 6: Click Complete to complete the setup in

Once you have completed the setup, any messages sent to your Viber Business Account will now be received in your Workspace.
Once the Channel is connected, scan the QR code to send a test message and make sure everything is working properly.

Channel Configuration

The Viber Channel can be configured with a unique Channel name. This name will be used internally to identify the account.

Step 1: Click Settings > Channels

Step 2: Locate the Viber Channel > click Manage

Step 3: In the Viber Configuration page you will see the following configurations:

  • Chat Link - A click-to-chat link is a shortened URL that directs customers to start or continue a conversation with your Viber account. You can share this link to refer customers to a new or existing thread, based on whether the user has previously messaged your Viber account. You can also generate a QR code to share the chat link to your Contacts.
  • Channel Name - The Channel Name can be changed and is used internally to identify the Channel.
Important: Ensure the details are correct for messages to be received successfully in your Viber account.

Step 4: Click Save Changes to update the Viber Configuration page

FAQ and Troubleshooting

Can I connect to a personal Viber account?

To connect a Viber Channel a Viber bot account is required. You can create a Viber bot here.

When you make a Viber bot, by default it won’t automatically have a live landing page on and it won’t show up in Viber’s search results right away either.

You can create a link to open a private chat with your bot, but this works only for users who have Viber on their devices. To learn how to generate a Viber link, follow this guide.

Use's Pre-Filled Text feature to populate the message box with a default message when Contacts open a chat window with your business.

This saves Contacts' time from needing to think about what to write and just click send, encouraging Contacts to send the first message.

Here's how to add pre-filled text to your Viber link and QR codes.

  1. On the platform, click Settings > Growth Widgets > Add Widget.
  2. Select QR Code option and click Create Widget.
  3. Create the QR Code.
    1. Select “Viber” as the QR code type.
    2. Select the connected Viber Channel that you want to create the QR code for.
    3. Add the pre-filled text that will automatically appear in the message field when the QR code is scanned.
  1. Click Generate Widget button to create your QR code with the pre-filled text.
  2. Click Download and select the size of the QR code you want to save or follow the instructions here to get your Viber chat link.
  3. When Contacts scan your QR code or click on your Viber link, they should automatically have the pre-filled text in the message box.

Why do I receive the error message Failed to send the message as the contact is not subscribed anymore?

Contact is not subscribed anymore error message

Seeing this error means the Contact has already unsubscribed from your business Viber bot.

Opting out stops a Contact from getting messages from a business. Often, Contacts do this due to spam, feeling the business sends too many promotions. Once unsubscribed, the business can't send any messages, like broadcasts or 1-to-1 messages, unless the Contact contacts the business again.

Why can’t I send outgoing messages?

There are two potential reasons for this.

The first is when your account is blocked by Viber. This results in the error message publicAccountBlocked from Viber API being shown when you try and send a message from the platform. If this happens to you, contact Viber Support to unblock your account.

Another reason is because you’ve exceeded the maximum free messages from the Bot.


According to the Chatbot Commercial Model by Viber, the Chatbot has a limit of 10,000 free chatbot-initiated messages per calendar month. When this limit is reached, Viber will block new chatbot-initiated messages until the following month.

To send more than the allocated 10,000 free messages, you will need to agree to Viber’s Chatbot Commercial Model, and fill out this form.

The rate applied to each chatbot-initiated message is based on the country code of the phone number with which the chatbot subscriber registered to Viber.

Learn more about Viber Bot Pricing here. has partnered with Viber to enable more than 10,000 chatbot-initiated messages for our customers on a custom annual plan, as well as a credit-based system for Viber fees.

Why can’t I receive inbound messages?

Check if the test message is sent to your personal number tied to Viber or to the Viber Bot’s URI. If you are sending it to your personal number, you will not receive any messages. Try sending a message to the Bot's URI instead.

Here’s how you can locate the Bot's URI:

Step 1: Log in to Viber Admin Panel

Step 2: Select the bot and navigate to the URI field

Feeling stuck? Do not fear.

Need assistance? Contact us for support. Help is here!

Viber Overview

Can't find what you're looking for?

Talk to an expert here!

Contact Us
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)