logo
Development
概要開発スペースワークスペースAPI Referenceベストプラクティス更新履歴
検索
日本語
ワークスペース / APP設定 / チャネル設定
チャネル設定
最終更新日：30日前

チャネル設定

概要

チャネル（Channels） を使用すると、ワークスペースの Agent を外部の IM プラットフォームに接続でき、ユーザーは Telegram、WhatsApp、DingTalk などのソーシャルツールや企業向けコミュニケーションツールで Agent と直接やり取りできます。

チャネル設定は APP 側の IMSettings コンポーネントで行います。

チャネル設定ページ-CN

実装済みチャネル（14以上のプラットフォーム）

グローバル IM

チャネル 特徴 グループ対応
Telegram グループ + 個別チャット、ファイル添付、Webhook 監視に対応 あり
WhatsApp デュアルプロバイダー（EL + Meta）、QR コードによるペアリング —
Line アジア太平洋地域の IM —

企業コラボレーション

チャネル 特徴 グループ対応
Teams Microsoft Teams 連携 あり
Slack Slack ワークスペース連携 あり
Discord コミュニティサーバー連携 あり
DingTalk（钉钉） 企業向けアプリ + Webhook あり

ソーシャルプラットフォーム

チャネル 特徴
Instagram Meta ソーシャルプラットフォーム
Facebook Meta ソーシャルプラットフォーム

カスタマーサポートプラットフォーム

チャネル 特徴
Intercom カスタマーコミュニケーションプラットフォーム
LiveChat オンラインカスタマーサポート
LiveDesk カスタマーサポートチケットシステム

自動化と CRM

チャネル 特徴
Zapier 自動化ワークフロープラットフォーム
Zoho SalesIQ CRM カスタマーサービス

完全なチャネル一覧とマルチモーダル機能マトリクスについては チャネル一覧 を参照してください。

接続フロー

共通手順

  1. 認証情報の設定：IMSettings でチャネルが要求する API Key / Token / Webhook URL を入力します
  2. 接続性チェック：システムが自動的に ConnectivityCheck を実行します
  3. チェック結果：
ステータス 意味 対応
pass 接続正常 そのまま公開可能
warn 一部機能に制限あり 設定を確認
fail 接続失敗 認証情報とネットワークを確認
  1. 公開：チェックに合格したらチャネルを有効化します

Telegram 設定例

  1. BotFather で Telegram Bot を作成し、Bot Token を取得します
  2. IMSettings で Telegram を選択し、Token を貼り付けます
  3. システムが自動的に Webhook を設定します
  4. 接続性チェックに合格すれば利用可能です

WhatsApp 設定例

  1. IMSettings で WhatsApp を選択します
  2. システムが QR コードを生成します（linked-device モード）
  3. WhatsApp のスマートフォンアプリで QR コードをスキャンしてペアリングします
  4. ペアリング成功後、自動的に再接続されます

マルチモーダルメッセージのサポート

一部のチャネルではマルチモーダルメッセージの送受信に対応しています：

機能 説明
画像の受信 ユーザーが IM で送信した画像を Agent に渡します
ファイルの受信 ユーザーが送信したドキュメント/ファイルを Agent に渡します
テキストの送信 Agent のテキスト応答を IM にプッシュします
画像の送信 Agent が生成した画像を IM にプッシュします
ファイルの送信 Agent が生成したファイルを IM にプッシュします

各チャネルの具体的なマルチモーダル機能の違いについては チャネルのマルチモーダル機能マトリクス を参照してください。

会話の表示

IM チャネルからの会話は、Work のセッション一覧に対応するプラットフォームのアイコン（Telegram アイコン、WeChat アイコンなど）が表示され、メッセージの送信元を区別しやすくなります。

詳細設定ガイド

Telegram 設定手順

Telegram 設定-CN

  1. Telegram で @BotFather を検索し、/newbot を送信します
  2. 指示に従って Bot 名を設定し、123456:ABCdef... のような形式の Bot Token を取得します
  3. APP → 設定 → チャネル → Telegram を選択します
  4. Bot Token を設定欄に貼り付けます
  5. 保存 をクリックすると、システムが自動的に Webhook を設定します
  6. 接続性チェックが pass と表示されれば利用可能です
  7. Telegram で自分の Bot を見つけてメッセージを送信すると、Agent が自動的に返信します

ヒント：Telegram Bot はグループと個別チャットの 2 つのモードに対応しています。Bot をグループに追加した後は、@BotName でメンションすることで Agent の返信をトリガーできます。

WhatsApp 設定手順

  1. APP → 設定 → チャネル → WhatsApp を選択します
  2. ページに QR コード が表示されます（linked-device モード）
  3. WhatsApp のスマートフォンアプリ → 設定 → リンク済みのデバイス → デバイスをリンク を開きます
  4. スマートフォンで QR コードをスキャンします
  5. ペアリング成功後、システムが自動的に接続を維持します（切断時は自動再接続）

注意：WhatsApp の linked-device モードでは、スマートフォンの WhatsApp がログイン状態を維持している必要があります。スマートフォン側でログアウトすると接続が切断されます。

DingTalk（钉钉）設定手順

  1. DingTalk オープンプラットフォームで企業内部アプリを作成します
  2. アプリの AppKey と AppSecret を取得します
  3. メッセージ受信用の Webhook URL を設定します（システムが提供します）
  4. APP → 設定 → チャネル → DingTalk を選択します
  5. AppKey、AppSecret、Webhook 設定を入力します
  6. 保存して接続をテストします

チャネルメッセージに関する注意事項

注意点 説明
メッセージ遅延 チャネルメッセージは IM プラットフォーム → バックエンド → Agent → バックエンド → IM プラットフォームの経路を通るため、通常 2～5 秒の遅延があります
テキスト長の制限 各プラットフォームには異なるメッセージ長の上限があり（例：Telegram は 4096 文字）、超過した応答は自動的に分割して送信されます
フォーマット制限 一部のチャネルは Markdown に対応しておらず（例：WhatsApp）、Agent の応答は自動的にプレーンテキストにダウングレードされます
ファイル送信 ファイルに対応していないチャネルでは、ファイルをクラウドストレージにアップロードしてダウンロードリンクを送信します
会話コンテキスト 各チャネルユーザーの会話は独立したセッションであり、Agent は同一ユーザーの会話履歴を記憶します

関連ドキュメント