各項目の意味：
| 項目 | 説明 |
| ---------------------- | ----------------------------------------------- |
| **名称** | チャンネルの表示名。複数チャンネルがある場合の識別に便利 |
| **Agent を紐づけ** | 作成済みの Cherry Agent を1つ選択します。紐づけない場合は汎用モデルで返信します |
| **アプリ ID / アプリシークレット** | 飛書オープンプラットフォーム → 自作アプリ → 資格情報と基本情報 |
| **暗号鍵 / 検証トークン** | 飛書オープンプラットフォーム → イベント購読、任意 |
| **ドメイン** | `飛書（中国）` / `Lark（国際版）`、どちらか一方 |
| **許可するチャット ID** | 空欄なら制限なし。入力すると指定したグループ/個人チャットのみ応答します |
| **チャンネル権限モード** | `エージェント設定を継承` / カスタム。継承のままにすることを推奨します |
入力後、 **保存**をクリックします。チャンネルを有効化すると、飛書のメッセージイベント購読が自動的に開始されます。
### プラットフォーム別の資格情報準備
{% tabs %}
{% tab title="飛書 / Lark" %}
**接続方法は2通りあり、QRコード方式を推奨します**：
* **QRコード登録（推奨）**：飛書チャンネルの詳細で **アプリ ID / アプリシークレット**を空欄にしたままにしておくと、チャンネル有効化後にQRコードが自動で表示されます。スマホの飛書でスキャンするだけでボットアプリを自動作成でき、**オープンプラットフォームで手動設定する必要はありません**。
* **手動接続（上級者向け）**：
* オープンプラットフォームで [オープンプラットフォーム](https://open.feishu.cn) で **自作アプリ**
* を作成し **App ID** と **App Secret** をコピーしてフォームに入力
* 飛書アプリの **イベント購読** で長接続（WebSocket）を有効化
* オープンプラットフォームで **権限管理** で少なくとも以下を有効にする：個別チャットメッセージの受信、グループチャットメッセージの受信、メッセージ送信
{% endtab %}
{% tab title="Telegram" %}
* と [@BotFather](https://t.me/BotFather) と会話し、`/newbot` でボットを作成
* を作成し **Bot Token**
* フォームに Bot Token を入力すればOK
* （任意）特定の会話でのみ応答させたい場合は、まずボットをグループまたは個人チャットに追加し、その後 [@get\_id\_bot](https://t.me/get_id_bot) で Chat ID を取得して「許可する会話 ID」に入力
{% endtab %}
{% tab title="QQ" %}
* QQ オープンプラットフォームでボットを申請 → アプリを作成 → **App ID** と **Client Secret**
* をコピーしてフォームに入力
* （任意）許可する会話 ID の形式：`c2c:openid`（個別チャット）、`group:groupid`（グループ）、`channel:channelid`（チャンネル）
{% endtab %}
{% tab title="WeChat" %}
* **WeChat チャンネルの接続方法は QR コードでログインする方式です**、事前登録は不要です：
* チャンネル詳細で **WeChat アカウントを追加**
* チャンネルを有効化すると QR コードが表示されます
* スマホの WeChat でスキャンすればログインできます
* （任意）許可するユーザー ID の形式：`wxid_xxxxx`、複数ある場合はカンマ区切り
{% endtab %}
{% tab title="Discord" %}
* オープンプラットフォームで [Discord Developer Portal](https://discord.com/developers/applications) 新規 Application
* Bot サブページで生成 **Bot Token** してフォームに入力
* ボットをあなたのサーバーに招待
* （任意）チャンネル範囲を制限したい場合：ボットを対象チャンネルに追加した後、ボットに `/whoami` と送れば、形式が正しいチャンネル ID を取得できます
{% endtab %}
{% tab title="Slack" %}
* オープンプラットフォームで [Slack API](https://api.slack.com/apps) 新規 App
* 有効化 **Socket Mode**を有効にし、それぞれ **App-Level Token**（`xapp-...`）と **Bot Token**（`xoxb-...`）を生成
* 2つの Token をどちらもフォームに入力
* （任意）チャンネル範囲の制限：ボットに `/whoami` Slack チャンネル ID を取得
{% endtab %}
{% endtabs %}
### 1つの Agent は複数チャンネルを接続できますか？
できます。同じ「レポート支援」Agent を、飛書の社内グループ（同僚向け報告）とあなたの Telegram 個人チャット（自分向け通知）に同時接続できます。互いに干渉しません。各チャンネルは会話と権限を独立して管理します。
### 定時タスクとの連携
* チャンネルは **受信して** ユーザーのメッセージをトリガーに Agent が返信
* [定時タスク](/docs/jp/advanced-basic/scheduled-tasks.md) することも **能動的に** Agent を呼び出して、その結果をチャンネル経由で IM プラットフォームに送信することも
* できます。両者を組み合わせることで、完全な「日報ボット」形態を実現できます
### よくある質問
#### 追加後にボットが反応しない
* 確認 [APIサーバー](/docs/jp/advanced-basic/api-server.md) が **実行中** の状態であることを
* 紐づけた Agent のモデル Provider の残高が十分か確認
* 「許可するチャット ID」が誤っていないか確認（空欄なら制限なし）
#### 飛書ボットをグループに入れたのに @ メッセージを受け取れない
* 飛書オープンプラットフォーム → 権限管理で、「グループ内のすべてのメッセージを取得」が有効になっているか確認
* グループ内でボットを右クリック → 設定 → 「このグループ内でボットが @ されることを許可」を有効化
#### WeChat チャンネルが切断される
* WeChat ボットの接続は比較的脆弱なため、まずは飛書 / Telegram の利用を推奨します
* 長期間使わないと WeChat によって自動的にオフラインになります。iLink に再ログインすればOKです
{% hint style="warning" %}
プラットフォームごとに自作ボットに対するコンプライアンス要件が異なります。企業内グループで有効化する前に、所属組織 / プラットフォームからの許可を取得していることを確認してください。
{% endhint %}
***
### 💡 ヘルプの取得とフィードバックの送信
設定や使用の途中で疑問、バグ、機能改善の提案があれば、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式窓口をご参照ください。
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cherryai.com.cn/docs/jp/advanced-basic/agent-channels.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.