DOCS/_archive/docs/setups/slack-setup-final.md
happybell80 53da59d673 docs: Roving → robeing 표기 통일
Made-with: Cursor
2026-03-16 09:05:54 +09:00

95 lines
2.2 KiB
Markdown

# 🎯 Slack 앱 최종 설정 가이드
## ✅ 현재 상태
- ngrok 터널: `https://dc5c-59-9-195-150.ngrok-free.app`
- FastAPI 서버: 실행 중
- URL 검증: 성공
- 이벤트 처리: 동작 확인
## 📋 Slack 앱 설정 단계
### 1. Event Subscriptions 설정
1. https://api.slack.com/apps 접속
2. 로빙 앱 선택
3. **"Event Subscriptions"** 클릭
4. **"Enable Events"** 토글 ON
5. **Request URL** 입력:
```
https://dc5c-59-9-195-150.ngrok-free.app/api/slack/events
```
6. ✅ **"Verified"** 표시 확인
### 2. Bot Events 구독
**"Subscribe to bot events"** 섹션에서 다음 이벤트 추가:
- `app_mention` - 봇 멘션시 알림
- `message.channels` - 채널 메시지
- `message.groups` - 그룹 메시지
- `message.im` - 직접 메시지
- `message.mpim` - 멀티파티 DM
### 3. OAuth & Permissions 확인
다음 권한이 있는지 확인:
- `app_mentions:read`
- `channels:read`
- `chat:write`
- `chat:write.public`
- `im:read`
- `im:write`
- `users:read`
### 4. 앱 재설치
설정 변경 후:
1. **"Save Changes"** 클릭
2. **"Install to Workspace"** 또는 **"Reinstall App"**
3. 권한 승인
## 🧪 테스트 방법
### 1. 봇 초대
```
/invite @robeing
```
### 2. 직접 메시지
```
안녕하세요 로빙!
```
### 3. 멘션 테스트
```
@robeing 오늘 할 일을 정리해주세요
```
## 📊 예상 결과
```
안녕하세요! 테스트 모드에서 실행 중입니다. 메시지를 받았습니다: '[메시지]'
```
## 🔍 로그 확인
실시간 로그 모니터링:
- ngrok: http://localhost:4040
- 서버 로그에서 "Received Slack event" 메시지 확인
## 🐛 문제 해결
### URL 검증 실패
- ngrok URL 정확성 확인
- 서버 실행 상태 확인
### 봇 무응답
- Event Subscriptions 저장 확인
- 앱 재설치 완료 확인
- 봇 권한 확인
### 권한 오류
- OAuth Scopes 재확인
- 워크스페이스 관리자 권한 확인
## ✨ 설정 완료 후
Slack에서 메시지를 보내면:
1. ngrok 로그에 요청 기록
2. 서버에서 이벤트 처리
3. AI 서비스에서 응답 생성
4. Slack으로 응답 전송
모든 설정이 완료되면 로빙이 정상적으로 응답할 것입니다!