DOCS/docs/setups/ngrok-test-guide.md
happybell80 6a0852bc28 docs: Update README.md structure and CLAUDE.md for docs repository
- 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>
2025-07-03 13:11:48 +09:00

76 lines
1.9 KiB
Markdown

# ngrok을 통한 Slack 직접 연동 테스트
## 🚀 현재 상태
✅ ngrok 터널 생성 완료: `https://dc5c-59-9-195-150.ngrok-free.app`
✅ FastAPI 서버 실행 중
✅ Slack 토큰 설정 완료
## 📋 Slack 앱 설정 (필수)
### Event Subscriptions 설정
1. https://api.slack.com/apps 에서 로빙 앱 선택
2. "Event Subscriptions" → "Enable Events" 활성화
3. Request URL: `https://dc5c-59-9-195-150.ngrok-free.app/api/slack/events`
4. Bot events 추가:
- `app_mention`
- `message.channels`
- `message.im`
- `message.groups`
- `message.mpim`
5. "Save Changes" 및 필요시 앱 재설치
## 🧪 테스트 시나리오
### 1. 봇 초대
```
/invite @Roving
```
### 2. 직접 메시지
```
안녕하세요 로빙!
```
### 3. 멘션 테스트
```
@Roving 오늘 할 일을 정리해주세요
```
### 4. DM 테스트
봇과 직접 1:1 대화
## 📊 예상 응답
현재 테스트 모드에서는 다음과 같은 응답을 받게 됩니다:
```
안녕하세요! 테스트 모드에서 실행 중입니다. 메시지를 받았습니다: '[사용자 메시지]'
```
## 🔍 로그 모니터링
서버 로그에서 다음 메시지들을 확인할 수 있습니다:
- Slack 이벤트 수신
- 메시지 처리 과정
- AI 서비스 응답
## 🐛 문제 해결
### URL 검증 실패
- ngrok URL이 정확한지 확인
- `/api/slack/events` 경로 포함 여부 확인
### 봇이 응답하지 않음
- Event Subscriptions 설정 확인
- 봇 권한 확인
- 로그에서 에러 메시지 확인
### 권한 오류
- Bot Token Scopes 재확인
- 앱 재설치 시도
## 📱 실시간 모니터링
ngrok 웹 인터페이스에서 실시간 요청 확인:
http://localhost:4040
## 🎯 다음 단계
1. Slack 설정 완료 후 메시지 테스트
2. OpenAI API 키 설정하여 실제 AI 응답 활성화
3. 고급 기능 구현 (요약, 액션 추출, 기억 시스템)