6a0852bc28
- README.md: Updated file paths to match actual docs/ directory structure - Added new documents found in current structure - Fixed project name from "로빙(Roving)" to "로빙(Robing)" for consistency - Reorganized document navigation guide for better user experience - CLAUDE.md: Refined repository-specific rules - Removed duplicated content with main project CLAUDE.md - Added happybell80 branch strategy for PR workflow - Updated directory structure to reflect actual layout - Focused on docs-specific workflows and quality standards 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
95 lines
2.2 KiB
Markdown
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 @Roving
|
|
```
|
|
|
|
### 2. 직접 메시지
|
|
```
|
|
안녕하세요 로빙!
|
|
```
|
|
|
|
### 3. 멘션 테스트
|
|
```
|
|
@Roving 오늘 할 일을 정리해주세요
|
|
```
|
|
|
|
## 📊 예상 결과
|
|
```
|
|
안녕하세요! 테스트 모드에서 실행 중입니다. 메시지를 받았습니다: '[메시지]'
|
|
```
|
|
|
|
## 🔍 로그 확인
|
|
실시간 로그 모니터링:
|
|
- ngrok: http://localhost:4040
|
|
- 서버 로그에서 "Received Slack event" 메시지 확인
|
|
|
|
## 🐛 문제 해결
|
|
|
|
### URL 검증 실패
|
|
- ngrok URL 정확성 확인
|
|
- 서버 실행 상태 확인
|
|
|
|
### 봇 무응답
|
|
- Event Subscriptions 저장 확인
|
|
- 앱 재설치 완료 확인
|
|
- 봇 권한 확인
|
|
|
|
### 권한 오류
|
|
- OAuth Scopes 재확인
|
|
- 워크스페이스 관리자 권한 확인
|
|
|
|
## ✨ 설정 완료 후
|
|
Slack에서 메시지를 보내면:
|
|
1. ngrok 로그에 요청 기록
|
|
2. 서버에서 이벤트 처리
|
|
3. AI 서비스에서 응답 생성
|
|
4. Slack으로 응답 전송
|
|
|
|
모든 설정이 완료되면 로빙이 정상적으로 응답할 것입니다! |