DOCS/troubleshooting/250919_naverworks_to_slack_mail_integration.md

NAVER WORKS 이메일 → Slack 전달 시스템 구현

날짜: 2025-09-19

작성자: Claude (51123 서버 관리자)

관련 서비스: rb8001, skill-email

상태: 부분 구현

---

1. 현재 구현 상태

구현 완료

• auth-server:
  • naverworks.py, naverworks_passport.py 파일 존재
  • NAVER WORKS OAuth 환경변수 설정 (CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, TENANT_ID)
• skill-email (포트 8501):
  • services/naverworks_provider.py NaverWorksProvider 클래스 구현
  • GET /messages 엔드포인트 (provider 파라미터 지원)
  • POST /send 엔드포인트
• rb8001:
  • app/skills/email_integration.py EmailIntegration 클래스 존재
  • skill-email 포트 8501 호출 구조

미구현

• POST /mail-summary 엔드포인트 없음
• rb8001 EmailIntegration 클래스는 Gmail만 처리
• 네이버웍스 메일 키워드 감지 로직 없음
• Slack Block Kit 포맷터 없음

---

2. 필요 구현 사항

2.1 skill-email 수정 사항

• POST /mail-summary 엔드포인트 추가 필요
• 메일 요약 생성 로직 구현 필요
• Slack 블록 포맷 변환 기능 필요

2.2 rb8001 수정 사항

• EmailIntegration 클래스에 NaverWorks 지원 추가 필요
• 네이버웍스 메일 키워드 감지 로직 추가 필요
• provider=naverworks 파라미터 전달 로직 필요

---

3. 파일 위치

skill-email

• main.py: API 엔드포인트 정의
• services/naverworks_provider.py: NAVER WORKS API 연동
• services/gmail_provider.py: Gmail API 연동
• services/email_provider.py: Provider 인터페이스

rb8001

• app/skills/email_integration.py: 이메일 스킬 통합
• app/main.py: 메시지 라우팅

auth-server

• app/providers/naverworks.py: OAuth 로그인
• app/providers/naverworks_passport.py: Passport 시스템

---

4. 구현 체크리스트

• skill-email /mail-summary 엔드포인트 구현
• rb8001 EmailIntegration에 NaverWorks 지원 추가
• 네이버웍스 메일 키워드 감지 로직 추가
• Slack Block Kit 포맷터 구현
• provider 파라미터 전달 로직 구현

---

5. 환경 설정 확인 사항

• skill-email .env 파일에 NAVER WORKS 관련 설정 확인
• rb8001에서 skill-email 호출 시 포트 8501 사용
• auth-server의 NAVER WORKS OAuth 설정 확인