チャネルへの連携方法 | MIERU CREW マニュアル

このマニュアルでできること

普段使っているチャットツールにAI社員を参加させ、メンションで指示→同じスレッドで返信を受け取るまでの設定手順を説明します。承認待ちの通知をチャットで受け取ることもできます。

チャネル	指示（双方向）	通知	公開URL
Slack	○（メンション / DM）	○	不要（Socket Mode）／ Events APIは必要
LINE	○（グループはメンション時 / 1:1）	○	必要（Webhook）
Microsoft Teams	○（メンション）	○	必要（Bot Framework）＋ Azure Bot登録

本マニュアルの操作にはMIERU CREWコンソールへのログインが必要です（アカウントの作成・ログイン方法は「0. アカウント登録とログイン」を参照）。

設定できるのは Owner / Admin ロールです。トークン類はすべて暗号化（Fernet vault）してプラットフォーム側にのみ保管され、AI社員のサンドボックスへ渡ることはありません。

仕組み（共通）

チャットでbotにメンション（またはDM）すると、割り当てられたAI社員への指示タスクになります（Web UIのCommand Inboxと同じ経路。Kill Switch・予算などの統制も同じように効きます）
AI社員が応答すると、同じスレッドに返信が届きます（応答まで最大数分。Slackは受付時に👀リアクション）
スレッド内で続けてメンションすると同じ会話の続きになります（会話はコンソールのCommand Inboxにもチャネル名チップ付きで表示されます）
指示できるのはAgent Store / Persona Studioで採用したAI社員です（公式提供の業務AI社員 CS / 楽天EC / 広告 / 経理 / Web保守もStore採用型のため対象。Manager等の標準3体は対象外）

Command Inbox（Slack / LINE / Teams発の会話がチップ付きで表示される）

Slackの接続

1Slack Appを作成する

api.slack.com/apps で「Create New App」→ ワークスペースを選択し、以下を設定します。

OAuth & Permissions → Bot Token Scopes: app_mentions:read / chat:write / im:history（任意で reactions:write=受付リアクション用、files:write=成果物ファイルの添付送信用）→ ワークスペースへインストールし Bot Token（xoxb-…）を控える
Basic Information → Signing Secret を控える

2受信方式を選ぶ

方式	設定	向き
A. Socket Mode（推奨）	Settings → Socket Mode を有効化し、App-Level Token（xapp-…、scope: `connections:write`）を発行。Event Subscriptionsで `app_mention` / `message.im` を購読	公開URLが不要。PoC・社内環境でそのまま使えます
B. Events API	Event Subscriptions の Request URL に `https://<公開URL>/api/channels/slack/events` を登録（URL検証に自動応答します）	公開URLのある本番環境向け（署名検証つき）

3コンソールに登録する

サイドバーの Channels（チャネル連携） → Slackカードの「トークン登録」でBot Token・Signing Secret・（Socket Modeの場合）App-Level Tokenを保管 →「接続テスト」が緑になったら「有効化」します。Socket Modeは有効化から約30秒以内に自動接続されます。

LINEの接続

LINE Developers で公式アカウント＋Messaging APIチャネルを作成し、Channel Secret と Channel Access Token（長期）を発行
Webhook URLに https://<公開URL>/api/channels/line/webhook を登録し、Webhookを有効化（応答メッセージ・あいさつメッセージはオフ推奨）
ChannelsページのLINEカードでSecret/Tokenを登録 → 接続テスト → 有効化

LINEにはスレッドがないため、会話はグループ / トークルーム / 1:1単位で継続します。新しい会話を始めたいときはメッセージの先頭に /new または「新しい会話」を付けてください。グループではbot宛メンションを付けた発言のみに反応します。

Microsoft Teamsの接続

Azureポータルで Azure Botリソースを作成し、Microsoft App ID / App Password（クライアントシークレット）を発行
Messaging endpointに https://<公開URL>/api/channels/teams/messages を登録し、Teamsチャネルを有効化。Teamsアプリとして組織に配布
ChannelsページのTeamsカードでApp ID/Passwordを登録 → 接続テスト → 有効化

⚠ Teams連携は実装・模擬リクエストでの検証済みですが、Azure Bot登録と公開URLが必要なため、実Teamsとの疎通は本番相当の環境で最終確認してください。また通知先に指定できるのは一度botへメッセージを送ったことのある会話のみです（送信先情報を初回受信時に記録するため）。

コンソール側の設定（共通）

1チャネル割当（どの指示をどのAI社員が受けるか）

「チャネル割当」でチャネル/グループIDと担当AI社員を紐付けます。チャネルからbotへ一度メッセージを送ると、入力欄の候補にIDが自動表示されるので、そこから選ぶのが確実です。未割当のチャネルから話しかけると、割当を促す案内が返信されます。

2通知設定

プロバイダごとに「承認依頼を通知」をオンにし、通知先ID（SlackチャネルID・LINEグループID・Teams会話ID）を設定すると、承認待ちが発生したときにカード形式の通知が届きます。承認そのものは通知内のリンクから全社承認ボードで行います（チャットからの承認操作は提供していません）。

3成果物ファイルの受け取り

AI社員が作成したファイル（Excel / Word / PDF / CSV等）は、テキスト返信のあとに同じスレッドへ届きます。Slackはファイルそのものが添付されます。LINE / Teamsはファイル添付のAPI制約があるため、ファイル名とコンソールのダウンロード先を案内するメッセージが届きます（コンソールのCommand Inboxからダウンロードできます）。

4送受信ログ

ページ下部の「送受信ログ」で受信・返信・通知・ファイル送達の成否を確認できます。トークン誤りなどの失敗はここにエラー内容つきで記録されます。

制限事項

応答まで最大数分かかります（AI社員の実行時間）。Slackは👀リアクション、LINE/Teamsは新規会話開始時の受付メッセージで受領を示します
チャットからの承認操作はできません（通知＋全社承認ボードへのリンクのみ。統制モデルを維持するための設計です）
長い応答はチャットの文字数上限で切り詰められ、続きはコンソールへ誘導されます
BFF停止中に発生したイベントの通知は再送されません（コンソール側には全て記録されています）
開発検証用フラグ CHANNEL_DEV_ALLOW_UNSIGNED（署名検証スキップ）は本番で有効化しないでください

困ったとき

症状	対処
botに話しかけても反応がない	①Channelsページで「有効」バッジと接続テストを確認 ②チャネル割当があるか確認 ③グループではメンション付きで話しかける ④送受信ログにエラーがないか確認
「このチャネルはまだAI社員に割り当てられていません」と返る	チャネル割当でそのチャネルIDに担当AI社員を設定してください（候補に表示されます）
返信が来ない（受付リアクションはある）	応答まで最大数分かかります。送受信ログの「返信」がfailedの場合はBot Tokenの権限（chat:write）や通知先を確認
接続テストが「invalid_auth」等で失敗する	トークンの値・種類（SlackはBot Token=xoxb-）を確認して「トークン更新」で再登録してください
Webhookが401になる	署名検証エラーです。Signing Secret / Channel Secret がSlack・LINE側の値と一致しているか確認してください
「CONNECTOR_VAULT_KEY未設定…」と表示される	管理者が `infra/.env` にFernet鍵を設定してください（コネクタ設定と共通の鍵です）
Teamsへの通知が「service_urlが未記録」で失敗する	通知先の会話から一度botへメッセージを送ってください（送信先情報が記録されます）