Slack App ガイド

OOMOL では Slack workspace を一度接続するだけで、承認済みのツール呼び出しを通じて、認可済み Slack ツールを対応 AI エージェントと再利用可能な Skills から利用できます。このガイドでは、Slack App のインストールと接続方法、OOMOL が使用する Slack 権限、利用できる操作、よくある問題の解決方法、App の削除方法を説明します。

OOMOL は、外部アカウントを接続する前にユーザーのサインインを要求します。Slack App をインストールするには、OOMOL にサインインし、Slack 接続ページを開き、Connect を選択して Slack OAuth 認可フローを開始します。

OOMOL で Slack を接続する

前提条件

• OOMOL アカウント。
• 接続したい workspace 内の Slack アカウント。
• その workspace で Slack Apps をインストールまたは認可する権限。
• https://console.oomol.com/ の OOMOL Console へのアクセス。
• Slack workspace が App インストールを制限している場合、認可する前に Slack workspace の owner または administrator が OOMOL App を承認する必要があります。

App を追加する

1. OOMOL Console にサインインします。
2. App Connections の Slack を開くか、App Connections を開いて Slack を検索します。
3. Slack を選択し、Connect を選びます。
4. OOMOL が Slack にリダイレクトします。求められた場合は Slack にサインインします。
5. Slack から選択を求められた場合は、接続する Slack workspace を選択します。
6. 要求された権限を含め、Slack の認可画面を確認します。
7. Allow を選択して OOMOL を認可します。
8. Slack から OOMOL に戻った後、OOMOL の connections で Slack が接続済みとして表示されることを確認します。

いずれかの手順が失敗した場合は、トラブルシューティング を参照してください。

認可後、OOMOL は Slack ツールをお客様に代わって呼び出すために必要な接続を保存します。その後、OOMOL 対応エージェントと再利用可能な Skills から、承認済みツール呼び出しを通じて Slack ツールを使用できます。

OOMOL が Slack で行うこと

OOMOL Slack App は、workspace を接続した後に Slack アクションを利用可能にします。実行するアクションに応じて、OOMOL は接続済み App がアクセスできる channels と threads の読み取り、OOMOL App としてのメッセージ投稿、threads への返信、メッセージ予約、ファイルアップロード、direct messages の開始、emoji reactions の追加または削除を行えます。

OOMOL は、インストール後に自動で Slack を使い始めません。Slack ツールは、認可済みユーザー、再利用可能な Skill、対応エージェントアクション、または承認済み OOMOL ツール呼び出しが必要な destination と content を提供したときに実行されます。

インストール後

Slack から OOMOL に戻った後、OOMOL Console で Slack 接続が接続済みとして表示されていることを確認します。その後、以下を行えます。

• 対応 AI エージェント環境で接続済み Slack ツールを使いたい場合は、oo-cli を設定します。
• テスト channel を使って、表示可能な Slack channels の一覧表示、最近の messages の読み取り、デモ message の投稿、thread への返信、デモ file のアップロード、テスト reaction の追加を試します。
• workspace ポリシーでその channel の App membership が必要な場合は、読み取りまたは投稿したい private channel に OOMOL App を招待します。

使い方

Slack ツールは、Slack workspace を接続した後にのみ利用できます。OOMOL に表示される正確なツール一覧はコネクタの更新により変わる場合がありますが、現在の Slack コネクタには conversations の読み取り、threads の読み取り、messages の送信、threads への返信、messages の予約、bot が投稿した messages の管理、files の操作、users の読み取り、direct messages の開始、emoji reactions の管理に使うツールが含まれます。

oo-cli で Slack ツールを使う

接続済み Slack ツールを対応 AI エージェント環境で利用できるようにするには、OOMOL にサインインした後で oo-cli をインストールして設定します。

1. OOMOL Console にサインインします。
2. oo-cli インストールページ を開きます。
3. そのページの手順に従います。対応 AI エージェント環境に oo-cli をインストールして設定するためのワンクリックコピー用プロンプトが用意されています。
4. oo-cli の設定が完了し、Slack が OOMOL に接続されたら、デモ channels、messages、files を使って接続済み Slack ツールを使用するようエージェントに依頼します。

具体的なエージェントプロンプトは環境によって異なります。たとえば、表示可能な Slack channels の一覧表示、test channel の最近の messages の読み取り、デモ message の投稿、thread への返信、test message への reaction 追加を依頼できます。

使用する権限

OOMOL は Slack 権限を使用し、認可済み Slack ユーザーが workspace を OOMOL の App として接続し、承認済み Slack ツールをエージェントと再利用可能な Skills で利用できるようにします。

Slack OAuth 中に表示される正確な scopes が、そのインストールの正しい情報源です。workspace で有効なツールに応じて、OOMOL は以下のカテゴリの権限を要求する場合があります。

Slack 管理者が必要な権限を付与しない場合、Slack 接続が失敗するか、その権限に依存するツールが権限付与まで利用できない場合があります。

対応 Slack ツール

conversations と threads を読む

用途: エージェントが最近の Slack messages または特定の thread を確認してから、updates の要約、action items の抽出、reply の準備、別の接続済みツールへの作業ルーティングを行えるようにします。

前提条件:

• Slack が OOMOL に接続されている。
• 接続済み Slack App が対象 conversation または thread にアクセスできる。
• エージェント、Skill、ツール呼び出しが正しい channel、conversation、message、thread identifier を持っている。

ツールが行うこと:

• 接続済み Slack App に表示される conversation metadata、recent messages、thread replies を読み取ります。
• 接続済み workspace 認可によって利用可能になった Slack データを返します。
• 読み取り専用アクション中に messages の投稿、更新、削除、reaction を行いません。

messages を送信および管理する

用途: タスク完了後に、エージェントが status update の投稿、thread への返信、reminder の予約、1 人の user への ephemeral message 送信、bot-posted message の更新を行えるようにします。

前提条件:

• Slack が OOMOL に接続されている。
• 対象 channel、conversation、user、message、thread が分かっている。
• ユーザー、Skill、エージェントが message content を提供し、destination を承認している。

ツールが行うこと:

• content が提供されたときに plain-text messages または Block Kit messages を投稿します。
• parent message が提供されたときに既存 threads 内で返信します。
• Slack が destination と timestamp を受け入れる場合、future time に messages を予約します。
• 接続済み App が target message を管理できる場合にのみ messages を更新または削除します。

files と reactions を扱う

用途: エージェントが Slack で file を共有し、file metadata を確認し、message を acknowledged、queued、completed、follow-up needed として示す reaction を追加できるようにします。

前提条件:

• Slack が OOMOL に接続されている。
• 対象 conversation、file、message、reaction name が分かっている。
• file upload の場合、connector runtime が取得できる URL で file が利用可能である。

ツールが行うこと:

• file URL と destination が提供されたときに Slack に files をアップロードします。
• 接続済み App に表示される file metadata と reactions を読み取ります。
• Slack が接続済み App に許可している場合、reactions を追加または削除します。
• 接続済み App が target file を削除できる場合にのみ files を削除します。

App をテストする

App のインストールが許可されている Slack workspace で Slack App をテストできます。読み取り、投稿、更新、file、reaction アクションを安全に試すため、test channel と demo messages を使用してください。

テストプロンプト例

• 接続済み App に表示される Slack public channels を一覧表示して。
• #oomol-test channel の最近の messages を取得して。
• #oomol-test channel に Hello from OOMOL を投稿して。
• 最新の test message に Received と返信して。
• test message に white_check_mark reaction を追加して。
• test message の reactions を取得して。
• test channel に Slack message を今日の後で投稿するよう予約して。
• test channel に demo file をアップロードして。
• 接続済み App に表示される Slack users を一覧表示して。
• test user との direct message を開いて。

テスト中はデモデータのみを使用してください。テストプロンプトに実際の顧客、従業員、または機密 Slack コンテンツを使用しないでください。

トラブルシューティング

Slack App を追加できない

• 正しい OOMOL アカウントにサインインしていることを確認します。
• 接続したい Slack workspace にサインインしていることを確認します。
• Slack workspace が App 承認を要求する場合、Slack workspace owner または administrator に OOMOL App の承認を依頼します。
• OOMOL で失敗または途中状態の Slack 接続を切断し、もう一度接続してみます。
• 問題が続く場合は、OOMOL サポートに連絡し、OOMOL アカウントのメール、利用可能であれば Slack workspace name または ID、試行時刻、エラーメッセージまたはスクリーンショットを含めてください。

Slack ツールが channel または conversation を見つけられない

• 接続済み Slack App が対象 conversation にアクセスできることを確認します。
• 対象が private channel の場合、接続済み App がその channel に追加されているか、必要な workspace 権限を持っていることを確認します。
• リクエストが正しい conversation ID、channel name、search input を使用していることを確認します。
• Slack 権限を最近変更した場合は、認可状態を更新するために Slack を OOMOL で再接続します。

Slack ツールが messages を読めない

• 接続済み Slack App に対象 conversation history を読む権限があることを確認します。
• message が private channel にある場合、その App が private channel に存在することを確認します。
• リクエストが正しい message timestamp、thread timestamp、conversation ID を使用していることを確認します。
• workspace で App scopes または channel access が最近変更された場合は、Slack を OOMOL で再接続します。

Slack ツールが message を投稿または更新できない

• 接続済み Slack App が対象 conversation に投稿できることを確認します。
• ツール呼び出しに有効な destination と message body があることを確認します。
• update と delete actions では、target message が接続済み Slack App によって投稿され、その App が管理できることを確認します。
• Slack が workspace policy または permission error を返す場合、Slack workspace owner または administrator に App 権限の確認を依頼します。

Slack file action が失敗する

• upload actions では、file URL が connector runtime からアクセス可能であることを確認します。
• 接続済み Slack App が対象 conversation にアクセスできることを確認します。
• delete actions では、接続済み App が target file を削除できることを確認します。

App を削除する

Slack App は OOMOL または Slack のどちらからでも削除できます。OOMOL に Slack へのアクセスを許可し続けたくない場合は、両方から削除することを推奨します。

OOMOL から Slack を削除する

1. OOMOL Console にサインインします。
2. Connections を開きます。
3. 接続済み Apps から Slack を探します。
4. Slack 接続の詳細を開きます。
5. Disconnect、Remove、または OOMOL に表示される同等の削除アクションを選択します。
6. 削除を確認します。

Slack から OOMOL を削除する

1. 接続済み workspace で Slack にサインインします。
2. Manage apps または workspace の Slack App 管理ページを開きます。
3. OOMOL を探します。
4. App の詳細を開きます。
5. App を削除、アンインストール、取り消すアクションを選択します。
6. 削除を確認します。

Slack で Apps を削除できない場合は、Slack workspace owner または administrator に削除を依頼してください。

削除後に起きること

• Slack 接続が削除または認可解除されると、OOMOL はその workspace で Slack ツールを使用できなくなります。
• Slack に依存する agents、Skills、その他の tasks は、Slack を再接続するまで失敗する場合があります。
• 削除前に作成された Slack messages、files、channels、reactions は、Slack で削除または変更しない限り Slack に残ります。
• App を削除しても OOMOL アカウントは削除されません。

データの取り扱い

OOMOL は、Slack ユーザーが App を認可し、ユーザー、Skill、または承認済みエージェントアクションが Slack を必要とする場合にのみ Slack データへアクセスします。OOMOL は、OOMOL 対応エージェント、再利用可能な Skills、承認済みツール呼び出しを通じて要求された Slack ツールを提供する目的でのみ Slack データを使用します。

• Slack OAuth トークンは暗号化して保存されます。
• Slack OAuth トークンは AI エージェント、プロンプト、プロジェクトファイル、エンドユーザーに公開されません。
• Slack ツールが呼び出されたとき、OOMOL は Slack workspace metadata、conversation metadata、messages、thread replies、files、user metadata、reactions を処理する場合があります。
• Slack データは、ユーザーに表示されるツール結果、利用記録、実行履歴、運用記録に必要な範囲でのみ保存される場合があります。
• 保存データは保存時に暗号化され、TLS/SSL で送信されます。
• OOMOL は Slack データを販売しません。
• OOMOL は Slack データを広告に使用しません。
• OOMOL は非公開の顧客コンテンツを AI モデルのトレーニングに使用しません。
• OOMOL はこのコネクタの一部として、Slack workspace データをバックグラウンドで継続的に同期または複製しません。Slack データは、認可済みユーザー、Skill、または承認済みエージェントアクションが Slack ツールを呼び出したときにアクセスされます。
• Slack App を削除または認可解除すると、OOMOL は取り消された Slack 認可の使用を停止します。OOMOL は通常の接続削除プロセスに従って、保存された Slack 認可トークンを削除または無効化します。
• 一部のログ、サポート記録、セキュリティ記録、請求関連記録は、プライバシーポリシー に記載のとおり保持される場合があります。

FAQ

有料 Slack workspace は必要ですか？

ほとんどの OOMOL Slack ツールでは、要求された App 権限を許可する Slack workspace が必要です。一部の Slack 機能、App approval controls、retention settings、workspace policies は、Slack プランまたは組織設定に依存する場合があります。

複数の Slack workspace を接続できますか？

OOMOL Console で、お客様のアカウントまたは workspace で現在利用できる接続オプションを確認してください。複数の Slack workspaces について支援が必要な場合は、サポートに連絡してください。

接続後、エージェントは Slack を自動的に使えますか？

Slack を接続すると OOMOL で Slack ツールが利用可能になりますが、ツールの利用は選択した agent、Skill、権限、承認に依存します。アカウントベースのサービスでは引き続きお客様の認可が必要です。

接続後、OOMOL はすべての Slack messages を読みますか？

いいえ。OOMOL はすべての Slack messages を継続的に同期しません。Slack データは、認可済みユーザー、Skill、または承認済みエージェントアクションが、接続済み App がアクセスできる conversation に対して Slack ツールを呼び出したときにアクセスされます。

OOMOL は Slack messages や files を削除できますか？

現在の Slack コネクタには、bot が投稿した messages と、接続済み App が削除を許可されている files の削除アクションが含まれます。OOMOL は、ユーザーまたは承認済みツール呼び出しが必要な target 情報を指定して対応削除ツールを使用しない限り、Slack コンテンツを削除しません。

サポートに連絡する

Slack App の追加、使用、テスト、削除について支援が必要な場合は、OOMOL サポートに連絡してください。

• Email: support@oomol.com
• サポートページ: https://oomol.com/ja/support/

OOMOL アカウントのメール、関連する場合は Slack workspace name または ID、実行しようとしたアクション、エラーメッセージまたはスクリーンショットを含めてください。