Microsoft Teams 연결: 단계별 가이드
실행 요약을 Teams 채널에 게시하며, NEXUS_TEAMS_NOTIFY=true이면 실패한 테스트마다 메시지를 하나씩 게시합니다. 이 가이드는 처음부터 연결을 확인하기까지의 과정을 안내하고, 발생할 수 있는 오류와 그 원인 및 해결 방법을 정리합니다.
최종 업데이트:
자격 증명은 비공개로 유지하세요. 토큰, 키, 비밀번호, 웹후크 URL을 채팅에 붙여넣지 마세요. Studio → 설정 → 연동에만 입력하세요. 입력한 정보는 작업 공간의 .env 파일에 저장되며 점으로 표시됩니다. AI 도우미도 마찬가지입니다: 이 안내를 따라 진행하도록 도와줄 수는 있지만, 토큰을 알려줄 필요는 없습니다.
준비 사항
- 워크플로를 추가할 수 있는 Teams 채널.
- 해당 채널의 Workflows 웹훅 URL 하나.
자격 증명 발급
- Teams에서 채널의 ··· 메뉴 → 워크플로를 열고 "웹후크 요청을 받으면 채널에 게시"를 추가하세요.
- 제공된 웹후크 URL을 복사하세요. 도메인은 logic.azure.com입니다 (이전 커넥터: webhook.office.com). URL 자체가 비밀 정보입니다.
- 클립보드에 보관하세요. Studio(다음 단계) 외에는 어디에도 붙여넣지 마세요.
Studio에서 연결
- Studio에서 설정 → 연동 → Microsoft Teams를 여세요.
- 웹훅 URL을 붙여넣고 저장 & 테스트 전송을 누르세요. 채널로 테스트 메시지가 전송됩니다.
TEAMS_ENABLED를 켜세요. 실패한 테스트마다 메시지를 하나씩 보내려면NEXUS_TEAMS_NOTIFY도 켜세요.
작동 확인
- 테스트 메시지 전송을 누르면 "전송됨."이라는 응답이 나오고 채널에 메시지가 표시됩니다.
- 아무 테스트나 실행하세요. 실행 요약이 채널로 전송됩니다.
자주 발생하는 오류
| 관찰되는 결과 | 원인 | 해결 방법 |
|---|---|---|
| "웹훅 없음" | TEAMS_WEBHOOK_URL이 비어 있습니다. | 설정 → 연동에서 웹훅 URL을 붙여넣고 저장하세요. |
"TEAMS_WEBHOOK_URL이 Teams 웹후크가 아닙니다" | 값이 logic.azure.com 또는 webhook.office.com의 https URL이 아닙니다. | 워크플로의 "웹후크 요청을 받으면 채널에 게시" 트리거에서 URL을 다시 복사하세요. |
| Teams의 HTTP 4xx 또는 5xx 응답 | 워크플로가 꺼지거나 삭제되었거나, 소유자가 퇴사했거나 라이선스를 상실하여 더 이상 실행되지 않습니다. | Teams에서 워크플로를 열고 (워크플로 → 관리), 켜거나 새로 만든 다음 새 URL을 저장하세요. |
| "Teams에 연결할 수 없습니다 (ENOTFOUND)" 또는 "20초 이내에 응답하지 않았습니다" | 이 PC에서 Microsoft에 연결할 수 없습니다: VPN이나 프록시 때문이거나 네트워크에 연결되어 있지 않습니다. | 동일한 PC에서 네트워크를 확인하고 다시 시도하세요. |
| 테스트는 작동하지만 실패 알림이 게시되지 않음 | TEAMS_ENABLED가 false이거나 실행 요약만 켜져 있습니다: 테스트별 메시지를 보내려면 NEXUS_TEAMS_NOTIFY=true가 필요합니다. | 두 스위치를 모두 켜세요. |
설정 키
| 키 | 주요 기능 | 유효한 값 | 확인 방법 |
|---|---|---|---|
TEAMS_ENABLED | Microsoft Teams로 알림 보내기 | true 또는 false | 테스트 메시지가 도착한 후 켜세요. |
TEAMS_WEBHOOK_URL | 알림용 Teams 채널 (비밀 정보, 이 컴퓨터에만 저장됨) | https://…logic.azure.com 또는 …webhook.office.com URL | 테스트 메시지 전송을 누르면 채널에 메시지가 게시됩니다. |
NEXUS_TEAMS_NOTIFY | 실패할 때마다 Teams 알림 | true 또는 false | 실행 요약뿐 아니라 실패한 테스트마다 메시지가 하나씩 전송됩니다. |
더 보기: 모든 연동, 설정 안내, 문제 해결. 다른 안내: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
아직 해결되지 않았나요? Studio에 표시되는 오류 문구를 그대로 적어 [email protected]으로 보내 주세요. 토큰은 포함하지 마세요.