> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/viber.md).

# Connect a Conversation Platform: Viber

Connect your Agent to Viber (Beta): obtain a Viber Bot Token, create a Viber conversation platform in MaiAgent, configure a welcome message, and learn about limitations such as one-on-one conversation

Viber is a messaging app widely used in many countries. Once connected, users can chat with your Bot in Viber and receive replies from a MaiAgent Agent. Conversation records also appear in MaiAgent's All Conversations.

{% hint style="info" %}
The Viber integration is currently in **Beta** and is labeled <mark style="color:blue;">Beta</mark> on the conversation platform selection screen.
{% endhint %}

{% hint style="warning" %}
Viber Bots support **one-on-one conversations** only and cannot join groups. If you need group conversations, use another conversation platform.
{% endhint %}

## Before You Connect <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* You have created an AI Assistant on the [MaiAgent platform](https://admin.maiagent.ai/)
* You have <mark style="color:blue;">Conversation Platform permissions</mark> (see [Role and Permission Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/roles/role-permission.md) for details)
* You have obtained the Viber Bot's **Bot Token** (see the next step)

## Step 1: Obtain a Viber Bot Token <a href="#step-get-bot-token" id="step-get-bot-token"></a>

Viber Bots require a commercial partnership. Apply through Viber directly or one of its partners. See Viber's [Viber Partners](https://www.forbusiness.viber.com/en/messaging-partners/) page for application channels. Once your Bot is activated, you will receive a **Bot Token** to use in the next step.

{% hint style="warning" %}
**The Bot Token cannot be changed after the conversation platform is created.** Make sure the Token belongs to the correct Bot before proceeding to Step 2.
{% endhint %}

## Step 2: Create a Viber Conversation Platform in MaiAgent <a href="#step-create-channel-in-maiagent" id="step-create-channel-in-maiagent"></a>

### 1. Open Connect Conversation Platform <a href="#step-go-to-channel-integration" id="step-go-to-channel-integration"></a>

In the left menu, click <mark style="color:blue;">Customer Conversations</mark> → <mark style="color:blue;">Conversation Platforms</mark>, click <mark style="color:blue;">Connect Conversation Platform</mark> in the upper-right corner, and select <mark style="color:blue;">Viber</mark>.

### 2. Fill In the Basic Settings <a href="#step-fill-basic-settings" id="step-fill-basic-settings"></a>

| Field                                                  | Description                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Name</mark>                  | Give this integration a name (required). This is only a label within MaiAgent                                                                                                                                                                                                                                 |
| <mark style="color:blue;">AI Assistant</mark>          | Select the Agent that will reply to Viber messages                                                                                                                                                                                                                                                            |
| <mark style="color:blue;">Bot Token</mark>             | The Token obtained in Step 1 (required)                                                                                                                                                                                                                                                                       |
| <mark style="color:blue;">Welcome Message</mark>       | Automatically sent when a user first opens a conversation, up to 7,000 characters; leave blank to send no reply                                                                                                                                                                                               |
| <mark style="color:blue;">Enable Reset Commands</mark> | Once enabled, you can add one or more command phrases (for example, “Start over”). When a user's Viber message exactly matches one of them, a new conversation is started for that user. The command itself receives no reply. The AI responds in the new conversation when the user sends their next message |

The Bot name and avatar shown to users in Viber are imported from the Viber Bot account when the platform is created. You do not need to enter them separately in MaiAgent. If the name exceeds 28 characters, only the first 28 characters appear in replies.

### 3. Feature Settings <a href="#step-feature-settings" id="step-feature-settings"></a>

Switch to the <mark style="color:blue;">Feature Settings</mark> tab to adjust <mark style="color:blue;">Enable OCR</mark>, <mark style="color:blue;">Use System Time in Responses</mark>, and <mark style="color:blue;">Use Sender Name in Responses</mark>. For explanations of each toggle and the time zone rules, see [Feature Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md).

### 4. Assign Permissions and Create the Platform <a href="#step-permission-and-create" id="step-permission-and-create"></a>

Switch to the <mark style="color:blue;">Permission Settings</mark> tab, select the roles that can view and manage this conversation platform, then click <mark style="color:blue;">Connect Conversation Platform</mark>.

MaiAgent first validates the Bot Token with Viber. After successful validation, it **automatically configures the Webhook for you**. You do not need to enter a URL in Viber. Once the platform is created, chat with the Bot in Viber to test it.

## Settings You Can Change After Creation <a href="#settings-after-creation" id="settings-after-creation"></a>

In the <mark style="color:blue;">Conversation Platforms</mark> list, click <mark style="color:blue;">Edit</mark> for this platform to:

* Change the <mark style="color:blue;">Welcome Message</mark> or reset commands, or use <mark style="color:blue;">Reset All Conversations</mark> to reset every conversation on this platform at once (this cannot be undone). The Bot Token field shows “Configured; can only be entered during creation” and cannot be changed.
* Enable <mark style="color:blue;">Waiting Notification</mark> in <mark style="color:blue;">Feature Settings</mark> to send a notification after a user sends a message while the AI is still processing (for example, “AI is processing. Please wait...”). Viber cannot edit or delete sent messages, so only **one** notification is sent per question. The <mark style="color:blue;">Notification Repeat Interval in Seconds</mark> setting has no effect in Viber.
* Configure advanced tabs such as <mark style="color:blue;">Human Handoff Settings</mark>, <mark style="color:blue;">Webhook Settings</mark>, and <mark style="color:blue;">AI Copilot</mark>. See [Conversation Platform Settings Overview](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings.md), [Human Handoff Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff.md), and [Customer Service Copilot](https://docs.maiagent.ai/maiagent-user-guide/en/serve/copilot.md) for details.

## Supported Message Types <a href="#supported-message-types" id="supported-message-types"></a>

| User Sends | How the Agent Handles It                                                     |
| ---------- | ---------------------------------------------------------------------------- |
| Text       | Answers directly                                                             |
| Image      | Saves as an attachment for the Agent to process                              |
| Video      | Saves as an attachment in the conversation record                            |
| URL        | Processes it as URL text                                                     |
| Contact    | Processes the contact's name and phone number as text                        |
| Location   | Converts it to “Location sharing” and latitude/longitude text for processing |
| Sticker    | Records it in the conversation only; there is no text content to answer      |

When the Agent replies:

* **Text**: Bold, italic, and strikethrough formatting is converted to Viber text styles. Links appear as “text (URL)”. Messages exceeding 7,000 characters are automatically split without truncation.
* **Attachments**: Images are sent as image messages. Other files (including audio and video) are sent as file messages, with a 50 MB limit per file. File names must include an extension.

## FAQ <a href="#faq" id="faq"></a>

### Can I Add the Bot to a Viber Group? <a href="#no-group-support" id="no-group-support"></a>

No. Viber Bots cannot join groups. All conversations are one-on-one between a user and the Bot.

### Why Does “Bot Is Already Registered in Another Inbox” Appear During Creation? <a href="#bot-already-registered" id="bot-already-registered"></a>

A Viber Bot can connect to only one conversation platform. If the Bot is already connected to another conversation platform in your organization, the message includes that platform's name. Delete the old conversation platform first, or use another Bot.

### Why Does “Invalid Token” Appear During Creation? <a href="#invalid-token" id="invalid-token"></a>

Viber does not accept this Bot Token. Make sure you copied the entire Token with no extra spaces and that the Bot is still active.

### Why Can't the Agent Read Files Sent by Users? <a href="#unsupported-files" id="unsupported-files"></a>

Only the message types listed in the table above are currently processed. Document files sent by users in Viber are not read. Ask users to paste text or send images instead.

### How Do I Replace the Bot Token or Connect a Different Bot? <a href="#change-token" id="change-token"></a>

The Bot Token cannot be changed after creation. Delete this conversation platform and recreate it with the new Token. When you delete the platform, MaiAgent also removes the Webhook previously configured in Viber.

### Why Do Some Users Not Receive Replies? <a href="#user-unsubscribed" id="user-unsubscribed"></a>

When a user unsubscribes from the Bot in Viber, the Agent stops replying to that user. Replies resume when the user subscribes again.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/viber.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
