# UX 리서치 봇 - Slack App 설정 가이드 웹앱(Streamlit)과 연동하여 슬랙봇을 운영하기 위한 Slack API 설정 방법입니다. ## 1. 앱 생성 (Create App) 1. [Slack API: Your Apps](https://api.slack.com/apps) 페이지로 이동합니다. 2. **"Create New App"** 버튼을 클릭합니다. 3. **"From scratch"**를 선택합니다. 4. **App Name**(예: `UX-Insight-Bot`)을 입력하고, 봇을 설치할 워크스페이스를 선택한 뒤 **Create App**을 누릅니다. ## 2. 권한 설정 (Scopes) 봇이 메시지를 읽고 쓸 수 있도록 권한을 부여해야 합니다. 1. 왼쪽 사이드바 메뉴에서 **"OAuth & Permissions"**를 클릭합니다. 2. 스크롤을 내려 **"Scopes"** 섹션의 **"Bot Token Scopes"**를 찾습니다. 3. **"Add an OAuth Scope"** 버튼을 눌러 아래 권한들을 차례로 추가합니다: - `app_mentions:read`: 봇을 멘션(@Bot)했을 때 메시지를 읽을 수 있습니다. - `chat:write`: 봇이 채널에 답변 메시지를 보낼 수 있습니다. - `files:write`: 봇이 이미지나 파일을 업로드할 수 있습니다 (분석 결과 공유 등). - `files:read`: **(중요)** 사용자가 올린 이미지/영상/문서 파일을 봇이 다운로드하여 분석할 수 있습니다. - `reactions:write`: **(필수)** 봇이 메시지에 이모지(확인 표시 등)를 달기 위해 필요합니다. - `channels:history`: **(필수)** 공개 채널의 스레드 문맥을 읽기 위해 필요합니다. - `groups:history`: **(필수)** 비공개 채널의 스레드 문맥을 읽기 위해 필요합니다. - `im:history`: **(필수)** DM(1:1 메시지)의 스레드 문맥을 읽기 위해 필요합니다. - `mpim:history`: **(필수)** 그룹 DM의 스레드 문맥을 읽기 위해 필요합니다. ## 3. 앱 설치 및 봇 토큰 발급 1. 같은 페이지 상단의 **"OAuth Tokens for Your Workspace"** 섹션으로 이동합니다. 2. **"Install to Workspace"** 버튼을 클릭하고 허용(Allow)합니다. 3. 생성된 **Bot User OAuth Token**을 복사하여 안전한 곳에 보관합니다. - 형식: `xoxb-...` - 용도: `.env` 파일의 `SLACK_BOT_TOKEN` 값으로 사용됩니다. ## 4. 소켓 모드 활성화 (Socket Mode) Hugging Face Spaces와 같이 외부 접속이 제한적이거나 타임아웃(3초)이 엄격한 환경에서는 **소켓 모드**가 가장 안정적입니다. 1. 왼쪽 사이드바 메뉴에서 **"Socket Mode"**를 클릭합니다. 2. **"Enable Socket Mode"** 스위치를 켭니다. 3. 토큰 이름을 지정(예: `socket-token`)하고 **Generate**를 클릭합니다. 4. 생성된 **App-level Token**을 복사하여 안전한 곳에 보관합니다. - 형식: `xapp-...` - 용도: `.env` 파일의 `SLACK_APP_TOKEN` 값으로 사용됩니다. ## 5. 이벤트 구독 설정 (Event Subscriptions) **주의: 이 설정은 'OAuth & Permissions' 메뉴가 아니라 'Event Subscriptions' 메뉴에서 진행해야 합니다.** 1. 왼쪽 사이드바 메뉴에서 **"Event Subscriptions"**를 클릭합니다. 2. **"Enable Events"** 스위치를 켭니다. 3. 스크롤을 내려 **"Subscribe to bot events"** 섹션을 찾습니다. 4. **"Add Bot User Event"** 버튼을 클릭합니다. 5. 검색창에 **`message.im`**을 입력하여 선택합니다. (설명: Message was posted in a direct message channel) - 만약 목록에 없다면 `message.channels` 등을 먼저 추가해보세요. 보통 `message.im`은 리스트에 있습니다. 6. `app_mention`도 함께 추가되어 있는지 확인합니다. 7. 하단의 **"Save Changes"** 버튼을 꼭 누릅니다. ## 6. App Home 설정 (중요: DM 활성화) 사용자가 봇에게 1:1 메시지(DM)를 보낼 수 있도록 하려면 이 설정이 필수입니다. 1. 왼쪽 사이드바 메뉴에서 **"App Home"**을 클릭합니다. 2. 스크롤을 내려 **"Show Tabs"** 섹션의 **"Messages Tab"**을 찾습니다. 3. **"Allow users to send Slash commands and messages from the messages tab"** 체크박스를 **체크**합니다. - 이 옵션이 켜져 있어야 봇과의 1:1 채팅창이 활성화됩니다. 4. **"Allow users to send Slash commands and messages from the messages tab"** 바로 아래에 있는 **Review Link**나 관련 설정을 확인하세요. (보통 체크만 하면 됩니다) ## 7. 앱 재설치 (가장 중요!) **설정을 변경했다면 반드시 앱을 재설치해야 적용됩니다.** 1. 왼쪽 사이드바 메뉴에서 **"Install App"**을 클릭합니다. 2. **"Reinstall to Workspace"** 버튼을 클릭하여 다시 설치(허용)합니다. - 이 과정을 거쳐야 App Home 설정이나 권한 변경 사항이 실시간으로 반영됩니다. ## 8. 환경 변수 등록 발급받은 토큰을 프로젝트의 `.env` 파일과 Hugging Face Secrets에 등록해야 합니다. ```bash SLACK_BOT_TOKEN=xoxb-xxxxxxxxx... SLACK_APP_TOKEN=xapp-xxxxxxxxx... ``` 이제 Slack API 설정이 완료되었습니다! 이 설정이 끝나면 코드를 업데이트하여 봇을 실행할 수 있습니다.