전제 조건
- 다음이 준비되어 있습니다:
- 프로젝트의
project id - Slack에서 EKB 앱을 설정할 API Key + Secret
- 프로젝트의
Slack에서 EKB 앱 설치 및 설정
- Slack API Apps로 이동합니다. Slack 워크스페이스에 로그인해야 할 수 있습니다.
- 앱 만들기를 클릭합니다.
- 처음부터를 선택합니다.
- 앱 이름을 입력합니다(예: “EKB Chatbot”).
- 앱을 설치할 개발 Slack 워크스페이스를 선택합니다.
- 앱 만들기를 클릭합니다.
-
기본 정보 섹션에서 다음 값을 기록해 두세요:
App ID,Client ID,Client Secret,Signing Secret,Verification Token. 11단계에서 이 값을 사용하여 앱을 구성해야 합니다. -
왼쪽 사이드바에서 OAuth 및 권한을 클릭합니다:
a. 리다이렉트 URL 추가를 클릭하고 다음 URL을 입력합니다:
b. 추가를 클릭한 다음 URL 저장을 클릭합니다. c. 범위 아래에서 다음 봇 토큰 범위를 추가합니다:
app_mentions:read– 봇이 앱이 있는 대화에서 멘션된 메시지를 읽을 수 있도록 허용합니다.channels:history– 봇이 앱이 속한 공개 채널의 메시지 및 기타 콘텐츠를 볼 수 있도록 허용합니다.channels:manage– 봇이 채널을 만들고, 보관하고, 이름을 변경하는 등 채널을 관리할 수 있도록 허용합니다.channels:read– 봇이 워크스페이스의 공개 채널에 대한 기본 정보를 볼 수 있도록 허용합니다.chat:write– 봇이 앱으로 메시지를 보낼 수 있도록 허용합니다.commands– 봇이 사용자가 호출할 수 있는 슬래시 명령어를 추가할 수 있도록 허용합니다.groups:read– 봇이 앱이 속한 비공개 채널에 대한 기본 정보를 볼 수 있도록 허용합니다.im:history– 봇이 앱이 속한 다이렉트 메시지의 메시지 및 기타 콘텐츠를 볼 수 있도록 허용합니다.im:write– 봇이 앱으로 다이렉트 메시지를 보낼 수 있도록 허용합니다.users.profile:read– 봇이 사용자 프로필을 볼 수 있도록 허용합니다.users:read– 봇이 워크스페이스의 사용자를 볼 수 있도록 허용합니다.users:read.email– 봇이 사용자 이메일을 볼 수 있도록 허용합니다.
- 왼쪽 사이드바에서 앱 홈을 클릭합니다. 탭 표시 아래에서 메시지 탭과 그 아래의 확인란이 활성화되어 있는지 확인합니다.
-
왼쪽 사이드바에서 슬래시 명령어를 클릭합니다:
a. 새 명령어 만들기를 클릭합니다. b. 명령어 필드에
/setup을 입력합니다. c. 요청 URL 필드에 다음을 입력합니다:d. 짧은 설명 필드에 “채널 설정”과 같은 내용을 입력합니다. e. 선택적으로 사용법 힌트 필드에 더 긴 설명을 추가할 수 있습니다. f. 저장을 클릭합니다. -
7단계에서 수집한 값으로 다음 API 엔드포인트 URL을 완성합니다:
{client_id},{client_secret},{signing_secret},{verification_token}을 기본 정보 섹션에 있는 Slack 앱의 값으로 교체합니다. - 완성된 URL을 새 브라우저에서 엽니다. Slack에 추가 버튼이 있는 페이지로 리다이렉션됩니다. 이 버튼을 클릭하여 워크스페이스에 앱을 설치합니다.
- 워크스페이스에 접근할 수 있는 권한을 요청하는 페이지로 리다이렉션됩니다. 필요한 권한을 부여하기 위해 허용을 클릭합니다.
- 설치가 성공되었음을 나타내는 확인 메시지가 표시되고 Slack 워크스페이스로 리다이렉션됩니다.
-
사이드바에서 이벤트 권한으로 이동하여 다음을 수행합니다:
a. 이벤트 활성화 토글. b. 요청 URL 필드에 다음을 입력합니다:
d. 그런 다음 아래의 봇 이벤트 구독으로 이동합니다. e. 봇 사용자 이벤트 추가를 클릭하고
app_mention과message.im의 두 이벤트를 추가합니다. f. 변경 사항 저장을 클릭합니다. -
사이드바에서 상호작용 및 단축키로 이동하여 다음을 수행합니다:
a. 상호작용 토글. b. 요청 URL 필드에 다음을 입력합니다:
c. 변경 사항 저장을 클릭합니다.
- Slack 워크스페이스로 이동하면 왼쪽 사이드바의 앱 목록에 EKB 앱이 표시됩니다.
앱이 Slack 워크스페이스에 성공적으로 설치되었습니다! 다음 단계는 설정 명령어를 실행하여 EKB용 채널을 구성하는 것입니다.
EKB 앱용 채널 설정
EKB용 채널을 설정하려면 원하는 채널에서/setup 명령어를 실행해야 합니다. 이 명령어는 채널이 EKB와 작동하도록 구성합니다.
- Slack 워크스페이스를 열고 EKB를 설정할 채널로 이동합니다.
- 메시지 입력 상자에
/setup을 입력하고 Enter를 누릅니다. - 다음 정보를 입력하라는 팝업이 나타납니다:
- 채널 – EKB를 설정할 채널을 선택합니다.
다이렉트 메시지에서 앱을 사용하려면 자신의 사용자 이름을 선택하세요.
- 프로젝트 ID: EKB 프로젝트 ID를 입력합니다.
- API Key: EKB API Key를 입력합니다.
- API Secret: EKB API Secret을 입력합니다.
- 채널 – EKB를 설정할 채널을 선택합니다.
- 제출을 클릭하여 설정 프로세스를 완료합니다. 앱은 정보를 확인하고 채널을 구성합니다.
- 설정이 성공되면 채널에 EKB가 성공적으로 설정되었음을 나타내는 확인 메시지가 표시됩니다.
EKB가 선택한 채널에 설정되었습니다! 메시지에서 봇을 멘션하거나 슬래시 명령어를 사용하여 봇과 상호작용을 시작할 수 있습니다.