기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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 웹 사이트의 [Quickstart 앱 설정을](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 워크스페이스를 선택합니다. **앱 생성**을 선택합니다.

1. 왼쪽 사이드바에서 **OAuth & Permissions를** 선택합니다.

1. **리디렉션 URLs**에서 **새 리디렉션 URL 추가**를 선택하고 Amazon Quick 콜백 URL을 입력합니다. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` 

   **추가**를 선택한 다음 ** URLs** 선택합니다.

1. **범위에** 통합에 필요한 봇 토큰 범위를 추가합니다. 권장 범위는 섹션을 참조하세요[권장 범위](#slack-oauth-scopes).

1. 왼쪽 사이드바에서 **기본 정보를** 선택합니다. **앱 자격 증명**에서 다음 값을 기록합니다.
   + **클라이언트 ID**
   + **클라이언트 보안 암호(client secret)**

1. **베어러 토큰**의 경우: **OAuth & Permissions** 페이지에서 워크스페이스에 앱을 설치합니다. 설치 후 **봇 사용자 OAuth 토큰**을 복사합니다(로 시작`xoxb-`).

### 권장 범위
<a name="slack-oauth-scopes"></a>

Slack에 연결할 때 다음 범위가 요청됩니다. 사용자 지정 Slack 앱을 생성할 때 **OAuth 및 권한** 페이지에서 이러한 범위를 추가합니다. 사용자 지정 OAuth 앱**의 경우 사용자 토큰 범위**로 추가합니다. 베어러 토큰의 경우 이를 **봇 토큰 범위**로 추가합니다.


**Slack 권장 범위**  

| Scope | 설명 | 
| --- | --- | 
| calls:read | 통화 정보를 읽습니다. | 
| calls:write | 호출을 생성하고 관리합니다. | 
| channels:history | 퍼블릭 채널에서 메시지 기록을 읽습니다. | 
| channels:read | 퍼블릭 채널에 대한 정보를 읽습니다. | 
| channels:write | 퍼블릭 채널을 관리합니다. | 
| chat:write | 채널 및 대화에 메시지를 전송합니다. | 
| dnd:read | 방해 금지 설정을 읽습니다. | 
| dnd:write | 업데이트 방해 금지 설정. | 
| 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 | 사용자 이메일 주소를 읽습니다. | 
| 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 앱 인증을 사용하려면 추가 구성 없이 **사용 가능** 탭에서 직접 연결할 수 있습니다.

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. **연결 유형**에서 **퍼블릭 네트워크를** 선택합니다.

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 사용 가능한 작업**  

| 카테고리 | 작업 | 설명 | 
| --- | --- | --- | 
| 메시지 | 채팅 게시물 메시지 | 채널, 다이렉트 메시지 또는 프라이빗 그룹에 메시지를 게시합니다. | 
| 메시지 | 전송 메시지 | 채널에 3인칭 작업 메시지를 보냅니다. | 
| 메시지 | 메시지 Permalink 가져오기 | 특정 메시지에 대한 퍼마링크 URL을 검색합니다. | 
| 채널 | 대화 생성 | 퍼블릭 또는 프라이빗 채널을 생성합니다. | 
| 채널 | 대화 기록 | 채널에서 메시지 기록을 검색합니다. 기본 타임라인 메시지만 반환하고 스레드 회신은 반환하지 않습니다. | 
| 채널 | 대화 회신 | 특정 상위 메시지에 대한 스레드 응답을 검색합니다. | 
| 채널 | 대화 초대 | 사용자를 기존 채널로 초대합니다. | 
| 채널 | 대화 조인 | 기존 채널을 조인합니다. | 
| 채널 | 대화 시작 | 채널에서 사용자를 제거합니다. | 
| 채널 | 대화 종료 | 채널을 떠납니다. | 
| 채널 | 대화 멤버 | 채널의 멤버 IDs를 나열합니다. | 
| 채널 | 대화 열기 | 다이렉트 메시지 또는 다중 인물 다이렉트 메시지를 열거나 재개합니다. | 
| 채널 | 대화 주제 설정 | 채널에 대한 주제를 설정하거나 업데이트합니다. | 
| 채널 | 대화 가져오기 | ID별로 채널의 메타데이터를 검색합니다. | 
| 채널 | 채널 나열 | 사용자가 사용할 수 있는 채널을 나열합니다. | 
| 채널 | 사용자에 대한 대화 나열 | 사용자가 액세스할 수 있는 채널과 다이렉트 메시지를 나열합니다. | 
| 반응 | 반응 생성 | 메시지에 이모티콘 반응을 추가합니다. | 
| 반응 | 반응 삭제 | 메시지에서 이모티콘 반응을 제거합니다. | 
| 반응 | 반응 나열 | 메시지, 파일 또는 파일 주석에 대한 반응을 나열합니다. | 
| 파일 | 파일 업로드 또는 생성 | 채널 또는 스레드에 파일 또는 미디어를 업로드합니다. | 
| 파일 | 외부 URL에 업로드 | Slack에서 공유할 외부 파일에 대한 참조를 추가합니다. | 
| 파일 | 파일 다운로드 | Slack에서 공유된 파일을 다운로드합니다. | 
| 파일 | 파일 정보 | 파일에 대한 메타데이터와 설명을 검색합니다. | 
| 파일 | 파일 목록 | 선택적 필터가 있는 워크스페이스의 파일을 나열합니다. | 
| 검색 | 모두 검색 | 워크스페이스에서 메시지와 파일을 검색합니다. | 
| 검색 | 메시지 검색 | 날짜 범위 및 필터가 있는 메시지를 검색합니다. | 
| 검색 | 검색 채널 | 이름, 주제 또는 용도별로 채널을 검색합니다. | 
| 검색 | 사용자 검색 | 이메일, 이름 또는 표시 이름으로 사용자를 검색합니다. | 
| 검색 | 검색 컨텍스트 | 메시지, 파일, 채널 및 사용자 간에 검색합니다. Slack AI를 사용하여 워크스페이스에서 의미 체계 검색을 지원합니다. | 
| 검색 | 검색 구성 가져오기 | 워크스페이스에서 의미 체계 검색을 사용할 수 있는지 확인합니다. | 
| Users | 사용자 세부 정보 가져오기 | ID로 사용자에 대한 정보를 검색합니다. | 
| Users | 사용자 프로필 가져오기 | 사용자의 프로필 정보를 검색합니다. | 
| Users | 사용자 프로필 세트 | 사용자의 프로필 필드를 업데이트합니다. | 
| Users | 사용자 목록 | 워크스페이스의 모든 사용자를 나열합니다. | 
| 사용자 그룹 | 사용자 그룹 생성 | 새 사용자 그룹을 생성합니다. | 
| 사용자 그룹 | 사용자 그룹 목록 | 워크스페이스의 사용자 그룹을 나열합니다. | 
| 사용자 그룹 | 사용자 그룹 사용자 업데이트 | 사용자 그룹의 모든 멤버를 대체합니다. | 
| 미리 알림 | 알림 추가 | 지정된 텍스트와 시간으로 미리 알림을 생성합니다. | 
| 워크스페이스 | 팀 가져오기 | 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)을(를) 참조하세요.
+ **채널에서 채널을 찾을 수 없거나** 찾을 수 없음 - 봇이 채널에 추가되었는지 확인합니다. 메시지 또는 읽기 기록을 게시하기 전에 봇을 채널에 초대합니다.