Slack 연동

## 이 연동으로 되는 것 - **팀 채널로 알림 수신** — 모닝 브리핑 · 능동 알림 · 예산 경보 - **AI 비서와 대화** — Slack 에서 질문하고 답 받기 개인 알림(Telegram)과 달리 **팀이 같이 보고 스레드에서 대응**할 수 있는 것이 장점입니다. ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | Slack 워크스페이스 **관리자 권한** | — | 앱 설치 승인에 필요 | | Slack 앱 | api.slack.com/apps | | | **Bot Token** | 앱 → OAuth & Permissions | `xoxb-` 로 시작 | | **채널** | 알림을 받을 채널 | 봇을 초대해야 합니다 | ## 발급 절차 ### 1. Slack 앱 만들기 1. [Slack API](https://api.slack.com/apps) → **Create New App** → **From scratch** 2. 앱 이름 입력 (예: `Morning Insight`) 후 워크스페이스 선택 ### 2. 봇 권한 설정 **OAuth & Permissions** → **Scopes** → **Bot Token Scopes** 에 추가합니다. | 권한 | 무엇을 위해 | |---|---| | `chat:write` | 메시지 발송 (필수) | | `channels:read` | 채널 목록 조회 | | `app_mentions:read` | 멘션 감지 (대화 기능) | | `im:history` · `im:write` | 봇 DM 대화 | ### 3. 워크스페이스에 설치 **OAuth & Permissions** 상단의 **Install to Workspace** 클릭 → 승인 설치 후 **Bot User OAuth Token** 이 표시됩니다 (`xoxb-` 로 시작) → 복사 > 워크스페이스 정책에 따라 **관리자 승인**이 필요할 수 있습니다. ### 4. 채널에 봇 초대 — 빠뜨리기 쉬움 알림을 받을 채널에서 봇을 초대합니다. ``` /invite @Morning Insight ``` > ⚠️ **초대하지 않으면 그 채널로 발송이 실패합니다.** > "토큰은 맞는데 메시지가 안 온다"의 대부분이 이 문제입니다. ## 모닝인사이트에 입력 1. **설정 → 알림** 탭 2. **메신저 AI 비서 연동 → Slack** 카드 클릭 3. Bot Token 과 알림을 받을 **채널**을 입력 4. **저장** → 테스트 발송으로 확인 ## 알림 켜기 연동만으로는 알림이 오지 않습니다. 1. **설정 → 알림** 에서 받을 알림 종류를 켭니다 2. 채널로 **Slack** 을 선택합니다 3. **지금 즉시 실행** 으로 실제 발송을 확인합니다 능동 알림은 **설정 → AI Agent → 능동 알림** 에서 별도로 Slack 을 선택합니다 → [능동 알림 설정](/news/guide/proactive-alerts) ## 어느 채널로 받을까 | 알림 | 권장 채널 | |---|---| | 데일리 브리핑 · 주간 리포트 | 경영진 채널 또는 전사 공지 채널 | | 예산 소진 경보 | **마케팅 채널** — 대응할 사람이 있는 곳 | | 능동 알림 (이상 감지) | 실무 채널 — 즉시 확인할 사람이 있는 곳 | > 알림을 아무도 대응하지 않는 채널에 보내면 무시됩니다. > **대응할 사람이 있는 채널**로 보내세요. ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 메시지가 안 온다 | **채널에 봇 미초대** | `/invite @봇이름` | | 인증 실패 | 토큰이 `xoxb-` 로 시작하지 않음 | Bot User OAuth Token 을 사용 | | 인증 실패 | 토큰 복사 시 공백 포함 | 다시 붙여넣기 | | `missing_scope` | 권한 누락 | Bot Token Scopes 추가 후 **재설치** | | 앱 설치가 거부된다 | 워크스페이스 정책 | 워크스페이스 관리자에게 승인 요청 | | 비공개 채널에 안 온다 | 봇 미초대 | 해당 채널에서 봇 초대 | | 갑자기 안 온다 | 앱이 워크스페이스에서 제거됨 | 재설치 후 토큰 교체 | > 권한(Scope)을 추가하면 **반드시 앱을 재설치**해야 적용됩니다. 토큰도 새로 발급됩니다. ## 보안 주의 - Bot Token 은 비밀입니다. 노출되면 워크스페이스에 메시지를 보낼 수 있습니다 - 유출 시 Slack 앱 설정에서 토큰을 재발급하세요 - 회사 지표가 흐르는 채널이므로 **채널 멤버 범위**를 확인하세요 ## 관련 문서 - [모닝 브리핑 받기](/news/guide/morning-briefing) - [능동 알림 설정](/news/guide/proactive-alerts) - [Telegram 연동](/news/guide/telegram) · [Microsoft Teams 연동](/news/guide/teams)