안전운영

n8n을 올린 뒤 Microsoft Teams 자격 증명을 다시 연결할 시점을 점검해보세요

쿠팡 파트너스 활동으로 수수료를 받을 수 있음

먼저 결론

n8n 2.40~2.42에서 Teams 노드에 채널 메시지 삭제, 팀 태그 멘션, 활동 피드 알림이 더해졌고 모두 새 권한이 필요해요. 기존 OAuth2 자격 증명은 예전 권한을 그대로 들고 있으니, 새 작업을 워크플로에 넣기 전에 어느 버전에서 어떤 권한이 늘었는지부터 확인하세요.

창가 오크 책상 위 실로 차례로 이어진 무지 카드 네 장과 놋쇠 열쇠, 닫힌 노트북, 세이지색 머그와 작은 화병

업그레이드만 하면 새 Teams 작업을 바로 쓸 수 있나요?

그렇지 않아요. 릴리스 노트는 2.40의 채널 메시지 삭제에 대해 기존 자격 증명이 원래 권한을 유지한다고 적고, 2.42의 활동 피드 알림에 대해서는 기존 OAuth2 자격 증명을 다시 연결해야 새 권한을 받는다고 안내해요. 노드 문서에도 같은 내용이 버전별로 정리돼 있어요.

입력(워크플로의 Teams 작업) → n8n 버전 → 자격 증명이 가진 권한 → Microsoft 관리자 동의

이 네 가지가 모두 맞아야 새 작업이 돌아가요. 버전을 올린 사실만으로는 마지막 두 칸이 채워지지 않아요.

어느 버전에서 어떤 권한이 늘었나요?

노드 문서가 정리한 재연결 기준은 아래와 같아요. 해당 버전보다 먼저 만든 Teams OAuth2 자격 증명이 대상이에요. 2.40은 2026-09-15, 2.41은 2026-09-22, 2.42는 2026-09-29에 나왔어요. 확인일은 2026-10-12예요.

버전더해진 기능필요한 권한
2.39.0온라인 회의 작업OnlineMeetings.ReadWrite
2.40.0채널 메시지 삭제ChannelMessage.ReadWrite (관리자 동의 필요)
2.41.0팀 태그 멘션TeamworkTag.Read
2.42.0활동 피드 알림TeamsActivity.Send

2.43 릴리스 노트에는 Teams 항목이 없어요. 사용자 멘션을 쓰려면 User.Read.All도 필요하다고 문서에 적혀 있어요.

재연결은 어떻게 하나요?

자격 증명 종류에 따라 순서가 달라요.

  1. 기본인 Teams OAuth2 자격 증명이라면 자격 증명 화면에서 다시 연결해 새 권한을 받아요.
  2. Custom Scopes를 켜 두었다면 Enabled Scopes에 필요한 권한을 먼저 더한 뒤 다시 연결해요.
  3. Microsoft OAuth2 (Graph) 자격 증명이라면 Scope 칸에 권한을 직접 더해야 해요.

재연결하기 전에 이 자격 증명을 쓰는 워크플로가 몇 개인지 먼저 세어 두세요. 같은 자격 증명을 여러 워크플로가 함께 쓰면 한 번의 재연결이 전체에 영향을 줘요. 이 순서는 문서 안내를 바탕으로 한 일반 권고이고, 실제 화면 이름은 사용 중인 버전에서 확인하세요.

관리자 동의를 받지 못하면 어떻게 되나요?

문서는 ChannelMessage.ReadWrite가 관리자 동의를 요구한다고 설명해요. 동의를 받지 못하면 Microsoft가 "승인 필요" 단계에서 멈추고 자격 증명이 토큰을 받지 못해요. 그러면 삭제 작업만이 아니라 그 자격 증명의 모든 작업이 실패한다고 적혀 있어요.

그래서 삭제 기능이 당장 필요 없다면 서둘러 권한을 늘리지 않는 편이 안전해요. 필요한 팀이라면 Microsoft 365 관리자에게 동의 요청을 먼저 보내 두세요.

활동 피드 알림은 무엇을 더 준비해야 하나요?

활동 피드 알림은 채널이나 채팅이 아니라 받는 사람의 활동 탭에 올라가요. 권한만으로는 부족하고, 문서가 말하는 준비물이 더 있어요.

  • 자격 증명의 클라이언트 ID와 매니페스트의 webApplicationInfo.id가 같은 짝 Teams 앱이 있어야 해요.
  • 관리자가 그 앱을 조직 카탈로그에 올리고, 받는 사람마다 설치해야 해요. 설치가 반영되기까지 몇 분 걸릴 수 있어요.
  • Topic Link는 Microsoft Teams 도메인의 https 주소여야 해요.

짝 앱이 없으면 Microsoft Graph가 403을 돌려줘요. 이 작업은 OAuth2, Microsoft, Service Principal 자격 증명에서 모두 쓸 수 있어요.

운영 워크플로에 넣기 전에 무엇을 시험하나요?

운영 워크플로를 고치기 전에 복사본에서 받는 사람 한 명으로 먼저 돌려 보세요. 재연결 직후 기존 Teams 작업이 그대로 도는지, 새 작업이 403이나 승인 필요 오류 없이 끝나는지를 함께 봐요. 문제가 나면 기존 알림 경로는 그대로 남겨 두고 새 작업만 되돌리세요.

출처: n8n Release notes, n8n Microsoft Teams node. 확인일 2026-10-12.

자주 묻는 질문

n8n을 업그레이드하면 Teams 자격 증명이 자동으로 새 권한을 받나요?

아니에요. 공식 문서는 채널 메시지 삭제를 설명하면서 기존 자격 증명은 처음 받은 권한을 유지한다고 적고, 활동 피드 알림은 기존 OAuth2 자격 증명을 다시 연결해야 새 권한을 받는다고 안내해요.

Service Principal 자격 증명이면 채팅 메시지 삭제도 쓸 수 있나요?

아니에요. 공식 문서는 Service Principal 자격 증명에서 채팅 관련 작업과 삭제·삭제 취소를 쓸 수 없다고 적어요. 이 작업들은 로그인한 사용자 권한으로 실행돼요.

활동 피드 알림은 채널이나 채팅에 올라가나요?

아니에요. 공식 문서는 받는 사람의 Teams 활동 탭에 올라간다고 설명해요. 받는 사람에게 짝이 되는 Teams 앱이 설치돼 있어야 하고, 없으면 Microsoft Graph가 403을 돌려줘요.

출처와 확인일

  1. n8n 공식 문서: Release notes (2.40, 2.41, 2.42) · 확인일
  2. n8n 공식 문서: Microsoft Teams node · 확인일

모든 자료는 제조사·판매처가 공개한 내용을 확인한 것이며, 확인 이후 달라졌을 수 있습니다.

이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.