> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EKB 챗봇을 Slack에 통합

> EKB를 Slack으로 가져오세요

EKB를 Slack과 통합하면 지능적이고 컨텍스트를 인식하는 채팅이 워크스페이스에 직접 제공되어 팀이 Slack을 떠나지 않고 AI 에이전트와 상호작용할 수 있습니다. 이 가이드는 Slack에서 EKB 앱을 설치하고, 권한을 구성하며, AI 에이전트와 원활한 통신을 위해 채널을 설정하는 과정을 안내합니다.

<Warning>
  각 EKB 프로젝트는 하나의 Slack 앱에만 연결할 수 있습니다. 연결하려는 각 추가 EKB 프로젝트에 대해 새 Slack 앱을 만들어야 합니다.
</Warning>

## 전제 조건

* 다음이 준비되어 있습니다:
  * 프로젝트의 `project id`
  * Slack에서 EKB 앱을 설정할 **API Key + Secret**

## Slack에서 EKB 앱 설치 및 설정

1. [Slack API Apps](https://api.slack.com/apps)로 이동합니다. Slack 워크스페이스에 로그인해야 할 수 있습니다.
2. **앱 만들기**를 클릭합니다.
3. **처음부터**를 선택합니다.
4. **앱 이름**을 입력합니다(예: "EKB Chatbot").
5. 앱을 설치할 **개발 Slack 워크스페이스**를 선택합니다.
6. **앱 만들기**를 클릭합니다.
7. **기본 정보** 섹션에서 다음 값을 기록해 두세요: `App ID`, `Client ID`, `Client Secret`, `Signing Secret`, `Verification Token`. 11단계에서 이 값을 사용하여 앱을 구성해야 합니다.
8. 왼쪽 사이드바에서 **OAuth 및 권한**을 클릭합니다:
   a. **리다이렉트 URL 추가**를 클릭하고 다음 URL을 입력합니다:

   ```text theme={null}
   https://ai-api.automationanywhere.com/slack/oauth
   ```

   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` – 봇이 사용자 이메일을 볼 수 있도록 허용합니다.
9. 왼쪽 사이드바에서 **앱 홈**을 클릭합니다. **탭 표시** 아래에서 **메시지 탭**과 그 아래의 확인란이 활성화되어 있는지 확인합니다.
10. 왼쪽 사이드바에서 **슬래시 명령어**를 클릭합니다:
    a. **새 명령어 만들기**를 클릭합니다. b. **명령어** 필드에 `/setup`을 입력합니다. c. **요청 URL** 필드에 다음을 입력합니다:

    ```
    https://ai-api.automationanywhere.com/slack/events
    ```

    d. **짧은 설명** 필드에 "채널 설정"과 같은 내용을 입력합니다. e. 선택적으로 **사용법 힌트** 필드에 더 긴 설명을 추가할 수 있습니다. f. **저장**을 클릭합니다.
11. 7단계에서 수집한 값으로 다음 API 엔드포인트 URL을 완성합니다:

    ```
    https://ai-api.automationanywhere.com/slack/custom_install/{client_id}/{client_secret}/{signing_secret}/{verification_token}
    ```

    `{client_id}`, `{client_secret}`, `{signing_secret}`, `{verification_token}`을 **기본 정보** 섹션에 있는 Slack 앱의 값으로 교체합니다.
12. 완성된 URL을 새 브라우저에서 엽니다. **Slack에 추가** 버튼이 있는 페이지로 리다이렉션됩니다. 이 버튼을 클릭하여 워크스페이스에 앱을 설치합니다.
13. 워크스페이스에 접근할 수 있는 권한을 요청하는 페이지로 리다이렉션됩니다. 필요한 권한을 부여하기 위해 **허용**을 클릭합니다.
14. 설치가 성공되었음을 나타내는 확인 메시지가 표시되고 Slack 워크스페이스로 리다이렉션됩니다.
15. 사이드바에서 **이벤트 권한**으로 이동하여 다음을 수행합니다:
    a. **이벤트 활성화** 토글. b. **요청 URL** 필드에 다음을 입력합니다:
    ```
    https://ai-api.automationanywhere.com/slack/events
    ```
    d. 그런 다음 아래의 **봇 이벤트 구독**으로 이동합니다. e. **봇 사용자 이벤트 추가**를 클릭하고 `app_mention`과 `message.im`의 두 이벤트를 추가합니다. f. **변경 사항 저장**을 클릭합니다.
16. 사이드바에서 **상호작용 및 단축키**로 이동하여 다음을 수행합니다:
    a. **상호작용** 토글. b. **요청 URL** 필드에 다음을 입력합니다:
    ```
    https://ai-api.automationanywhere.com/slack/events
    ```
    c. **변경 사항 저장**을 클릭합니다.
17. Slack 워크스페이스로 이동하면 왼쪽 사이드바의 앱 목록에 EKB 앱이 표시됩니다.

<Check>
  앱이 Slack 워크스페이스에 성공적으로 설치되었습니다! 다음 단계는 설정 명령어를 실행하여 EKB용 채널을 구성하는 것입니다.
</Check>

## EKB 앱용 채널 설정

EKB용 채널을 설정하려면 원하는 채널에서 `/setup` 명령어를 실행해야 합니다. 이 명령어는 채널이 EKB와 작동하도록 구성합니다.

1. Slack 워크스페이스를 열고 EKB를 설정할 채널로 이동합니다.
2. 메시지 입력 상자에 `/setup`을 입력하고 **Enter**를 누릅니다.
3. 다음 정보를 입력하라는 팝업이 나타납니다:
   * **채널** – EKB를 설정할 채널을 선택합니다.
     <Note>
       다이렉트 메시지에서 앱을 사용하려면 자신의 사용자 이름을 선택하세요.
     </Note>
   * **프로젝트 ID**: EKB 프로젝트 ID를 입력합니다.
   * **API Key**: EKB API Key를 입력합니다.
   * **API Secret**: EKB API Secret을 입력합니다.
4. **제출**을 클릭하여 설정 프로세스를 완료합니다. 앱은 정보를 확인하고 채널을 구성합니다.
5. 설정이 성공되면 채널에 EKB가 성공적으로 설정되었음을 나타내는 확인 메시지가 표시됩니다.<br />
   <Check>
     EKB가 선택한 채널에 설정되었습니다! 메시지에서 봇을 멘션하거나 슬래시 명령어를 사용하여 봇과 상호작용을 시작할 수 있습니다.
   </Check>