시작하기 전 준비 사항 Slack 구성 Amazon Quick에서 커넥터 설정 사용 가능한 작업 관리 및 문제 해결

Slack 통합

Slack 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 Slack 플랫폼에 액세스할 수 있습니다. Amazon Quick을 벗어나지 않고도 메시지를 보내고, 채널을 관리하고, 콘텐츠를 검색하고, 사용자 및 사용자 그룹과 상호 작용할 수 있습니다.

Amazon Quick은 Slack에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.

기본 OAuth 앱 AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. Slack 워크스페이스로 직접 인증합니다.
사용자 지정 OAuth 앱 - 고객 관리형 Slack 앱을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.
베어러 토큰 - 인증에 Slack 봇 토큰을 사용합니다. 이 방법은 워크스페이스에 대한 봇 수준 액세스에 적합합니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

사용하려는 채널 및 데이터에 액세스할 수 있는 Slack 워크스페이스입니다.
사용자 지정 OAuth 앱의 경우: Slack 웹 사이트의 Slack API 대시보드에 액세스하여 앱을 생성합니다.
베어러 토큰의 경우: Slack 앱의 봇 토큰(로 시작xoxb-)입니다. 자세한 내용은 Slack 웹 사이트의 Quickstart 앱 설정을 참조하세요.
Amazon Quick 구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.

Slack 구성

기본 OAuth 앱 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다Amazon Quick에서 커넥터 설정.

사용자 지정 OAuth 앱 또는 베어러 토큰 인증의 경우 Amazon Quick을 구성하기 전에 Slack의 해당 단계를 완료합니다.

사용자 지정 OAuth 앱 또는 베어러 토큰용 Slack 앱 생성

Slack 앱을 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명 또는 봇 토큰을 가져옵니다.

Slack 웹 사이트의 Slack API 대시보드로 이동하여 새 앱 생성을 선택합니다.
처음부터를 선택합니다.
앱 이름을 입력하고 Slack 워크스페이스를 선택합니다. 앱 생성을 선택합니다.
왼쪽 사이드바에서 OAuth & Permissions를 선택합니다.
리디렉션 URLs에서 새 리디렉션 URL 추가를 선택하고 Amazon Quick 콜백 URL을 입력합니다. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

추가를 선택한 다음 URLs 선택합니다.
범위에 통합에 필요한 봇 토큰 범위를 추가합니다. 권장 범위는 섹션을 참조하세요권장 범위.
왼쪽 사이드바에서 기본 정보를 선택합니다. 앱 자격 증명에서 다음 값을 기록합니다.
- 클라이언트 ID
- 클라이언트 보안 암호(client secret)
베어러 토큰의 경우: OAuth & Permissions 페이지에서 워크스페이스에 앱을 설치합니다. 설치 후 봇 사용자 OAuth 토큰을 복사합니다(로 시작xoxb-).

권장 범위

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 범위 참조에서 범위 가용성을 확인합니다.

Amazon Quick에서 커넥터 설정

사용 가능 탭에서 연결

기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 사용 가능 탭에서 직접 연결할 수 있습니다.

Amazon Quick 콘솔에서 커넥터를 선택합니다.
사용 가능 탭에서 Slack을 찾아 연결을 선택합니다.
Slack 로그인 흐름을 완료하고 요청된 권한을 부여합니다.

대신 사용자 지정 OAuth 앱 또는 베어러 토큰으로 커넥터를 구성하려면 아래 설명과 같이 팀에 대해 생성 탭을 사용합니다.

팀에 대해 생성 탭에서 생성

필요한 Slack 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.

Amazon Quick 콘솔에서 커넥터를 선택합니다.
팀에 대해 생성 탭을 선택합니다.
Slack을 찾아 선택합니다.

참고
Slack 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 아니요, 새로 생성을 선택합니다.
커넥터의 이름을 입력합니다. 선택적으로 + 설명 추가를 선택하여 설명을 추가합니다.
연결 유형에서 퍼블릭 네트워크를 선택합니다.
OAuth 구성에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.
1. 기본 OAuth 앱의 경우:
  
  추가 자격 증명은 필요하지 않습니다. 다음을 선택하여 계속 진행합니다.
2. 사용자 지정 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로 미리 채워집니다.
3. 베어러 토큰에서 다음 필드를 구성합니다.
  - 기본 URL(선택 사항) - Slack API 기본 URL입니다. 예시: https://slack.com/api
  - 봇 토큰 - Slack 봇 토큰(로 시작xoxb-).
다음을 선택합니다.
기본 OAuth 앱 또는 사용자 지정 OAuth 앱을 선택한 경우 Slack 권한 부여 창이 열립니다. 요청된 권한을 검토하고 워크스페이스를 선택한 다음 허용을 선택합니다.
검토 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. 다음을 선택합니다.
게시 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사람에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.
게시를 선택합니다.

사용 가능한 작업

커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.

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

참고

사용할 수 있는 작업은 Slack 앱에 대해 구성된 범위와 인증된 사용자가 액세스할 수 있는 채널에 따라 다릅니다.

관리 및 문제 해결

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

인증 문제

로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱) - Slack 워크스페이스가 활성 상태이고 Slack 웹 사이트에 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Slack 앱의 리디렉션 URL이 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱) - 클라이언트 ID와 클라이언트 보안 암호가 Slack 앱의 기본 정보 섹션의 값과 일치하는지 확인합니다.
베어러 토큰 거부됨 - 봇 토큰이 활성 상태이고 로 시작하는지 확인합니다xoxb-. 토큰은 Slack API 대시보드에서 취소할 수 있습니다.
권한 부족 - Slack 앱에 대해 구성된 범위에 사용하려는 작업에 필요한 권한이 포함되어 있는지 확인합니다. 권장 범위을(를) 참조하세요.
채널에서 채널을 찾을 수 없거나 찾을 수 없음 - 봇이 채널에 추가되었는지 확인합니다. 메시지 또는 읽기 기록을 게시하기 전에 봇을 채널에 초대합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

ServiceNow 통합

Smartsheet 통합