--- author: OOMOL author_url: https://oomol.com/ja/about/ title: Slack App ガイド description: OOMOL で Slack App を追加、使用、トラブルシュート、削除する方法。 lang: ja canonical_url: https://oomol.com/ja/docs/slack/ markdown_url: https://oomol.com/ja/docs/slack.md --- # Slack App ガイド OOMOL では Slack workspace を一度接続するだけで、承認済みのツール呼び出しを通じて、認可済み Slack ツールを対応 AI エージェントと再利用可能な Skills から利用できます。このガイドでは、Slack App のインストールと接続方法、OOMOL が使用する Slack 権限、利用できる操作、よくある問題の解決方法、App の削除方法を説明します。 OOMOL は、外部アカウントを接続する前にユーザーのサインインを要求します。Slack App をインストールするには、OOMOL にサインインし、Slack 接続ページを開き、**Connect** を選択して Slack OAuth 認可フローを開始します。 [OOMOL で Slack を接続する](https://console.oomol.com/connections/slack) ## 前提条件 - OOMOL アカウント。 - 接続したい workspace 内の Slack アカウント。 - その workspace で Slack Apps をインストールまたは認可する権限。 - [https://console.oomol.com/](https://console.oomol.com/) の OOMOL Console へのアクセス。 - Slack workspace が App インストールを制限している場合、認可する前に Slack workspace の owner または administrator が OOMOL App を承認する必要があります。 ## App を追加する 1. [OOMOL Console](https://console.oomol.com/) にサインインします。 2. [App Connections の Slack](https://console.oomol.com/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](https://console.oomol.com/) にサインインします。 2. [oo-cli インストールページ](https://console.oomol.com/install-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 権限領域 | 使用するツール | OOMOL が使用する理由 | | --- | --- | --- | | Workspace と conversation のメタデータ | List Conversations, List Channels, Get Conversation | 接続済み Slack App がアクセスできる conversations と channels を表示し、ユーザーまたはエージェントが読み取りや投稿の前に適切な destination を選べるようにするため。 | | メッセージ履歴 | Get Channel Messages, Get Thread | ユーザーまたは承認済みエージェントアクションがその context を求めたとき、接続済み Slack App に表示される conversations から messages と thread replies を読み取るため。 | | メッセージ投稿と管理 | Post Message, Post Ephemeral Message, Reply Message, Update Message, Schedule Message, Delete Message | ユーザー、Skill、承認済みエージェントアクションが content と destination を提供したとき、接続済み Slack App による messages の送信、threads への返信、messages の予約、投稿済み messages の管理を行うため。 | | ファイルアクセス | Upload File, List Files, Get File, Delete File | 承認済みツール呼び出しが要求したとき、Slack への files アップロード、App に表示される files の一覧表示、file metadata の読み取り、files の削除を行うため。 | | ユーザー情報とダイレクトメッセージ | List Users, Get User, Open Conversation | App に表示される Slack users を識別し、ユーザー、Skill、エージェントが Slack user を選択したときに direct-message conversations を開始または再開するため。 | | 絵文字リアクション | Add Reaction, Get Reactions, Remove Reaction | ユーザー、Skill、承認済みエージェントアクションがその操作を求めたとき、Slack messages への emoji reactions の追加、読み取り、削除を行うため。 | Slack 管理者が必要な権限を付与しない場合、Slack 接続が失敗するか、その権限に依存するツールが権限付与まで利用できない場合があります。 ### 対応 Slack ツール | ツール | 対応機能 | 主な用途 | 前提条件 | | --- | --- | --- | --- | | List Conversations | 接続済み App に表示される Slack conversations を一覧表示します。 | 別のアクションの前に、エージェントが適切な channel、private channel、group message、direct message を選べるようにします。 | Slack が OOMOL に接続され、接続済み App が conversations にアクセスできること。 | | List Channels | 接続済み App に表示される public Slack channels を一覧表示します。 | report、alert、summary、follow-up message に適した public channel を見つけるため。 | Slack が OOMOL に接続され、public channels が接続済み App に表示されること。 | | Get Conversation | Slack conversation metadata を読み取ります。 | 別のアクションで使用する前に、conversation name、ID、type、membership、その他 metadata を確認します。 | Slack が OOMOL に接続され、conversation が接続済み App に表示されること。 | | Get Channel Messages | Slack conversation から最近の messages を取得します。 | 最近の updates を要約し、support requests を収集し、test または承認済み work channel から follow-up を準備します。 | Slack が OOMOL に接続され、接続済み App が conversation history を読めること。 | | Get Thread | Slack thread の messages を取得します。 | discussion を要約し、reply を準備し、thread から action items を抽出します。 | Slack が OOMOL に接続され、接続済み App が thread を読めること。 | | Post Message | plain text または Block Kit blocks で Slack message を投稿します。 | status update、alert、summary、task result を選択した channel に送ります。 | Slack が OOMOL に接続され、destination が分かっており、ユーザー、Skill、エージェントが message content を提供していること。 | | Post Ephemeral Message | conversation 内の 1 人のユーザーだけに見える message を投稿します。 | 全員に投稿せず、1 人の Slack user に private confirmation または prompt を送ります。 | Slack が OOMOL に接続され、target conversation と user が分かっており、App に投稿権限があること。 | | Reply Message | Slack thread に返信します。 | 既存の discussion 内に task result、answer、summary、follow-up を直接追加します。 | Slack が OOMOL に接続され、parent message が分かっており、App が conversation に投稿できること。 | | Update Message | bot が投稿した Slack message を更新します。 | bot-posted status message を修正、置換、更新します。 | Slack が OOMOL に接続され、target message が接続済み App によって投稿されたこと。 | | Schedule Message | Slack message を後で投稿するよう予約します。 | reminders、handoff notes、updates を将来時刻にキューします。 | Slack が OOMOL に接続され、destination と scheduled time が有効で、App がそこに投稿できること。 | | Delete Message | bot が投稿した Slack message を削除します。 | bot-posted test message、古い alert、誤った update を削除します。 | Slack が OOMOL に接続され、target message を接続済み App が削除できること。 | | Upload File | file URL から Slack に file をアップロードします。 | report、exported result、image、document を選択した conversation で共有します。 | Slack が OOMOL に接続され、destination が分かっており、file URL を connector runtime が取得できること。 | | List Files | 接続済み App に表示される Slack files を一覧表示します。 | 別のアクションで使う前に、channel で共有された files や user の files を見つけます。 | Slack が OOMOL に接続され、App が要求された files を見られること。 | | Get File | Slack file metadata を読み取ります。 | 次に何をするか決める前に、file name、owner、type、available metadata を確認します。 | Slack が OOMOL に接続され、file が接続済み App に表示されること。 | | Delete File | 接続済み App が許可されている場合に Slack file を削除します。 | ユーザーが cleanup を依頼したとき、test file または bot-uploaded file を削除します。 | Slack が OOMOL に接続され、接続済み App に file 削除権限があること。 | | List Users | 接続済み App に表示される Slack users を一覧表示します。 | ephemeral message 送信または direct message 開始の前に user を見つけます。 | Slack が OOMOL に接続され、users が接続済み App に表示されること。 | | Get User | Slack user metadata を読み取ります。 | Skill または agent がその人物を参照する前に、正しい Slack user を確認します。 | Slack が OOMOL に接続され、user が接続済み App に表示されること。 | | Open Conversation | 1 人の Slack user との direct message を開始または再開します。 | ユーザーが Slack user を選択した後、direct-message task を準備します。 | Slack が OOMOL に接続され、App が direct message を開始またはアクセスできること。 | | Add Reaction | Slack message に emoji reaction を追加します。 | message を acknowledged、queued、completed、follow-up needed として示します。 | Slack が OOMOL に接続され、message が接続済み App に表示されること。 | | Get Reactions | Slack message の reactions を取得します。 | message が reaction によって acknowledge または triage されたか確認します。 | Slack が OOMOL に接続され、message が接続済み App に表示されること。 | | Remove Reaction | Slack message から emoji reaction を削除します。 | もう正確でない reaction を消します。 | Slack が OOMOL に接続され、接続済み App が reaction を削除できること。 | ### 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](https://console.oomol.com/) にサインインします。 2. [Connections](https://console.oomol.com/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 認可トークンを削除または無効化します。 - 一部のログ、サポート記録、セキュリティ記録、請求関連記録は、[プライバシーポリシー](/ja/privacy/) に記載のとおり保持される場合があります。 ## 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](mailto:support@oomol.com) - サポートページ: [https://oomol.com/ja/support/](https://oomol.com/ja/support/) OOMOL アカウントのメール、関連する場合は Slack workspace name または ID、実行しようとしたアクション、エラーメッセージまたはスクリーンショットを含めてください。