翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Slack 統合
<a name="slack-integration"></a>

Slack アクションコネクタを使用すると、自然言語を通じて Amazon Quick で Slack プラットフォームに直接アクセスできます。Amazon Quick を離れることなく、メッセージを送信したり、チャネルを管理したり、コンテンツを検索したり、ユーザーやユーザーグループとやり取りしたりできます。

Amazon Quick は、Slack の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。
+ **デフォルトの OAuth アプリケーション** – AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。Slack ワークスペースで直接認証します。
+ **カスタム OAuth アプリ** – カスタマー管理の Slack アプリを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。
+ **ベアラートークン** – 認証に Slack ボットトークンを使用します。この方法は、ワークスペースへのボットレベルのアクセスに適しています。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="slack-integration-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ 使用するチャネルとデータにアクセスできる Slack ワークスペース。
+ **カスタム OAuth アプリ**の場合: [Slack ウェブサイトの Slack API ダッシュボード](https://api.slack.com/apps)にアクセスしてアプリを作成します。
+ **ベアラートークン**の場合: Slack アプリからのボットトークン ( で始まる`xoxb-`)。詳細については、Slack ウェブサイトの[「クイックスタートアプリの設定](https://docs.slack.dev/app-management/quickstart-app-settings)」を参照してください。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Slack の設定
<a name="slack-source-setup"></a>

**デフォルトの OAuth アプリ**認証を使用している場合は、このセクションをスキップして に進みます[Amazon Quick でのコネクタのセットアップ](#slack-quicksuite-setup)。

カスタム OAuth アプリまたはベアラートークン認証の場合は、Amazon Quick を設定する前に Slack で該当するステップを完了してください。

### カスタム OAuth アプリまたはベアラートークン用の Slack アプリを作成する
<a name="slack-register-oauth"></a>

Slack アプリを作成して、Amazon Quick に必要なクライアント認証情報またはボットトークンを取得します。

1. [Slack ウェブサイトの Slack API ダッシュボード](https://api.slack.com/apps)に移動し、**新しいアプリの作成**を選択します。

1. **最初から** を選択します。

1. **アプリケーション名**を入力し、Slack ワークスペースを選択します。[**Create App (アプリの作成)**] を選択します。

1. 左側のサイドバーで、**OAuth & Permissions **を選択します。

1. **リダイレクト URLs **で、**新しいリダイレクト URL を追加** を選択し、Amazon Quick コールバック URL を入力します。 `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   **追加** を選択し、**URLs の保存 **を選択します。

1. **スコープ** で、統合に必要な Bot Token スコープを追加します。推奨されるスコープについては、「」を参照してください[推奨されるスコープ](#slack-oauth-scopes)。

1. 左側のサイドバーで、**基本情報**を選択します。**アプリ認証情報**で、次の値を記録します。
   + **クライアント ID**
   + **クライアントシークレット**

1. **ベアラートークン**の場合: **OAuth & Permissions **ページからワークスペースにアプリをインストールします。インストール後、**Bot User OAuth トークン**をコピーします ( で始まります`xoxb-`)。

### 推奨されるスコープ
<a name="slack-oauth-scopes"></a>

Slack に接続すると、次のスコープがリクエストされます。カスタム Slack アプリを作成するときは、**OAuth & Permissions **ページでこれらのスコープを追加します。カスタム OAuth アプリの場合は、**ユーザートークンスコープとして追加します**。ベアラートークンの場合は、それらを**ボットトークンスコープとして追加します**。


**Slack 推奨スコープ**  

| スコープ | 説明 | 
| --- | --- | 
| calls:read | 通話情報を読み取ります。 | 
| calls:write | 呼び出しを作成および管理します。 | 
| channels:history | パブリックチャネルでメッセージ履歴を読み取ります。 | 
| channels:read | パブリックチャネルに関する情報を読み取ります。 | 
| channels:write | パブリックチャネルを管理します。 | 
| chat:write | チャネルと会話にメッセージを送信します。 | 
| dnd:read | Do Not Disturb 設定を読み取ります。 | 
| dnd:write | 「Do Not Disturb 設定」を更新します。 | 
| emoji:read | カスタム絵文字を読み取ります。 | 
| files:read | チャネルで共有されているファイルを読み取ります。 | 
| files:write | ファイルをアップロードして管理します。 | 
| groups:history | プライベートチャネルでメッセージ履歴を読み取ります。 | 
| groups:read | プライベートチャネルに関する情報を読み取ります。 | 
| groups:write | プライベートチャネルを管理します。 | 
| im:history | ダイレクトメッセージのメッセージ履歴を読み取ります。 | 
| im:read | ダイレクトメッセージに関する情報を読み取ります。 | 
| im:write | ダイレクトメッセージを開始します。 | 
| links:read | リンクプレビューを読み取ります。 | 
| links:write | リンクプレビューを管理します。 | 
| mpim:history | グループダイレクトメッセージのメッセージ履歴を読み取ります。 | 
| mpim:read | グループダイレクトメッセージに関する情報を読み取ります。 | 
| mpim:write | グループのダイレクトメッセージを開始します。 | 
| pins:read | ピン留めされたメッセージを読み取ります。 | 
| pins:write | メッセージを固定および固定解除します。 | 
| reactions:read | メッセージに対する絵文字リアクションを読み取ります。 | 
| reactions:write | 絵文字リアクションを追加および削除します。 | 
| reminders:read | リマインダーを読み取ります。 | 
| reminders:write | リマインダーを作成します。 | 
| remote\_files:read | リモートファイルを読み取ります。 | 
| remote\_files:share | リモートファイルを共有します。 | 
| search:read | メッセージとファイルを検索します。 | 
| stars:read | スター付き項目を読み取ります。 | 
| stars:write | アイテムのスターとスター解除。 | 
| team:read | ワークスペース情報を読み取ります。 | 
| usergroups:read | ユーザーグループ情報を読み取ります。 | 
| usergroups:write | ユーザーグループを管理します。 | 
| users:read | ユーザー情報を読み取ります。 | 
| users:read.email | ユーザーの E メールアドレスを読み取ります。 | 
| users:write | ユーザー情報を更新します。 | 
| users.profile:read | ユーザープロファイル情報を読み取ります。 | 
| users.profile:write | ユーザープロファイル情報を更新します。 | 

**注記**  
すべてのスコープがユーザートークンスコープとボットトークンスコープの両方で利用できるわけではありません。`search:read` や などの一部のスコープは`stars:read`、ユーザートークンスコープとしてのみ使用できます。ベアラートークン認証のスコープを設定するときは、[Slack ウェブサイトの Slack API スコープリファレンス](https://api.slack.com/scopes)でスコープの可用性を確認してください。

## Amazon Quick でのコネクタのセットアップ
<a name="slack-quicksuite-setup"></a>

### 使用可能なタブから接続する
<a name="slack-quick-connect"></a>

デフォルトの OAuth アプリ認証を使用する場合は、追加設定なしで **Available** タブから直接接続できます。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **使用可能**タブで、**Slack** を見つけて**接続**を選択します。

1. Slack サインインフローを完了し、リクエストされたアクセス許可を付与します。

代わりにカスタム OAuth アプリまたはベアラートークンを使用してコネクタを設定するには、以下で説明するように**チーム用に作成**タブを使用します。

### チームの作成タブから を作成する
<a name="slack-full-setup"></a>

必要な Slack 設定が完了したら、Amazon Quick でコネクタを作成します。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **Slack** を見つけて選択します。
**注記**  
Slack コネクタが既に存在する場合、既存のコネクタにダイアログが表示されます。既存のコネクタを使用するには、コネクタを選択します。新しいものを作成するには、**「いいえ」を選択し、新しいものを作成します**。

1. コネクタ**の名前**を入力します。必要に応じて、 **\+ 説明を追加** を選択して説明を追加します。

1. Connection **type** で、**Public network** を選択します。

1. **OAuth 設定では**、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. **デフォルトの OAuth アプリ**の場合:

      追加の認証情報は必要ありません。**[次へ]** を選択して続行します。

   1. **カスタム OAuth アプリ**の場合は、次のフィールドを設定します。
      + **ベース URL** (オプション) – Slack API ベース URL。例: `https://slack.com/api`
      + **クライアント ID** – Slack アプリのクライアント ID。
      + **クライアントシーク**レット – Slack アプリからのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。例: `https://slack.com/api/oauth.v2.access`
      + **認可 URL** – 認可エンドポイント。例: `https://slack.com/oauth/v2/authorize`
      + **リダイレクト URL** – Amazon Quick コールバック URL があらかじめ入力されています。

   1. **ベアラートークン**では、次のフィールドを設定します。
      + **ベース URL** (オプション) – Slack API ベース URL。例: `https://slack.com/api`
      + **ボットトークン** – Slack ボットトークン ( で始まります`xoxb-`)。

1. [**次へ**] を選択します。

1. **デフォルトの OAuth アプリ**または**カスタム OAuth アプリ**を選択した場合、Slack 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、ワークスペースを選択し、**許可**を選択します。

1. **レビュー**ページで、コネクタで使用可能なアクションを確認します。[**次へ**] を選択します。

1. **公開**ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

1. **[公開]** を選択します。

## 使用可能なアクション
<a name="slack-integration-actions"></a>

コネクタを設定すると、次のアクションを使用できます。


**使用可能な Slack アクション**  

| Category | [アクション] | 説明 | 
| --- | --- | --- | 
|  メッセージ | チャットポストメッセージ | チャネル、ダイレクトメッセージ、またはプライベートグループにメッセージを投稿します。 | 
|  メッセージ | メッセージの送信 | サードパーティーのアクションメッセージをチャネルに送信します。 | 
|  メッセージ | メッセージパーマリンクの取得 | 特定のメッセージのパーマリンク URL を取得します。 | 
| チャンネル | 会話の作成 | パブリックチャネルまたはプライベートチャネルを作成します。 | 
| チャンネル | 会話履歴 | チャネルからメッセージ履歴を取得します。スレッドレスポンスではなく、メインタイムラインメッセージのみを返します。 | 
| チャンネル | 会話の返信 | 特定の親メッセージへのスレッド返信を取得します。 | 
| チャンネル | 会話の招待 | 既存のチャネルにユーザーを招待します。 | 
| チャンネル | 会話の参加 | 既存のチャネルを結合します。 | 
| チャンネル | 会話のキック | チャネルからユーザーを削除します。 | 
| チャンネル | 会話の退出 | チャネルを離れます。 | 
| チャンネル | 会話メンバー | チャネルのメンバー IDs を一覧表示します。 | 
| チャンネル | 会話を開く | ダイレクトメッセージまたは複数人のダイレクトメッセージを開くか再開します。 | 
| チャンネル | 会話セットトピック | チャネルのトピックを設定または更新します。 | 
| チャンネル | 会話の取得 | ID でチャネルのメタデータを取得します。 | 
| チャンネル | チャネルを一覧表示する | ユーザーが利用できるチャネルを一覧表示します。 | 
| チャンネル | ユーザーの会話を一覧表示する | ユーザーがアクセスできるチャネルとダイレクトメッセージを一覧表示します。 | 
| リアクション | リアクションの作成 | メッセージに絵文字リアクションを追加します。 | 
| リアクション | リアクションの削除 | メッセージから絵文字リアクションを削除します。 | 
| リアクション | リアクションを一覧表示する | メッセージ、ファイル、またはファイルコメントに対するリアクションを一覧表示します。 | 
| ファイル | ファイルのアップロードまたは作成 | ファイルまたはメディアをチャネルまたはスレッドにアップロードします。 | 
| ファイル | 外部 URL にアップロードする | Slack で共有するための外部ファイルへの参照を追加します。 | 
| ファイル | ファイルのダウンロード | Slack で共有されているファイルをダウンロードします。 | 
| ファイル | ファイル情報 | ファイルのメタデータとコメントを取得します。 | 
| ファイル | ファイルリスト | ワークスペース内のファイルをオプションのフィルターで一覧表示します。 | 
| 検索 | すべて検索 | ワークスペース全体でメッセージとファイルを検索します。 | 
| 検索 | メッセージの検索 | 日付範囲とフィルターを使用してメッセージを検索します。 | 
| 検索 | チャネルの検索 | チャネルを名前、トピック、または目的で検索します。 | 
| 検索 | ユーザーの検索 | E メール、名前、または表示名でユーザーを検索します。 | 
| 検索 | 検索コンテキスト | メッセージ、ファイル、チャネル、ユーザーを検索します。Slack AI を使用してワークスペースのセマンティック検索をサポートします。 | 
| 検索 | 検索設定の取得 | セマンティック検索がワークスペースで使用できるかどうかを確認します。 | 
| [ユーザー] | ユーザー詳細の取得 | ID でユーザーの情報を取得します。 | 
| [ユーザー] | ユーザープロファイルの取得 | ユーザーのプロファイル情報を取得します。 | 
| [ユーザー] | ユーザープロファイルセット | ユーザーのプロファイルフィールドを更新します。 | 
| [ユーザー] | ユーザーリスト | ワークスペース内のすべてのユーザーを一覧表示します。 | 
| ユーザーグループ | ユーザーグループの作成 | 新しいユーザーグループを作成します。 | 
| ユーザーグループ | ユーザーグループリスト | ワークスペース内のユーザーグループを一覧表示します。 | 
| ユーザーグループ | ユーザーグループ ユーザーの更新 | ユーザーグループのすべてのメンバーを置き換えます。 | 
| リマインダー | リマインダーの追加 | 指定したテキストと時刻でリマインダーを作成します。 | 
| ワークスペース | チームの取得 | Slack ワークスペースに関するメタデータを取得します。 | 

**注記**  
使用できるアクションは、Slack アプリ用に設定されたスコープと、認証されたユーザーがアクセスできるチャネルによって異なります。

## の管理とトラブルシューティング
<a name="slack-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="slack-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** – Slack ワークスペースがアクティブであり、[Slack ウェブサイト](https://slack.com)に直接サインインできることを確認します。カスタム OAuth アプリの場合は、Slack アプリのリダイレクト URL が Amazon Quick コールバック URL と一致することを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリ)** – クライアント ID とクライアントシークレットが Slack アプリの基本情報セクションの値と一致していることを確認します。
+ **ベアラートークンが拒否**されました – ボットトークンがアクティブで、 で始まることを確認します`xoxb-`。トークンは Slack API ダッシュボードから取り消すことができます。
+ **アクセス許可が不十分** – Slack アプリ用に設定されたスコープに、使用するアクションに必要なアクセス許可が含まれていることを確認します。「[推奨されるスコープ](#slack-oauth-scopes)」を参照してください。
+ **チャネルが見つからないか、チャネルにないか** — ボットがチャネルに追加されていることを確認します。メッセージの投稿や履歴の読み取りを試みる前に、ボットをチャネルに招待します。