# Viber 独自の **Viberボット** を接続することで、Viberの会話をアプリに取り込み、AIエージェントが返信できるようにします。ボットの認証トークンを1つ貼り付けるだけで接続でき、残りの設定はすべてこちらで行います。 --- ## Viber連携とは？ Viber連携は、Viberの公式Bot APIを使用して、所有している **Viberボット** をプラットフォームにリンクします。これは、手動でメッセージを入力する代わりに、メッセージを自動的に送受信するためのViber独自のシステムです。ボットとフォロワーとの会話はアプリ内で利用可能になり、AIエージェントと共有インボックスがその上で機能します。 これは **公式** の連携であるため、安定しており、Viberの規約に準拠しています。 > **利用可能地域。** Viberは、フィリピン、ベトナム、その他の東南アジア地域、および東欧やギリシャで最も広く利用されています。 --- ## 始める前に **独自のViberボットが必要です。また、Viberは有料のビジネスプランでのみボットを発行しています。** 2024年2月以降、Viberは無料ボットの作成を終了しました。アカウントはViberで直接設定し、そのアカウントと料金はViberとの直接契約となります。当社は再販や上乗せ請求、手数料の徴収は行っておらず、お客様に代わってボットを作成することもできません。 執筆時点で、Viberはボットごとに月額料金を請求し、さらにボットが開始したメッセージに対してメッセージごとの料金を請求しています（以下の [コスト](#cost) を参照）。料金はViberが変更する可能性があるため、登録時にViberの最新の利用規約を確認してください。 セルフサービスの登録フォームはありません。Viberはすべてのチャットボット申請を手作業で審査しており、以下のいずれかの方法で申請します。 - **Viber認定パートナー経由**: Viberが推奨する方法であり、通常こちらの方が迅速です。 - **Viberへ直接**: `partners@viber.com` 宛てにメールを送信します。すでにViberと取引がある場合は、担当のビジネスアカウントマネージャーに依頼することも可能です。 申請が承認されると、Viberの契約書に署名し、商用利用規約に同意することで、ボットが作成されます。 その後、Viberアプリの **その他 → 設定 → ボット → 情報の編集 → アプリキー** からトークンを確認できます。Viberではこれを*アプリキー*と呼んでいますが、APIドキュメントでは同じ値を*認証トークン*と呼んでおり、ボット管理者もViberの管理パネルで確認できます。どのような名称であっても、このアプリで求められる値はこれ一つです。 Viberから必要なのはそのトークンのみです。ここでの設定は1分ほどで完了します。 --- ## Viberの設定 ### ステップ1：ボットの認証トークンをコピーする 最も簡単に確認できる場所は、スマートフォンのViberアプリ内です。 1. ボットを所有するアカウントのスマートフォンでViberを開きます。 2. **その他 → 設定 → ボット** に移動します。 3. ボットを選択し、**情報の編集** をタップします。 4. **アプリキー** の下に表示されている値をコピーします。それがトークンです。 > このトークンは非公開にしてください。トークンを知っている人は誰でも、あなたのボットとしてメッセージを送信できます。 ### ステップ2：アプリでViberを接続する 1. 左側のサイドバーで、下部付近にある **Settings** をクリックします。 2. Settings の左側レールにある **Channels** の下で、**Channels** をクリックします。 3. **Viber** カードを見つけて、**Connect** をクリックします。 4. **auth token** を貼り付けます。 5. **Connect** をクリックします。 6. アプリが Viber でトークンを確認し、**"Connected to: "** と表示されます。 **設定が必要なウェブフックはありません。** 他のほとんどのチャネルとは異なり、接続の一環としてすべてを Viber に登録するため、別のコンソールにコピーするものは何もありません。接続済み画面に表示されるアドレスは、メッセージの到達先を示すものであり、サポートが必要な場合に共有するためのものです。 ### ステップ 3: ボットをテストする 1. 別の電話から Viber を開き、**ボットをフォロー**します（検索するか、リンクを使用してください）。 2. **メッセージを送信します。** 3. アプリを開き、**Chats** に移動します。受信したメッセージが会話リストに表示されます。 4. AI エージェントがこのチャネルを処理している場合、**自動的に返信**されるのがわかります。 接続が完了すると、Viber ボットは Channels ページで **Connected** と表示され、AI が受信メッセージに応答するようになります。 --- ## ボットがメッセージを送信できる相手 これは Viber に関して理解しておくべき最も重要なことであり、他のすべてのチャネルとは異なります。 **ボットは、フォローしてくれたユーザーにのみメッセージを送信できます。** 何かメッセージを送るには、まず誰かがあなたのボットを見つけてフォローする必要があります。ボットをフォローしていない Viber ユーザーにメッセージを送る方法はありません。 誰かがボットのフォローを解除したりブロックしたりした場合、そのユーザーが再度フォローしてメッセージを送ってくれるまで、メッセージを送ることはできません。その場合、アプリは会話にマークを付けて送信を停止し、送信した返信は黙って消えるのではなく、説明付きで失敗として表示されます。 このため、Viber は **サポートおよび返信チャネル**（誰かがメッセージを送り、AI が回答する）としては非常にうまく機能しますが、コールドアウトリーチ（新規開拓）チャネルとしては不向きです。 --- ## 料金 Viber はアプリ内で **無料** のチャネルです。メッセージごとの料金や、当社からの月額接続料金は発生しません。 費用は、お客様ご自身のアカウントで **Viber** に支払うものとなります。 - **ボットごとの月額料金**（執筆時点で約100ユーロ）。 - **ユーザーが開始した会話内での返信は、無料かつ無制限です。** これは AI エージェントが行うほぼすべての処理をカバーします。 - **ユーザーが開始した会話の外でボットが送信するメッセージ**は、受信者の国に応じた料金がメッセージごとに課金されます。 実用的な結論として、ユーザーへの回答には月額料金以外の費用はかかりません。ブロードキャストやプロアクティブなフォローアップがコストの要因となります。 --- ## メディアメッセージ 受信した写真、動画、ファイル、スタンプ、位置情報、共有連絡先は認識されるため、AI はメディアが送信されたことを把握します（会話に短いメモが追加されます）。このバージョンでの送信 AI 返信は **テキストと画像** です。長い返信は、Viber の 7,000 文字の制限に合わせて自動的にトリミングされます。 --- ## セッション管理 ### 接続ステータスの確認 Viber の接続ステータスは、**Channels** ページの **Viber** カードに表示されます。 | ステータス | 意味 | |---|---| | **接続済み** | Viberボットがこのアカウントにリンクされています | | **接続済み、要対応** | 他の何かがボットを乗っ取っているため、メッセージがこちらに届いていません | | **未接続** | 接続が設定されていません | カードは「チャネル」ページを開くたびにボットを再チェックします。**Viberボットは一度に1つの場所にしかメッセージを送信できません**。そのため、同じボットを別のツールに接続すると、そのツールが乗っ取り、Viberからの警告なしにこちらへのメッセージの到着が停止します。これが**「接続済み、要対応」**の意味です。カードを開いて再接続し、取り戻してください。 ### 切断 **Viber**カードを開いて**管理**をクリックし、**切断**をクリックして**Viberを削除しますか？**を確認します。これにより、ボットのメッセージの受信が停止され、アカウントから削除されます。ボット自体はあなたの所有のままです。Viberアカウントには何も変更はありません。 --- ## 制限事項 - **フォロワーのみ。** ボットはフォローしているユーザーにしかメッセージを送れません。[ボットがメッセージを送れる相手](#who-your-bot-can-message)を参照してください。 - **独自の有料Viberボットが必要です。** 当社では提供できません。 - **1接続につき1ボット。** 各ボットを個別に接続してください。1つのボットは1つのアカウントにしかリンクできません。 - **テキストと画像の送信。** AIはテキストと画像を返信します。このバージョンではカルーセルやリッチカードは送信されません。 - **ウェルカムメッセージなし。** ユーザーが初めてボットを開いたものの、まだフォローしていない場合、Viberは1回限りのインスタント挨拶を許可します。このバージョンでは送信されません。会話はユーザーが最初のメッセージを送信したときに始まります。 --- ## トラブルシューティング ### 接続時にトークンが拒否される - Viberアプリの **Edit Info → Your app key** から値をコピーしたことを確認してください。別のIDではないことを確認してください。 - Viberアカウントでボットがまだアクティブであることを確認してください。 - 接続時には、Viberが当社に到達できるかどうかもチェックされます。トークンが確実に正しく、それでも失敗する場合は、1分待ってから再試行し、サポートに連絡してください。 ### 「このViberボットはすでに別のアカウントに接続されています」 同じボットがアプリ内の別のアカウントにリンクされています。先にそちらで切断するか、別のボットを使用してください。 ### ボットが応答しない - カードが「接続済み、要対応」ではなく**「接続済み」**と表示されていることを確認してください。 - テスト対象のユーザーが**ボットをフォローしている**ことを確認してください。Viberはフォロワーからのメッセージのみを配信します。 - このチャネルにAIエージェントが割り当てられていることを確認してください。 ### メッセージが届かなくなった これはほとんどの場合、[接続ステータスの確認](#checking-connection-status)で説明した乗っ取りの問題です。同じボットが別のツールに接続されています。**Viber**カードを開いて再接続してください。 ### 「未購読（Not Subscribed）」で返信に失敗した そのユーザーがボットのフォローを解除したか、ブロックしました。ユーザーが再度フォローし、先にメッセージを送ってくるまで、こちらからメッセージを送ることはできません。 --- ## ベストプラクティス - **アウトリーチではなくサポートを優先する。** ユーザーが開始した会話内での返信は無料かつ無制限ですが、こちらから開始するメッセージは課金対象となり、フォロワーにしか届きません。 - **ボットをフォローしやすくする。** サイト、メール署名、その他のチャネルにボットのリンクを掲載してください。フォローしてもらうことが、ユーザーがボットに連絡できる唯一の方法です。 - **認証トークンを安全に保管する。** トークンを持つ者は誰でもあなたのボットとして送信できます。漏洩した場合はViberアプリで再生成し、こちらで再接続してください。 - **同じボットを2つのツールに接続しない。** 2つ目のツールがサイレントに乗っ取ります。