> 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/ja/build/choose-channel/viber.md).

# 会話プラットフォーム連携：Viber

Agent と Viber（Beta）の連携手順です。Viber Bot Token の取得、MaiAgent での Viber 対話プラットフォームの作成、ウェルカムメッセージの設定、1対1の対話のみ対応するなどの利用制限を説明します。

Viber は多くの国で利用されているメッセージアプリです。連携すると、ユーザーが Viber で Bot と対話した際に MaiAgent の Agent が返信し、対話履歴は MaiAgent の「すべての対話」にも表示されます。

{% hint style="info" %}
Viber 連携は現在 **Beta** 版で、対話プラットフォームの選択画面に <mark style="color:blue;">Beta</mark> と表示されます。
{% endhint %}

{% hint style="warning" %}
Viber Bot は**1対1の対話のみ**可能で、グループには参加できません。グループでの対話が必要な場合は、ほかの対話プラットフォームをご利用ください。
{% endhint %}

## 連携前の確認 <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* [MaiAgent プラットフォーム](https://admin.maiagent.ai/)で「AI アシスタント」を作成済みであること
* <mark style="color:blue;">対話プラットフォームの権限</mark>があること（権限の説明は[ロールと権限の管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md)を参照してください）
* Viber Bot の **Bot Token** を取得済みであること（次の手順を参照してください）

## 手順1：Viber Bot Token を取得する <a href="#step-get-bot-token" id="step-get-bot-token"></a>

Viber Bot の申請は商業提携を通じて行います。Viber 公式またはパートナーへの申請が必要です。申請窓口については、Viber の [Viber Partners](https://www.forbusiness.viber.com/en/messaging-partners/) ページを参照してください。Bot が有効になると、次の手順で使用する **Bot Token** が発行されます。

{% hint style="warning" %}
**対話プラットフォーム作成後は Bot Token を変更できません。** 正しい Bot の Token を取得したことを確認してから、手順2に進んでください。
{% endhint %}

## 手順2：MaiAgent で Viber 対話プラットフォームを作成する <a href="#step-create-channel-in-maiagent" id="step-create-channel-in-maiagent"></a>

### 1. 対話プラットフォーム連携を開く <a href="#step-go-to-channel-integration" id="step-go-to-channel-integration"></a>

左側メニューで <mark style="color:blue;">カスタマーサポート対話</mark> → <mark style="color:blue;">対話プラットフォーム</mark> をクリックし、右上の <mark style="color:blue;">対話プラットフォーム連携</mark> をクリックして、<mark style="color:blue;">Viber</mark> を選択します。

### 2. 基本設定を入力する <a href="#step-fill-basic-settings" id="step-fill-basic-settings"></a>

| 項目                                              | 説明                                                                                                                                                 |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">名前</mark>             | この連携に名前を付けます（必須）。MaiAgent 内でのみ使用するラベルです                                                                                                            |
| <mark style="color:blue;">AI アシスタント</mark>      | Viber のメッセージに返信する Agent を選択します                                                                                                                     |
| <mark style="color:blue;">Bot Token</mark>      | 手順1で取得した Token を入力します（必須）                                                                                                                          |
| <mark style="color:blue;">ウェルカムメッセージ</mark>     | ユーザーが初めて対話を開いた際に自動返信する内容です。上限は7,000文字で、空欄の場合は返信しません                                                                                                |
| <mark style="color:blue;">リセットコマンドを有効にする</mark> | 有効にすると、コマンドの文字列を1つ以上追加できます（例：「最初からやり直す」）。ユーザーが Viber で送信したメッセージがいずれかと完全に一致すると、そのユーザーの新しい対話が始まります。コマンド自体には返信せず、ユーザーが次のメッセージを送信した時点で、AI が新しい対話で回答します |

Viber でユーザーに表示される Bot の名前とプロフィール画像は、作成時に Viber Bot アカウントから取得するため、MaiAgent で別途入力する必要はありません。名前が28文字を超える場合、返信メッセージには先頭の28文字のみ表示されます。

### 3. 機能設定 <a href="#step-feature-settings" id="step-feature-settings"></a>

<mark style="color:blue;">機能設定</mark> タブに切り替えると、<mark style="color:blue;">OCR を有効にする</mark>、<mark style="color:blue;">システム時刻を使用して回答する</mark>、<mark style="color:blue;">送信者名を使用して回答する</mark> を調整できます。各スイッチの説明とタイムゾーンのルールは、[機能設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md)を参照してください。

### 4. 権限を割り当てて作成する <a href="#step-permission-and-create" id="step-permission-and-create"></a>

<mark style="color:blue;">権限設定</mark> タブに切り替え、この対話プラットフォームを閲覧・管理できるロールを選択してから、<mark style="color:blue;">対話プラットフォーム連携</mark> をクリックします。

MaiAgent はまず Viber に Bot Token の検証を行い、成功すると **Webhook を自動設定します**。Viber に戻って URL を入力する必要はありません。作成が完了したら、Viber で Bot と対話してテストできます。

## 作成後に変更できる設定 <a href="#settings-after-creation" id="settings-after-creation"></a>

<mark style="color:blue;">対話プラットフォーム</mark> 一覧で、このプラットフォームの <mark style="color:blue;">編集</mark> をクリックすると、次の操作ができます。

* <mark style="color:blue;">ウェルカムメッセージ</mark>やリセットコマンドを変更できます。また、<mark style="color:blue;">すべての対話をリセット</mark> で、このプラットフォームの全対話を一括リセットできます（元に戻せません）。Bot Token 欄には「設定済み。作成時のみ入力可能」と表示され、変更できません。
* <mark style="color:blue;">機能設定</mark> で <mark style="color:blue;">待機通知メッセージを有効にする</mark> をオンにすると、ユーザーのメッセージ送信後、AI が処理中の間に通知を送信できます（例：「AI が処理中です。しばらくお待ちください...」）。Viber では送信済みメッセージを変更・削除できないため、質問ごとの通知は**1回のみ**です。<mark style="color:blue;">通知の繰り返し間隔（秒）</mark> は Viber では適用されません。
* <mark style="color:blue;">有人対応への切り替え設定</mark>、<mark style="color:blue;">Webhook 設定</mark>、<mark style="color:blue;">AI Copilot</mark> などの詳細タブを設定できます。説明は[対話プラットフォーム設定の概要](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md)、[有人対応への切り替え設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/human-handoff.md)、[カスタマーサポート Copilot](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/copilot.md)を参照してください。

## 対応するメッセージの種類 <a href="#supported-message-types" id="supported-message-types"></a>

| ユーザーが送信する内容 | Agent の処理方法                    |
| ----------- | ------------------------------ |
| テキスト        | 直接回答します                        |
| 画像          | 添付ファイルとして保存し、Agent が処理します      |
| 動画          | 添付ファイルとして保存し、対話に記録します          |
| URL         | URL のテキストとして処理します              |
| 連絡先         | 連絡先の名前と電話番号をテキストとして処理します       |
| 位置情報        | 「位置情報の共有」と緯度・経度のテキストに変換して処理します |
| スタンプ        | 対話に記録するだけで、回答可能なテキストはありません     |

Agent の返信については、次のとおりです。

* **テキスト**：太字、斜体、取り消し線は Viber のテキスト書式に変換され、リンクは「テキスト (URL)」形式で表示されます。1件が7,000文字を超える場合は自動で分割して送信し、途中で切れることはありません。
* **添付ファイル**：画像は画像メッセージとして送信します。その他のファイル（音声・動画を含む）はファイルメッセージとして送信し、1ファイルの上限は50 MBです。ファイル名には拡張子が必要です。

## よくある質問 <a href="#faq" id="faq"></a>

### Bot を Viber グループに追加できますか？ <a href="#no-group-support" id="no-group-support"></a>

いいえ。Viber Bot 自体がグループに参加できないため、すべての対話はユーザーと Bot の1対1となります。

### 作成時に「Bot は別の Inbox に登録済みです」と表示されます <a href="#bot-already-registered" id="bot-already-registered"></a>

1つの Viber Bot が連携できる対話プラットフォームは1つだけです。組織内の別の対話プラットフォームに Bot がすでに連携されている場合、メッセージにそのプラットフォーム名が表示されます。先に古い対話プラットフォームを削除するか、別の Bot を使用してください。

### 作成時に「無効なトークン」と表示されます <a href="#invalid-token" id="invalid-token"></a>

Viber がこの Bot Token を受け付けていません。Token 全体を余分な空白なしでコピーしたか、Bot が引き続き有効であるかを確認してください。

### ユーザーが送信したファイルを Agent が読めません <a href="#unsupported-files" id="unsupported-files"></a>

現在処理できるのは上表に記載されたメッセージの種類のみです。Viber でユーザーが送信した文書ファイルは読み取られません。テキストを貼り付けるか、画像を送信するよう案内してください。

### Bot Token の変更や別の Bot への切り替えはできますか？ <a href="#change-token" id="change-token"></a>

Bot Token は作成後に変更できません。この対話プラットフォームを削除し、新しい Token で作成し直してください。削除時には、MaiAgent が Viber に設定済みの Webhook も削除します。

### 一部のユーザーに返信が届きません <a href="#user-unsubscribed" id="user-unsubscribed"></a>

ユーザーが Viber で Bot の購読を解除すると、そのユーザーへの Agent の返信は停止します。再度購読すると返信が再開します。


---

# 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/ja/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.
