Microsoft Teams 연동

## 먼저 알아둘 것 Teams 는 **네 개 메신저 중 준비 과정이 가장 깁니다.** Azure Bot 리소스 + Bot Framework 자격증명 + Teams 앱 등록이 모두 필요합니다. Teams 를 꼭 써야 하는 조직이 아니라면 [Telegram](/news/guide/telegram)이나 [Slack](/news/guide/slack)이 훨씬 빠릅니다. ## 이 연동으로 되는 것 - Teams 로 알림 수신 (모닝 브리핑 · 능동 알림) - Teams 에서 AI 비서와 대화 ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | Azure 구독 | portal.azure.com | Bot 리소스 생성용 | | **App ID** | Bot Framework | | | **App Password** | Bot Framework | 발급 시 한 번만 표시 | | Teams 앱 등록 권한 | Teams 관리 센터 | 조직 정책에 따라 관리자 필요 | | 서비스 도메인 (HTTPS) | — | 메시징 엔드포인트용 | ## 등록 절차 ### 1. Azure Bot 리소스 생성 1. [Azure Portal](https://portal.azure.com) → **Azure Bot** 리소스 생성 2. 이름·구독·리소스 그룹 지정 ### 2. App ID · App Password 발급 Bot Framework 에서 **App ID** 와 **App Password**(클라이언트 비밀)를 발급받습니다. > ⚠️ **App Password 는 발급 시 한 번만 표시됩니다.** 즉시 안전한 곳에 보관하세요. > 만료 기간이 있으므로 **만료일을 캘린더에 등록**하세요. 만료되면 알림이 조용히 멈춥니다. ### 3. 메시징 엔드포인트 설정 Azure Bot 설정에서 메시징 엔드포인트를 지정합니다. ``` https://<서비스 도메인>/webhook/teams ``` > HTTPS 가 필수입니다. 도메인을 모르면 운영 담당자에게 확인하세요. ### 4. Teams 앱 등록 1. [Teams Developer Portal](https://dev.teams.microsoft.com) 접속 2. **앱** → **새 앱** 생성 3. **봇 추가** → 위에서 만든 Bot 의 **App ID** 입력 4. 앱 매니페스트를 다운로드해 Teams 에 업로드(사이드로딩) > 조직 정책에 따라 사이드로딩이 차단돼 있으면 **Teams 관리자 승인**이 필요합니다. ## 모닝인사이트에 입력 1. **설정 → 알림** 탭 2. **메신저 AI 비서 연동 → Microsoft Teams** 카드 클릭 3. **App ID** · **App Password** 입력 4. **저장** ## 5. Teams 에서 봇과 첫 대화 — 필수 Teams 에서 봇을 찾아 **메시지를 한 번 보냅니다.** 이때 발송에 필요한 대화 정보가 자동으로 저장됩니다. > ⚠️ **첫 대화를 하지 않으면 알림을 보낼 수 없습니다.** > Teams 는 봇이 먼저 말을 걸 수 있는 대상을 대화 이력이 있는 곳으로 제한합니다. ## 알림 켜기 1. **설정 → 알림** 에서 받을 알림 종류를 켭니다 2. 채널로 **Teams** 를 선택합니다 3. **지금 즉시 실행** 으로 발송을 확인합니다 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 알림이 안 온다 | **Teams 에서 봇과 첫 대화를 안 함** | 봇에게 메시지 한 번 전송 | | 인증 실패 | App Password 오류 | 재발급 후 재입력 | | 봇이 응답하지 않는다 | 메시징 엔드포인트 오류 | HTTPS 주소·경로 확인 | | 봇이 응답하지 않는다 | 엔드포인트가 외부에서 접근 불가 | 방화벽·프록시 확인 | | 앱 설치가 안 된다 | 조직이 사이드로딩 차단 | Teams 관리자 승인 요청 | | 갑자기 멈췄다 | **App Password 만료** | 새 비밀 발급 후 교체 | ## 운영 주의 — App Password 만료 Azure 클라이언트 비밀은 만료 기간이 있습니다. 만료되면 **예고 없이 알림이 멈춥니다.** | 시점 | 할 일 | |---|---| | 만료 1개월 전 | 새 비밀 발급 → 설정에서 교체 | | 만료 후 | 알림 전면 중단 | 가장 흔한 Teams 연동 장애 원인입니다. ## 관련 문서 - [모닝 브리핑 받기](/news/guide/morning-briefing) - [Telegram 연동](/news/guide/telegram) · [Slack 연동](/news/guide/slack) — 더 간단한 대안 - [Outlook 앱 등록 (운영자)](/news/guide/operator-outlook) — 같은 Azure 만료 이슈