M365Con 2027 – 무료 온라인 컨퍼런스 · 11–22 Jan 2027 · 120 sessions m365con.net

블로그 · Mirko Peters

Teams 커넥터와 웹후크: 지원 종료 현황과 워크플로로 대체하는 방법

By ·

Teams의 Office 365 커넥터와 커넥터 기반 수신 웹후크가 2026년 5월에 지원이 종료되었습니다. 이 가이드에서는 작동이 중단된 항목, 이를 대체하는 기능, 마이그레이션 방법, 그리고 워크플로가 여전히 다른 부분을 다룹니다.

Automatically translated with AI from the original post. Read the English original

Incoming Webhook 커넥터를 포함한 Teams 커넥터는 더 이상 사용할 수 없습니다. Microsoft Learn에 따르면 Teams의 Office 365 커넥터는 2026년 5월에 지원이 종료되었으며, 이제 웹후크 요청을 받고 Teams에 게시하는 방법은 Workflows 앱입니다. Teams 웹후크 요청이 수신되는 경우 트리거로 만든 워크플로가 기존 커넥터 URL을 대체합니다.

핵심 포인트

  • Microsoft Learn에 따르면 커넥터 기반 수신 웹후크를 포함한 Teams의 Office 365 커넥터는 2026년 5월에 지원이 종료되었습니다. 개발자 블로그에 명시된 최종 배포 기간은 2026년 5월 18일부터 5월 22일까지입니다.
  • 대체 수단은 Power Automate 기반인 Teams의 Workflows 앱입니다. "Teams 웹후크 요청이 수신되는 경우" 트리거를 사용하거나 미리 만들어진 템플릿을 활용하십시오.
  • 워크플로에는 고유한 웹후크 URL이 있으므로, 기존 커넥터 URL은 더 이상 작동하지 않기 때문에 이를 보내는 모든 시스템을 새 URL로 바꿔야 합니다.
  • MessageCard 페이로드는 렌더링되지만 HttpPost 버튼은 작동하지 않습니다. 대화형 콘텐츠에는 Adaptive Cards를 사용하십시오.
  • 워크플로는 채널이 아니라 소유자에게 속합니다. 소유자가 조직을 떠나도 워크플로가 방치되지 않도록 공동 소유자를 추가하십시오.

이 글에서는 지원이 종료된 기능, 이를 대체하는 기능, 이전 방법, 그리고 여전히 문제를 일으킬 수 있는 차이점을 설명합니다.

지원 종료 대상과 시기

지원 종료는 거의 2년에 걸쳐 진행되었으며, 날짜는 여러 차례 변경되었습니다. Microsoft 365 개발자 블로그에 기록된 경과는 다음과 같습니다.

  • 2024년 7월: 2024년 8월 15일부터 새 커넥터를 차단하고 2024년 10월 1일에 모든 커넥터를 중단한다는 첫 번째 계획이 발표되었습니다.
  • 2024년 7월: 지원 종료가 2025년 12월까지 연기되었습니다.
  • 2025년 10월: 마이그레이션 마감일이 2026년 3월 31일로 변경되었습니다.
  • 2026년 2월: Workflows에 Message Card 지원이 추가되었고, Workflows 봇이 공유 채널에 게시할 수 있게 되었습니다. 마감일은 2026년 4월 30일로 변경되었습니다.
  • 2026년 4월 14일(최종 업데이트): 배포는 2026년 5월 18일에 시작하여 2026년 5월 22일에 완료됩니다. 이후 커넥터는 더 이상 작동하지 않습니다.

영향을 받는 항목은 Teams의 Office 365 커넥터로, Incoming Webhook 같은 웹후크 기반 커넥터와 URL로 게시하는 타사 커넥터가 포함됩니다. 블로그에서는 웹후크 URL 변경이 RSS와 같은 폴링 커넥터가 아니라 웹후크 기반 커넥터에 적용된다고 설명합니다.

아직도 기존 커넥터를 통해 게시되는 항목이 있다면, 이미 작동하지 않거나 곧 중단될 것으로 간주하고 지금 바로 마이그레이션을 계획하십시오.

커넥터를 대체하는 기능

Microsoft Learn에서는 세 가지 경로를 제시합니다.

  1. Workflows 앱(Power Automate)은 수신 웹후크에 사용합니다. 미리 정의된 템플릿이나 Teams 웹후크 요청이 수신되는 경우 트리거를 사용하십시오.
  2. ISV 및 제품 팀을 위한 Power Automate 커넥터입니다. Learn에서는 Teams와 데이터를 프로그래밍 방식으로 주고받는 확장 가능하고 안전한 방법이라고 설명합니다.
  3. 사전 알림 메시지가 포함된 Teams 앱입니다. 사용자는 시스템의 트리거 이벤트를 기준으로 메시지를 설정할 수 있습니다.

대부분의 관리자와 스크립트 작성자에게는 경로 1이 가장 직접적인 대체 방법입니다.

웹후크를 Workflows로 마이그레이션하는 방법

이 글을 작성할 당시 수신 웹후크에 관한 Microsoft 지원 페이지를 열 수 없었습니다. 따라서 아래 단계는 개발자 블로그와 Learn 커넥터 참조 문서를 기준으로 합니다.

  1. 사용 중인 모든 커넥터를 확인하십시오. 채널 관리 > 커넥터를 사용한 채널과 모니터링, 빌드 또는 티켓 도구처럼 알림을 보내는 시스템을 점검하십시오.
  2. Teams에서 Workflows 앱을 여십시오. 개발자 블로그에 따르면 채팅이나 채널에서 추가 옵션(...)을 통해서도 열 수 있습니다.
  3. 미리 정의된 웹후크 템플릿을 선택하거나, 트리거 Teams 웹후크 요청을 받은 경우를 사용해 처음부터 만드십시오.
  4. 팀과 채널을 선택한 후 저장하고, Power Automate에서 워크플로의 트리거 URL을 복사하십시오.
  5. 전송 시스템에 있는 기존 커넥터 URL을 새 URL로 바꾸십시오.
  6. 워크플로의 이름과 설명을 입력하고 테스트한 뒤, 공동 소유자를 추가하십시오.
  7. 테스트 POST를 보내고 메시지가 표시되는지 확인하십시오.

트리거는 POST 요청만 허용합니다. Learn 커넥터 참조 문서에 따르면 GET 요청은 지원되지 않습니다.

페이로드 형식과 카드

트리거 본문에는 적응형 카드 배열을 포함할 수 있습니다. 참조 문서에는 contentType이 application/vnd.microsoft.card.adaptive인 attachments 배열이 있는 메시지가 나와 있습니다. 단일 Message Card 본문도 허용됩니다.

다음 사항을 염두에 두십시오.

  • 대화형 콘텐츠를 만들 때 지원되는 방식은 적응형 카드입니다.
  • MessageCard 페이로드는 렌더링되지만, HttpPost를 사용하는 버튼은 작동하지 않습니다. 개발자 블로그에서는 대화형 카드 요소를 사용하는 경우 적응형 카드로 전환하라고 권장합니다.

액세스 제어

실질적인 개선 사항이 하나 있습니다. 트리거에 인증 설정이 추가되었습니다. Learn에는 세 가지 옵션이 나와 있습니다.

| 설정 | 전송 측에서 해야 할 작업 | |---|---| | 모든 사용자 | 인증 토큰 헤더를 보내지 않아도 되며, 그렇지 않으면 요청이 실패합니다 | | 내 테넌트의 모든 사용자 | 인증 토큰을 보내야 합니다 | | 내 테넌트의 특정 사용자 | 인증 토큰을 보내야 하며, 해당 사용자가 허용 목록에 있어야 합니다 |

테넌트 옵션과 관련해 Learn은 HTTP 요청 트리거용 OAuth 인증 가이드를 안내합니다. 도구가 URL로 일반 POST 요청만 보낼 수 있다면 Anyone 설정이 필요합니다. 그런 경우에는 URL을 비밀 정보처럼 취급하십시오.

기존 커넥터와의 차이점

전환하기 전에 다음 사항을 계획하십시오.

  • 전송자 ID. 2026년 4월 개발자 블로그 업데이트에 따르면 웹후크 게시물에서는 봇 아이콘과 이름을 사용자 지정할 수 없습니다. 메시지는 기본 Workflows 봇 ID로 표시됩니다.
  • 소유권. Learn에 따르면 워크플로는 팀이나 채널이 아니라 소유자에게 연결됩니다. 소유자가 떠났고 공동 소유자가 없으면 흐름이 고아 상태가 될 수 있습니다. 전체 제어 권한을 가진 공동 소유자를 추가하십시오.
  • 제한. Learn 참조 문서에는 트리거의 동시 인바운드 호출 약 1,000개와 채팅 또는 채널에 적응형 카드 게시 작업의 28KB 제한이 명시되어 있습니다. 이보다 큰 페이로드는 "Request Entity too large" 오류를 반환합니다.
  • 비공개 채널. 자료마다 내용이 다릅니다. 개발자 블로그에서는 Workflows 앱의 비공개 채널 선택 기능이 2026년 4월 20일까지 전면 출시될 예정이라고 밝혔습니다. 한 Learn 페이지는 Workflows 웹후크가 비공개 채널을 지원한다고 설명하고, 다른 Learn 페이지는 비공개 채널 지원이 개발 중이라고 설명합니다. Microsoft Teams 커넥터 참조 문서에는 현재 비공개 채널에 메시지나 카드를 게시하는 기능이 지원되지 않는다고 나와 있습니다. 의존하기 전에 대상 채널을 반드시 테스트하십시오.

흔한 실수

  • 채널만 이전하고 전송 시스템의 URL 변경을 잊는 경우.
  • 워크플로의 소유자를 한 사람만 남겨 두는 경우.
  • Anyone으로 설정된 트리거에 토큰을 보내는 경우.
  • MessageCard 버튼을 그대로 두고 콜백이 작동하기를 기대하는 경우.
  • 기존 봇 이름과 아이콘이 그대로 유지될 것이라고 가정하는 경우.

관련 자료

데이터 원본

쇼 팔로우하기Apple PodcastsSpotify

FAQ

Teams 커넥터는 아직 작동하나요?

아닙니다. Microsoft Learn에 따르면 커넥터 기반 수신 웹후크를 포함한 Teams의 Office 365 커넥터는 2026년 5월에 지원이 종료되었습니다. Microsoft 365 개발자 블로그는 최종 배포 기간을 2026년 5월 18일부터 5월 22일까지로 제시했으며, 그 전에 웹후크를 마이그레이션해야 한다고 밝혔습니다.

Teams의 Incoming Webhook 커넥터를 대체하는 것은 무엇인가요?

Power Automate에서 실행되는 Workflows 앱입니다. Microsoft Learn에 따르면 웹후크 요청을 받을 때 채팅 또는 채널에 게시하는 미리 정의된 템플릿을 사용하거나, "Teams 웹후크 요청이 수신되는 경우" 트리거로 흐름을 처음부터 만들 수 있습니다.

모니터링 도구나 스크립트에 새 URL이 필요한가요?

네, 필요합니다. 워크플로에는 고유한 트리거 URL이 있으며, 커넥터 참조 문서에서는 이 트리거가 해당 엔드포인트로 보내는 POST 요청으로 시작된다고 설명합니다. 제가 확인한 페이지에는 URL이 어디에 표시되는지 나와 있지 않으므로, Power Automate에서 워크플로 트리거를 열어 URL을 복사하십시오. 그다음 POST 요청을 보내는 시스템에 붙여 넣으면 됩니다.

Workflows 웹후크에서 내 시스템을 다시 호출하는 버튼을 게시할 수 있나요?

MessageCard로는 불가능합니다. 개발자 블로그에 따르면 MessageCard는 콘텐츠를 렌더링하지만 HttpPost 작업 버튼은 지원하지 않습니다. Microsoft는 대화형 요소에는 Adaptive Cards를 사용하라고 안내하며, Learn에서는 응답을 처리하도록 워크플로를 구성해야 한다고 설명합니다.

누가 워크플로 웹후크로 요청을 보낼 수 있나요?

직접 선택할 수 있습니다. Learn의 Microsoft Teams 커넥터 참조 문서에는 세 가지 옵션이 나와 있습니다. 누구나, 테넌트의 모든 사용자, 또는 테넌트의 특정 사용자입니다. 테넌트 관련 옵션의 경우 요청에 인증 토큰이 포함되어야 합니다. 누구나 옵션을 선택한 경우에는 토큰을 보내면 안 됩니다.

Entities in this article

이 글의 주제:

Microsoft Teams – Microsoft의 공동 작업 도구 Power Automate – Microsoft의 로우코드 도구 커넥터 – 개념 Adaptive Cards – 제품

Related articles

Microsoft Teams에 관한 다른 글:

RSS