> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SlackをCognoに連携する

> Slackを連携すると、Cognoがチームのメッセージをsuggested taskにし、Slack DMで本人に届けます。手作業の整理は不要です。

![Slack](https://mintcdn.com/genaxis/oMT3YnoHFDqPiaPK/images/integrations/slack.svg?fit=max\&auto=format\&n=oMT3YnoHFDqPiaPK\&q=85\&s=931edb4ba343fc56e10d5e60104545ed)

## 概要

| | |
| - | - |
| **方向** | 双方向 — CognoはCognoのボットが参加しているチャネルを読んでメッセージをsuggested taskにし、memberにはSlack DMで連絡を返します。 |
| **接続方法** | Slack OAuth — ワンクリック。トークンのコピーは不要です。 |
| **設定できる人** | **設定** を開けるワークスペースmemberなら誰でも。 |
| **必要なもの** | アプリをインストールでき、Cognoのボットをチャネルに招待できるSlackワークスペース。 |

Slackは、仕事の話がすでに交わされている場所です。連携してCognoのボットを必要なチャネルに招待すると、Cognoはチームがそこで話している内容を読み取り、メッセージを一目で承認できる **suggested task** に変え、taskが誰かの確認を必要とするときはSlack DMでその人に連絡します。あなたは何も整理しません。Cognoがやります。

## 事前確認

* 対象ワークスペースで **設定** を開ける。Slackの設定はowner限定ではなく、Settingsに入れるmemberなら誰でも接続できます。
* 接続したいSlackワークスペースでアプリをインストールできる（またはできる人に承認してもらえる）。
* Cognoが同期するのはボットが参加しているチャネルだけです。パブリックチャネルはCognoからワンクリックで追加でき、プライベートチャネルはSlack側でボットを招待できる必要があります。
* 個人用ではなくチームを表すSlackワークスペースを使う。Cognoが対応付けるのが一緒に働くメンバーになります。

## CognoでSlackを接続する

**1. Slack連携を開く**

対象ワークスペースで **連携** を開き、**Slack** を選択します。

**2. 接続を開始する**

**接続** を押します。Slackの認可画面が別ウィンドウで開きます。

**3. Slackで承認する**

Cognoに許可する内容を確認して承認します。承認後、Slackがもとの画面に戻します。

**4. 接続を確認する**

Slackページに **接続** セクションが表示され、Slack teamの名前が出ます。CognoはバックグラウンドでSlackのメンバーを同期するので、次にユーザーの紐付けを設定できます。CognoはSlack経由でワークスペースへの招待DMを送信しません。Cogno ワークスペースの名前がまだ「Newワークスペース」のままだった場合は、Slack teamの名前が付きます。

> [!NOTE]
>
> 接続はOAuthの1ステップだけです。Webhook URL・setting ID・tokenを手で入力する必要はありません。Cognoが接続を保持し、アクセスを自動で更新します。ペアは排他です。1つのCogno ワークスペースに接続できるSlackワークスペースは1つで、1つのSlackワークスペースを同時に接続できるCogno ワークスペースも1つです。

## Slackの権限を更新する

Cognoに新しいSlack権限を必要とする機能が追加されても、先に接続していたワークスペースは**承認済みの権限のまま**です。Slackは権限をインストール時に付与し、後から自動で広げることはありません。そのため、権限が足りないとチャネル操作がエラーになります。

新しい権限を必要とする操作を最初に使ったときにエラーとして表示されます。Slackの生のエラーではなく、対処方法が案内されます。

Slackページで、ワークスペース名の横の **権限を更新** を押してください。Slackの承認画面が開くので承認して戻ります。チャネルもユーザーの紐付けもそのまま残ります。認証情報だけを差し替えるため、紐付けを無効化して7日間の削除猶予を開始する **連携を解除** とは異なります。

これを待っている機能は他にありません。チャネルの読み取り、メッセージのsuggested task化、Slack DM、ユーザーの紐付け、同期は、そのワークスペースが最初に接続したときに承認された権限で動くため、更新してもしなくても動き続けます。影響を受けるのは新しい権限を必要とする操作だけです。**チャンネル** のトグルにはチャネル管理用scope、絵文字リアクションの操作には `reactions:write`、エージェントによるファイルアップロードには `files:write` の承認が必要です。Slackで `/invite @Cogno` を使ったチャネル追加はどちらでも動作します。

## CognoがSlackで行うこと

接続すると、Slackは **event source** になります。メッセージがloopに流れ込み、Cognoがそれをもとに動きます。行うことは3つです。

| 機能 | 内容 |
| - | - |
| **メッセージをtaskにする** | CognoはCognoのボットが参加しているチャネルを読み、そこからtaskを作成します。各taskはSlack由来の印とともにstatus内の通常行として表示され、別の提案レーンや手作業の整理は増えません。 |
| **メンションされたらDMで知らせる** | taskのコメントであなたが@メンションされると、CognoがSlack DMで知らせるので、見られないまま止まることがありません。 |
| **人をmemberに対応付ける** | CognoがSlackユーザーをワークスペースの **member** に対応付け、投稿者・メンション・DMを正しい人に解決します。 |

以下のセクションで、Cognoが読む範囲、memberの紐付け、ボットをメンションしたときの動作を説明します。

## Cognoが読むもの — そして決して読まないもの

Cognoが読むのは **Cognoのボットが参加しているチャネル** だけです（パブリック・プライベートとも）。それらのチャネルの新しいメッセージは、投稿されると同時に流れ込みます。**スレッド内の返信も対象**です。編集と削除も追従し、メッセージを編集すればCognoが持つ内容も更新され、削除すれば取り除かれます。接続時と、**データを同期** を押すたびに、Cognoは連携中の各チャネルについて **直近100件まで** のメッセージをさかのぼって取得し、ボットがアクセスできるSlackキャンバスを読みます。接続直後には、チームの文脈をワークスペースの **メモリ** に取り込むため、最近のメッセージのサンプルを一度だけ読みます。

ダイレクトメッセージとグループDMは **決して取り込まれません**。Cognoがそれらをtaskやmemoryにすることはなく、通知DMのスレッドに返信してもCognoとの会話は始まりません。ボットをチャネルから外すと以降の読み取りは止まりますが、すでに読んだ内容は残ります。

新しく取り込んだSlackの元メッセージへのリンクには、親投稿の場合も元のスレッドが含まれます。返信へのリンクでは、その返信がメッセージの遷移先になります。

## ProjectからSlackを検索する

Projectに紐付くエージェントrunは、Slackを直接読み取ります。メッセージ検索はSlackの現在のチャネル履歴を呼び出し、スレッド取得はCognoの以前の同期結果ではなくSlackの現在の返信を呼び出します。検索結果を保存するのは、スレッド・返信・リアクションの各ツールが使う数値のメッセージIDを発行するためだけであり、回答の参照元はその保存データではありません。

providerへの各リクエストは、Projectが読むSlackチャネルに限定されます。チャネルを何も選んでいなければ、ProjectはCognoボットが参加しているすべてのチャネルを読みます。チャネルを選ぶと、そのチャネルだけに絞られます。メッセージIDを知っていてもこの範囲は迂回できません。切断済みの接続と、ボットが参加していないチャネルは対象外です。プライベートチャネルは、ボットがアクセスできる必要があります。

Projectのチャネル選択肢には、Cognoのボットが参加しているチャネルだけが表示されます。選択肢に出したいチャネルは、先にSlack連携ページの **チャンネル** でオンにしてください。

検索は大文字・小文字を区別しない文字列一致で、チャネルと期間を指定でき、最大100件を返します。ライブ検索にはSlackリクエスト数の上限があります。範囲が広い、または古い検索を上限内に完了できない場合、部分的な結果を完全な結果として返すことはありません。エージェントに明示的なエラーを返し、チャネルまたは期間を狭めて再試行できるようにします。

## エージェントのSlackアクセスを制御する

Slack連携ページの **エージェントツール** では、ワークスペースのownerまたはadminが、この接続の **Slackを読み取る** と **Slackに送信** を個別に3つのmodeから選べます。

**ツールを検索** で、機能名・説明・権限キー・Tool名から絞り込めます。検索で変わるのは表示だけです。保存された **ブロック**・**確認**・**許可** の設定は変わりません。

| Mode | 動作 |
| - | - |
| **ブロック** | Engine管理のrunはこの機能を利用できません。 |
| **確認** | その呼び出しへの本人の明確な同意を待ちます。人が操作中のrunには1回限りの承認リクエストを表示し、自律runは作業の元のSlackまたはTeamsのスレッドで尋ねます。同意がなければ実行せず、再試行もしません。 |
| **許可** | 個別のツール承認なしでrunがこの機能を利用できます。Project・member・接続・チャネルの確認は呼び出しごとに引き続き行われます。 |

各機能が付与するツールは、選択の下に **ツール** として並び、現在のmodeに応じて印が付きます。確認なしで実行するものにはチェック、毎回確認するものには破線の枠と疑問符、ブロックされるものには打ち消し線が付きます。

| 機能 | 付与されるツール |
| - | - |
| **Slackを読み取る** | `slack_search_messages`、`slack_read_channel`、`slack_read_thread`、`slack_read_file`、`slack_list_channels`、`slack_get_user`、`slack_search_users` |
| **Slackに送信** | `slack_send_message`、`slack_send_file`、`slack_add_reaction`、`slack_remove_reaction`, `slack_delete_message` |

**Slackを読み取る** は、ライブメッセージ検索、チャネルの最近のメッセージの読み取り、現在のスレッド取得、Projectが読み取るチャネルで共有されたファイルの読み取り、接続ごとのProjectのチャネル一覧、メンションのためのSlackユーザーのIDや名前での検索をまとめて制御します。チャネル名とユーザーは、Cognoが最後にSlackと同期した内容を使います。ファイルを読み取ると、ファイルの情報と、エージェントが扱える形の内容が返ります。テキストファイルやPDFはテキスト（最大20,000文字）、画像は画像として返ります。スキャンなどテキストを含まないPDFは1ページ目の画像として返り、それ以外の種類のファイルは、内容を読み取っていない旨の注記とファイルの情報だけが返ります。Slackが元のファイルを提供している場合は、15分で失効するダウンロードリンクも返るため、エージェントは編集などのために元のファイルそのものを取得できます。リンクはファイルを読んだrunが終了すると使えなくなり、使用時にもProjectのチャネルに対して再確認され、Slackの認証情報がCognoの外に出ることはありません。既存の接続では、ownerまたはadminが変更するまで許可された状態を維持します。**Slackに送信** は、plain textの新規メッセージ投稿、Slackスレッドへの返信、Input Fileまたは現在のTask向けにエージェントが作成したファイルのアップロード、Slackメッセージに対するCognoのボットの絵文字リアクション追加・削除をまとめて制御し、初期状態は許可です。エージェントが投稿したメッセージにはメッセージIDが返るため、エージェントはそのメッセージのスレッドに続けて書けます（たとえば、チャネルには短い見出しだけを投稿し、詳細はスレッドに返信する）。ある接続に保存したpolicyが別の接続を許可することはありません。

変更は次のrunから反映されます。Slack接続を解除すると、実行中のエージェントからもすぐに利用できなくなります。これらの管理対象の書き込みでは **Slackに送信** が継続的な許可を示す唯一の設定です。送信先チャネルは引き続きそのProjectで選択済みかつCognoのボットが参加中である必要があります。画像や進捗・成果報告に添付するファイルを含め、すべてのファイルアップロードは保存済みSlackメッセージを対象にし、そのメッセージのスレッド内へ投稿されます。ファイルアップロードの上限は100 MBで、plain textのコメントを付けられます。Cognoは **Input Files** に表示された正確なファイルを送信できます。また、Task run中に作成したファイルを先に現在のTaskへ添付し、その添付を送信できます。Taskを持たないProject Runは、作成したファイルをrun自体に保持してそこから送信するため、Taskを作成する必要はありません。任意のローカルpathやURLを信頼済みの添付として扱うことはなく、別のTaskやワークスペースに属するファイルは拒否されます。リアクション操作は保存済みメッセージIDを対象にし、`thumbsup`やワークスペースのカスタム絵文字名のようなSlack絵文字名を使います。Slackを呼ぶ前にprovider操作を記録するため、retryによって書き込みが暗黙に重複することはありません。チャットへの返信は短く保たれます。12行を超える投稿は、全文を求められた場合を除き拒否され、何も送信されません。そのためCognoは結論を先に書き、長い一覧は画像または上位3件にまとめ、詳細はTaskに残します。

Cognoは、送信結果が未確認のメッセージを自動で再送しません。Slackは、一部の投稿が済んだあとでもエラーを返す場合があります。そのためCognoは結果を不明のまま保持し、「何も送られていない」と決めつけたり、送信に成功したと報告したりしません。

## Cognoのボットをチャネルに追加する

Cognoが読むのは、Cognoのボットが追加されたチャネルだけです。それ以外は同期もtask化もされません。チャネルの連携方法は2つあります。

**パブリックチャネル — Cognoから。** **チャンネル** には、ボットが参加できるパブリックチャネルがトグル付きで並びます。トグルをオンにするとCognoがボットを参加させ、オフにすると退出します。

**プライベートチャネル — Slackから。** Slackの仕様上、ボットは自分でプライベートチャネルに参加できません。さらにSlackは、`@Cogno` が招待されるまでそのプライベートチャネルの存在自体をCognoに知らせません。そのため招待はSlack側で行います。

**1. Cognoから始める**

**チャンネル** の見出しの横にある **プライベートチャネルにCognoを招待** を押します。Cognoが `/invite @Cogno` をクリップボードにコピーし、Slackのワークスペースを開きます（手入力でも同じです）。

**2. Slackでチャネルを開く**

Slackで、Cognoに読ませたいプライベートチャネルを開きます。Cognoが候補一覧を出すことはできません。招待されていないプライベートチャネルは、Cognoからは見えないためです。

**3. Cognoのボットを招待する**

`/invite @Cogno` を貼り付けます。またはチャネル設定の **インテグレーション** からCognoを追加します。

ボットを招待した時点で、そのチャネルは **チャンネル** にトグルがオンの状態で表示されます。同期もページの再読み込みも不要です。

プライベートチャネルのトグルをオフにする操作は他のチャネルと同じで、Cognoがそのチャネルから退出します。行は薄い表示のまま一覧に残り、トグルはオフで操作できなくなります。Slackにはボットが自分でプライベートチャネルに入るAPIが無いため、戻す方法はSlackで `@Cogno` を招待し直すことだけです。

Cognoはチャネルに参加・退出する際、そのチャネルに短い通知を投稿します。読み取りを開始した/終了したことがチャネルの参加者に伝わるようにするためで、Slack自身の参加・退出メッセージは必ず表示されるとは限りません。

## ワークスペースdataを同期する

**チャンネル** には、各チャネルが人数と最大5人分のメンバーのアバター付きで並びます（memberに未紐付けのSlackユーザーは薄く表示）。Cognoのボットが参加しているチャネルはトグルがオンで、先頭に並びます。チャネルが8つを超えると一覧の上に **チャンネルを検索** 欄が表示され、一覧はその場でスクロールします。一覧は自動で最新の状態を保ちます。Cognoのボットをチャネルに招待したり外したりすると、画面を開いたままでも一覧が更新されます。メンバー一覧・トピック・直近のメッセージなどをまとめて取り直すには、ワークスペース名の横の **⋯** メニューから **データを同期** を選びます。ワークスペースの行には最終同期時刻とチャンネル数・メッセージ数が表示されます。大きなSlackワークスペースでは同期に数分かかることがあります。失敗した場合はワークスペースの行に **同期に失敗** と理由が表示されます。

## Slackユーザーをmemberに紐付ける

CognoはSlackユーザーをワークスペースの **member** に対応付け、Slackから読み取るすべての内容を正しい人に紐づけます。

**1. メンバーの対応づけを開く**

Slackページの **メンバーの対応づけ** を開きます。Slackユーザーごとに1行、右側にmemberの選択があります。

**2. Slackからユーザーを同期する**

**ユーザーを同期** を押して、Slackから現在のメンバー一覧を取得します。botや無効化済みのアカウントは除外されます。

**3. 各ユーザーを対応付ける**

各Slackユーザーで **メンバーを選択** を開き、対応するCogno memberを選びます。後から変更・解除する場合はメニューを開き直して別のmemberを選ぶか、**対応づけを解除** します。

対応付けは正確に保ってください。Cognoは両方向で使います。届いたSlackメッセージの投稿者を解決するときと、通知やメンションで正しい人に連絡するときです。選択メニューに並ぶのは人間のmemberだけで、エージェントのmemberは紐付けできません。

**名前・ユーザーID・メンバーで検索** で、Slackの名前・SlackユーザーID・対応付け済みmember名から一覧を絞り込めます。検索をクリアすると全件表示に戻ります。

Slackユーザーが **未紐付け** の間も、そのユーザーのチャネルメッセージは流れ込み、suggested taskにもなります。ただしmemberには紐づかず、その人はCognoからのDM通知を受け取りません。

## @Cognoをメンションしたときの動作

Cognoのボットが参加しているチャネルで **@Cogno** をメンションすると、Cognoはそのメッセージを自分への依頼として扱います。数秒以内に、受け取った印として絵文字リアクションがメッセージに付きます。続いてProject Runがスレッドを読み、そのスレッドに返信します。トップレベルのメッセージでメンションすると、そのメッセージの下にスレッドが始まります。スレッド内でメンションすると、そのスレッドの続きになります。Cognoが返信したあとは、再度メンションしなくても同じスレッドで続けられ、runが対応中の間は、その後の返信もそのrunに届きます。ファイルを頼むと、Cognoはスレッドに投稿します。Slackへ送れないファイルは、Taskに添付し、スレッドにTaskのリンクを添えて返信します。

返信が届くかどうかは、次の2つの設定で決まります。いずれもSlack側ではなくCogno側の設定です。

複数のProjectが同じチャンネルを読む場合も、Project名なしで **@Cogno** をメンションできます。Cognoはスレッドを読み、依頼内容・参照されたTask・会話の文脈から、そのrunに渡されたProjectの中で対象を選びます。対象がまだ不明なら、Project単位の変更を行う前にスレッドで短く1行質問します。Projectの選択によってアクセス範囲が増えたり、保存された承認設定が省略されたりすることはありません。

| 条件 | 設定する場所 |
| - | - |
| そのチャネルがProjectのSlackチャネルに含まれている | Projectの [**Projectの連携**](/docs/ja/projects.md) で、このSlack接続の **チャンネル** からそのチャネルを選びます。どのProjectも選んでいないチャネルはどこにも置かれず、返信もありません。複数のProjectが同じチャネルを持つ場合は、どのProjectが引き受けるかをCognoが判断します。 |
| この接続の **Slackに送信** が **ブロック** ではない | Slack連携ページの **エージェントツール** で設定します（上の「エージェントのSlackアクセスを制御する」を参照）。**Slackに送信** の初期状態は許可です。**確認** では、その呼び出しへの明確な同意を待ってから返信します。 |

どちらかの条件が欠けていると、メンションにリアクションは付きますが返信は届きません。リアクションはrunが始まる前に付くもので、**Slackに送信** の設定には左右されません。ただし `reactions:write` の権限は必要です。Cognoがこの権限を求める前に接続したワークスペースではリアクションが付きませんが、返信は届きます。追加できるのはviewer以外のロールのmemberです。Slackページでワークスペース名の横の **権限を更新** を押します。viewerにはこのボタンが表示されません。

## Cognoリンクのプレビュー

SlackにCognoのTaskへのリンクを貼ると、メッセージの下にプレビューが付きます。Taskのタイトル、ステータス、担当、Project、期限に続いて、次の2行が表示されます。

* **いま** — 作業の状況です。承認待ち、担当者の対応待ち（Cognoが理由を書いていればその理由）、Cogno の直近の実行が失敗、Cogno が作業中、Cogno の実行待ちのいずれかです。進行中の作業がないときは表示されません。
* **最新** — Taskへの最後の変更、変更した人、何分前か。時刻は読む人それぞれの時間帯で表示されます。

最後に **Cogno で開く** リンクが付きます。表示の言語はワークスペースの言語設定に従います。

プレビューが付くのは、次のすべてを満たすときだけです。

* リンクを貼った人がCognoワークスペースのmemberで、上の「Slackユーザーをmemberに紐付ける」でSlackアカウントが紐付いている。それ以外の人が貼ったリンクは普通のリンクのままです。
* チャネルがSlackコネクトで他の組織と共有されていない。
* TaskがこのSlackワークスペースと接続しているCognoワークスペースにあり、まだ存在する。

プレビューはSlackのゲストを含むチャネルの全員が読めるため、ゲストがいるチャネルにTaskのリンクを貼るときは注意してください。Slackのほかのプレビューと同じく、リンクを投稿した人はプレビューを消せます。

プレビューには `links:read` と `links:write` の権限が必要です。Cognoがこの権限を求める前に接続したワークスペースでは、viewer以外のロールのmemberがSlackページで **権限を更新** を押すまで、リンクは普通のリンクのままです。

## Slackを解除する

**1. メニューを開く**

Slackページで、ワークスペース名の横の **⋯** メニューから **Slack連携を解除** を選びます。

**2. 確認する**

確認ダイアログで **解除する** を押します。

解除するとCognoはSlackの読み取りを停止し、すべてのユーザー紐付けを無効化します。Slackアプリのアンインストールは **行いません**。Slack側で外すまで、Cognoのボットはチャネルに残ります。

> [!NOTE]
>
> 逆方向でも機能します。SlackワークスペースからCognoアプリをアンインストールすると、Cogno側の連携も自動的に解除されます。

## 解除後のSlackデータの扱い

解除すると **7日間の猶予** が始まります。その間に同じSlackワークスペースを再接続すれば、チャネル・ユーザー紐付け・Cognoが読んだメッセージはそのまま残っています。猶予を過ぎると、Cognoはそのワークスペースについて保持しているSlackデータを削除します。メッセージ本文、スレッドとチャネルの記録、読み取ったSlackキャンバス、Slackユーザーとmemberの紐付けが対象です。

削除は元に戻せません。猶予後に再接続した場合はゼロからのやり直しになり、各チャネルの直近100件を再度さかのぼって取得し、Slackユーザーの紐付けもやり直します。

Slackから作られた提案taskや、すでに作成済みのtaskは影響を受けません。連携ではなくボード上のあなたのデータです。

> [!NOTE]
>
> Slackは、アプリが削除されてから14営業日以内にそのワークスペースのデータを削除することを求めています。7日間という猶予はCogno側の設定で、その期限内に収まる範囲で、短時間の解除やトークンの更新で履歴を失わないようにするためのものです。

## よくある状態

| 状態 | 意味 | 次のアクション |
| - | - | - |
| 承認後もConnect画面のまま | 接続がまだ登録されていない — Cognoは最長5分間自動で確認し続けるため、再読み込みは不要 | 少し待ちます。それでも接続されない場合は次の行を参照 |
| Slackで承認しても接続されない | そのSlackワークスペースが別のCogno ワークスペースに接続済み — 画面上のエラーなしで試行がブロックされます | 先に別のCogno ワークスペースで解除するか、そちらのワークスペースに接続します |
| **チャンネル** でオンのトグルが1つもない | Cognoのボットがまだどのチャネルにも参加していない | パブリックチャネルはトグルをオンにします。プライベートチャネルは **プライベートチャネルにCognoを招待** を押し、Slackでボットを招待します |
| 特定のチャネルが **チャンネル** にない | ボットが一度も招待されていないプライベートチャネル。Slackがその存在自体をCognoから隠しています | Slackでボットをそのプライベートチャネルに招待します。すぐに表示されます |
| プライベートチャネルのトグルがオフのまま操作できない | Cognoがそのチャネルを退出済みで、Slackにはボットが自分で再参加するAPIが無い | Slackでそのチャネルに `@Cogno` を招待し直します |
| チャネルのトグルで「Slackの権限更新が必要です」と出る | そのワークスペースのSlackトークンが、その操作に必要な権限より前に発行されている | ワークスペース名の横の **権限を更新** を押してSlackで承認し、もう一度試します |
| チャネルの参加者がCognoの参加に気づかない | Slackの参加メッセージは常に出るとは限らない(チャネルの規模やワークスペース設定による) | Cognoが読み取りの開始時と終了時に自分で通知を投稿します |
| **同期に失敗** と表示される | 直前の同期が途中で止まった — 例: Slackのレート制限 | 1分ほど待って **データを同期** をもう一度選びます |
| Cognoが回答中のスレッドに返信した | フォローアップは回答中のrunに加わる | 操作は不要です。返信は2つではなく1つです |
| **メンバーの対応づけ** が空 | Slackからメンバーがまだ取得されていない | **ユーザーを同期** を押します |
| Slackユーザーが誤ったmemberに対応付いている | リンクの修正が必要 | メニューから別のmemberを選ぶか、**対応づけを解除** して再対応付けします |
| memberにDM通知が届かない | その人のSlackユーザーがmemberに紐付いていない | **メンバーの対応づけ** でそのSlackユーザーを対応づけます |
| 再接続したワークスペースからチャネルと紐付けが消えている | 解除後の7日間の猶予が過ぎ、Cognoが保持していたSlackデータを削除済み | チャネルを再度追加し、Slackユーザーを再度紐付けます。直近のメッセージはCognoが再取得します |
| Slackのメッセージがtaskにならない | ボットがそのチャネルに不参加、会話がDMまたはグループDM（決して読まれません）、またはメッセージに実行につながる内容がなかった | ボットをチャネルに招待します。Cognoは実行につながる会話からのみtaskを提案します |
| **@Cogno** をメンションしてもリアクションだけで返信がない | そのチャネルがどのProjectにも選ばれていない、またはこの接続の **Slackに送信** が **ブロック** になっている | Projectの **Projectの連携** でチャネルを選び、**エージェントツール** で **Slackに送信** を **許可** または **確認** にします |
| **@Cogno** をメンションすると返信は来るがリアクションが付かない | そのワークスペースのSlackトークンが `reactions:write` の権限より前に発行されている | viewer以外のロールのmemberが、ワークスペース名の横の **権限を更新** を押し、Slackで承認します。viewerにはボタンが表示されません |

## 参照URL

* [Slack: アプリの追加と管理](https://slack.com/help/articles/202035138-Add-apps-to-your-Slack-workspace)
* [Slack OAuth scopes](https://api.slack.com/scopes)

## Cognoの投稿を削除する

対象投稿のスレッドでCognoにメンションして、削除を頼んでください。例: 「Cogno、直前のあなたの返信を消して」。Cognoは対象を確認し、そのSlack接続のCogno自身の投稿を削除します。候補が複数ある場合は、どの投稿か指定してください。

削除にも **Slackに送信** の権限設定が適用されます。保存された承認・拒否設定に従います。Slack scopeは既存の `chat:write` で自分の投稿を削除できます。

> [!WARNING]
>
> このツールで削除した投稿は復元できません。親投稿を削除しても、スレッド内の返信すべては削除されません。

## 関連docs

* [Troubleshooting](/docs/ja/troubleshooting.md)

## プライバシーとサポート

Cognoによるデータの収集・処理・保護については、[プライバシーポリシー](https://cogno.studio/privacy)をご確認ください。

Slack連携の設定や技術的な問題については、[技術サポート](https://cogno.studio/support)をご利用ください。

## AI生成コンテンツについて

CognoはSlackやその他の連携サービスから取得した情報をもとに、AIを使用してタスクの提案、要約、回答を生成します。AIが生成した内容には、不正確、不完全、または誤解を招く情報が含まれる場合があります。重要な情報に依拠したり、行動に移したりする前に内容をご確認ください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.