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

1.9 KiB

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. 고급 기능 구현 (요약, 액션 추출, 기억 시스템)