Microsoft Teams 웹 트리거
- 최종 업데이트2026/01/13
Microsoft Teams 웹 트리거
Microsoft Teams 웹 트리거를 사용하면 Microsoft Teams 채팅 또는 채널에서 발생하는 이벤트를 기반으로 작업을 자동화할 수 있습니다. 웹 트리거는 Microsoft Teams에서 발생하는 특정 이벤트를 감지합니다. 이벤트가 발생하면 트리거에서 구성된 작업을 시작합니다.
개요
Microsoft Teams 웹 트리거를 사용하면 Microsoft Teams에서 직접 채팅 메시지, 그룹 채팅 메시지, 채널 멤버십 변경과 같은 이벤트를 기반으로 트리거를 생성할 수 있습니다. 트리거를 사용하여 Microsoft Teams에서 이벤트가 발생하자마자 워크플로를 실행할 수 있으므로 중요한 커뮤니케이션에 대한 수동 모니터링 및 대응 시간을 줄일 수 있습니다. Microsoft Teams 웹 트리거에서 제공되는 옵션을 활용하면 티켓 할당, 모든 채팅 메시지에서 정보 추출, 이해관계자에게 알림을 보내기 위한 이메일 스레드 시작 등 다양한 유스케이스에 맞는 트리거 기반 자동화를 구현할 수 있습니다.
Microsoft Teams 애플리케이션에서 이벤트가 발생하고 해당 이벤트를 기반으로 자동화가 시작되는 트리거 사이의 지연 시간은 30초 미만입니다. 세션으로의 이벤트 전송이 실패하면, 트리거는 자동으로 이벤트를 다시 가져오려고 시도합니다.
Microsoft Teams 웹 트리거에는 키워드를 사용해 메시지를 필터링하는 옵션이 있습니다. 필터 옵션을 사용하면 자동화가 특정 키워드에 따라 트리거되어야 하는 유스케이스에 맞게 트리거를 구성할 수 있습니다. 이 옵션은 지정된 키워드를 포함한 메시지로 이벤트 응답을 제한합니다.
트리거는 Microsoft 서버로부터 이벤트 응답 페이로드 정보를 구조화된 JSON 형식으로 캡처합니다. 이 페이로드에는 데이터를 검증할 수 있도록 하는 인증 정보가 포함됩니다. 응답 페이로드는 감사 로그 페이지에서 키-값 쌍 형태로 확인할 수 있으며, 이 키-값 쌍 정보는 세션 내 후속 작업의 입력값으로 사용할 수 있습니다.
인증
Microsoft Teams 웹 트리거는 OAuth를 사용하여 Microsoft 365 계정에 대한 연결을 인증합니다. OAuth 연결을 Microsoft Teams에 대한 Microsoft Entra에 적용 가능한 매개변수로 설정합니다. OAuth 연결 설정에 대한 자세한 내용은 OAuth 연결 생성 항목을 참조하십시오.
Microsoft Teams 웹 트리거는 Microsoft Azure 인증서를 사용하여 Microsoft 계정 구독을 인증하고 Microsoft 서버에서 들어오는 데이터를 해독합니다. Microsoft Azure 포털에 로그인하고 자격증명을 생성합니다. Microsoft Azure 포털에서 자격증명을 생성하는 방법에 대한 자세한 내용은 Microsoft Learn 포털의 Certificate creation methods 항목을 참조하십시오. 자격증명 관리에 대한 자세한 내용은 Managing encryption keys 항목을 참조하십시오.
Credential Vault에서 생성한 자격증명을 추가하도록 하십시오. 다음 단계를 수행하여 Credential Vault에 자격증명 데이터를 추가합니다.
- 텍스트 편집기에서 자격증명 파일을 엽니다.
- 자격증명 파일의 전체 내용을 복사합니다.
- Control Room에 관리자로 로그인합니다.
- 으로 이동한 후 자격증명 생성을 클릭합니다.
- 자격증명에 적절한 자격증명 이름 및 설명을 입력합니다.
- 속성 섹션의 속성 이름에 적절한 이름을 입력합니다.
- 표준을 선택한 다음, 속성의 입력 섹션에 있는 값 필드에 인증서 내용을 붙여넣습니다.
- 자격증명 생성을 클릭하여 자격증명 데이터를 Credential Vault에 저장합니다.
지원되는 이벤트
다음 이벤트는 개인 채팅 및 팀 채팅 트리거 구성 모두에서 지원됩니다.
| 이벤트 | 설명 |
|---|---|
| 채팅 메시지가 추가되는 경우 | 새 메시지가 수신되는 경우. |
| 채팅 메시지가 업데이트되는 경우 | 기존 채팅 메시지가 수정되는 경우. |
| 채팅 메시지가 삭제된 경우 | 기존 채팅 메시지가 삭제된 경우. |
팀 멤버십 트리거 구성에서는 다음 이벤트가 지원됩니다.
| 이벤트 | 설명 |
|---|---|
| 새 팀원이 추가되는 경우 | 팀 소유자가 선택한 팀에 새 구성원을 추가하는 경우. |
| 팀원이 업데이트된 경우 | 팀 소유자가 기존 팀원 정보를 수정하는 경우. |
| 팀원이 제거된 경우 | 팀 소유자가 선택한 팀에서 팀원을 제거하는 경우. |
선행조건
다음 선행 조건이 충족되었는지 확인하십시오.
- Bot Creator 또는 시민 개발자 라이선스.
- 이벤트 트리거 및 내 Bot 보기 권한.
- 자동화가 위치한 폴더의 체크인 및 체크아웃 권한.
- Microsoft 365 계정용 활성 OAuth 연결.
- Microsoft Azure 인증서.
설정
Microsoft Teams 웹 트리거에 대해 다음 설정을 사용할 수 있습니다.
- Control Room OAuth 연결
- 선택 옵션을 사용하고, OAuth 연결 선택 모달의 안내에 따라 OAuth 연결을 선택합니다. OAuth는 Control Room과 Microsoft 365 계정 간의 연결을 인증합니다.
- 채팅
- 이 옵션을 사용하여 개별 채팅을 기반으로 트리거를 구성합니다. 채팅 이름은 수신자의 표시 이름이 아니라 채팅 수신자의 이메일 ID를 기준으로 작동합니다.
- 이벤트 수신: 트리거가 수신해야 하는 이벤트 유형을 지정합니다.
- 채팅 이름: 채팅 이름을 입력합니다. 채팅 이름 가져오기 버튼을 사용하여 채팅 모달에서 채팅을 선택할 수도 있습니다.
- 필터: 확인란을 활성화하고 메시지를 필터링할 키워드를 입력하십시오.
- Teams 및 채널
-
팀 채팅: 팀 채팅 옵션을 사용하여 Teams 채널에 게시된 메시지를 기준으로 트리거를 구성합니다. 이 옵션에 대해 사용할 수 있는 설정은 다음과 같습니다.
- 하나 이상의 이벤트 선택: 트리거가 수신해야 하는 하나 이상의 이벤트 유형을 지정합니다.
- 팀 이름: 팀 이름을 입력합니다. Teams 모달을 사용하여 팀을 선택하려면 팀 이름 선택 버튼을 사용할 수도 있습니다.
- 채널 이름: 채널 이름을 입력합니다. 채널 모달에서 채널 이름 선택을 사용해 팀을 선택할 수도 있습니다.
- 필터: 확인란을 활성화하고 메시지를 필터링할 키워드를 입력하십시오.
-
팀 멤버십: 팀 멤버십 옵션을 사용하면 팀 내 멤버십 변경에 따라 트리거를 구성할 수 있습니다. 이 옵션에 대해 사용할 수 있는 설정은 다음과 같습니다.
- 구성원 옵션: 트리거가 수신해야 하는 하나 이상의 이벤트 유형을 지정합니다.
- 팀 이름: 팀 이름을 입력합니다. Teams 모달을 사용하여 팀을 선택하려면 팀 이름 선택 버튼을 사용할 수도 있습니다.
- 인증서
-
인증 옵션을 사용하여 인증 및 암호화를 위해 인증서를 선택합니다.
- 자격증명: 선택 옵션을 사용하고 자격증명 선택 모달의 프롬프트에 따라 Credential Vault에 저장된 Microsoft Azure 인증서를 선택합니다.
- 안전하지 않은 문자열: 안전하지 않은 문자열 옵션을 사용하여 인증서 파일의 내용을 입력란에 직접 입력합니다.
- 응답
- 응답 옵션을 사용하여 트리거 응답 데이터를 기록 변수에 저장합니다. 새 변수를 생성하거나 기존 변수를 선택하여 이 응답 데이터를 저장할 수 있습니다.
감사 로그에서 트리거 응답 데이터 읽기
트리거 응답 데이터에는 변경이 발생한 이벤트 기록의 모든 정보가 포함되어 있습니다. 이 응답 데이터는 키-값 쌍 형식으로 저장됩니다. 이 데이터를 추출하여 자동화 내의 다른 작업에 입력값으로 사용할 수 있습니다. Bot이 실행을 마치면 트리거 데이터 정보가 트리거로 실행된 Bot 이벤트 유형으로 감사 로그에 기록됩니다.