---
description: Connect a Viber chatbot to chat with customers over Viber.
title: Viber Quick Start
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[New🌍 WhatsApp API Calling is now available globally! Start making calls with respond.io today. Learn more![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/whatsapp-business-calling-api)

Help me with... ⌘ 

1. [All Collections >](/help)
2. [ Channels >](/help/channels)
3. [ Viber >](/help/viber)
4. Viber Quick Start

# Viber Quick Start

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/7tin8k9c1emscQGOhIuNbC/0ed3f91c8580c4e5dfa90f035355122e/Petrina_Jo_avatar.svg)

JQ Lee

· 14 Nov 2025

4 min read

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3aY7BYwDwZvV9Jjt9ZOt3N/5d3b48e9977d5d256dc7d2efb9a98d3e/viber-logo.png?fm=jpg&q=80&w=243)

## Getting a Viber Bot

> Starting February 5th, 2024, you can no longer create Viber bots on your own and must apply [directly to Viber](https://share.hsforms.com/12pxGHMtAS3yq%5F3KcxQ6g1A4fpwx).

> Learn more about the [current Bot Commercial model here](https://help.viber.com/hc/en-us/articles/15247629658525).

Requirements:

* A personal Viber account

> To create a Viber Chatbot, read our [guide](https://respond.io/blog/viber-for-business#2r06a).

## Connecting a Viber Bot

### Apply For a Bot

**Step 1:** Go to **Settings > Channels**

**Step 2:** Click **Add Channel > Viber > Connect > Apply For A Bot**

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2l181slz7seBdIXj6oOa9x/074e761df5e861691cd3f09cf9b4b701/image.png?fm=jpg&q=80&w=640)

**Step 3:** Fill in the [Viber Form](https://share.hsforms.com/12pxGHMtAS3yq%5F3KcxQ6g1A4fpwx) to receive your private token once your application has been processed and approved.

> If you already have a private token, click the **I Have A Bot Token** button to proceed to the next step.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1zxJdWRwl6VpoOJt0Ui6UI/977d07239b8101a37f93f566f0d06d07/image.png?fm=jpg&q=80&w=640)

**Step 4:** Click on **I Have A Bot Token** \> Navigate to the info page in your Viber Admin Panel > Copy and paste your private token in the 'Viber Bot Token' field and click **Connect**

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Dy5uOpaRKREG5vG6FsW6D/d1d8e3ed889d407e218e4963da8870b0/image.png?fm=jpg&q=80&w=640)

### Connecting an existing bot

Watch the video below for a step-by-step guide on How to Connect Your Existing Viber Account to respond.io.

![How to Connect Your Existing Viber Account to respond.io](https://i.ytimg.com/vi_webp/XsMFRbFZ5YA/hqdefault.webp) 

**Step 1:** Go to **Settings > Channels**

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

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/10oayLambNIEjOCfl2ndh8/b81e86cf537279ae1854cfbd6bf5e5cc/kapture-2023-10-04-at-11-44-15.gif?w=480&fm=avif)

**Step 3**: Sign in to [Viber Admin Panel](https://partners.viber.com/login)

**Step 4:** After signing in, select a Bot to connect to respond.io. 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 respond.io platform

**Step 6:** Click **Complete** to complete the setup in respond.io

> 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](https://respond.io/help/viber/viber#channel%5Fconfiguration) 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**

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1ZvbIjTpf6GY9KxEpRIHBu/2a74e6bacb4a916d19870ed84cd7db05/kapture-2023-09-26-at-10-15-34.gif?w=480&fm=avif)

**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.
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/5VBWH1sbrJAtlfLi7Mx6ZQ/7d315ac972c0559cfd41ef2eb8d7116f/image.png?fm=jpg&q=80&w=640)

> **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. Starting February 5th, 2024, customers cannot create Viber bots on their own and must apply [directly to Viber](https://share.hsforms.com/12pxGHMtAS3yq%5F3KcxQ6g1A4fpwx). Learn more about the [current Bot Commercial Model here](https://help.viber.com/hc/en-us/articles/15247629658525).

### How do I share my Viber link?

When you make a Viber bot, by default it won’t automatically have a live landing page on [viber.com](https://viber.com) 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](https://respond.io/blog/viber-link#toc-mobile-2).

### How do I add pre-filled text to my Viber link and QR codes?

Use respond.io'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 respond.io 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.  
   ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/qxJjo5YG0uB18wUNpkD23/fc23f0543548d37e628c37254127e9b6/image.png?fm=jpg&q=80&w=640)
4. Click **Generate Widget** button to create your QR code with the pre-filled text.
5. 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](https://respond.io/blog/viber-link#toc-mobile-4).
6. 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_?

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4CToLrlcujK5ThFByV5Y57/60084b2ce153a25c4ba114e2e80feb7c/screenshot-2023-03-23-at-4-08-17-pm.png?fm=jpg&q=80&w=640)

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](https://help.viber.com/hc/en-us) to unblock your account.

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

_Example:_

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4Qtcg6DaG5Arh9HEx78tcX/e7387034072cb7e14cf80f4bb7add1e3/image.png?fm=jpg&q=80&w=640)

If you're on the previous Bot 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](https://help.viber.com/hc/en-us/articles/8746671603485-Chatbot-Commercial-Model#:~:text=Viber%27s%20Chatbot%20Commercial%20Terms%20Agreement,%2Dper%2Ddelivered%20message%20rate.). Reach out to [Rakuten Viber's team here](https://vb.me/ContactUs) for any questions.

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 the new Viber Chatbot Pricing [here](https://help.viber.com/hc/en-us/articles/15247629658525#rate-card).

### 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](https://partners.viber.com/login)

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

Share this article

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/viber/viber)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/viber/viber)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/viber/viber)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/viber/viber)

## 

Related articles 👩‍💻

* [Viber OverviewGet an overview of the Viber channel and its capabilities. ](/help/viber/viber-overview)

Can't find what you're looking for? 🔎

[Contact Support](/contact-us)

2025-12-05T03:58:45.273Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Connect a Viber chatbot to chat with customers over Viber.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/7tin8k9c1emscQGOhIuNbC/0ed3f91c8580c4e5dfa90f035355122e/Petrina_Jo_avatar.svg","name":"JQ Lee","url":"https://respond.io/author"},"dateCreated":"2024-05-09T06:09:08.000Z","dateModified":"2025-11-14T21:02:40.338Z","datePublished":"2024-05-09T06:09:08.000Z","headline":"Viber Quick Start","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/3aY7BYwDwZvV9Jjt9ZOt3N/5d3b48e9977d5d256dc7d2efb9a98d3e/viber-logo.png","mainEntityOfPage":"https://respond.io/help/viber","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/3aY7BYwDwZvV9Jjt9ZOt3N/5d3b48e9977d5d256dc7d2efb9a98d3e/viber-logo.png","url":"https://respond.io/help/viber/viber"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/help","position":1},{"@type":"ListItem","name":"Channels","item":"https://respond.io/help/channels","position":2},{"@type":"ListItem","name":"Viber","item":"https://respond.io/help/viber","position":3},{"@type":"ListItem","name":"Viber Quick Start","item":"https://respond.io/help/viber/viber","position":4}]}]
{"@context":"https://schema.org","@type":"VideoObject","name":"How to Connect Your Existing Viber Account to respond.io","uploadDate":"2025-12-05T03:58:45.737Z","description":"How to Connect Your Existing Viber Account to respond.io","thumbnailUrl":"https://i.ytimg.com/vi/XsMFRbFZ5YA/hqdefault.jpg","contentUrl":"https://www.youtube.com/watch?v=XsMFRbFZ5YA","embedUrl":"https://www.youtube.com/embed/XsMFRbFZ5YA"}
```
