Microsoft 팀
Microsoft Teams를 사용하면 Microsoft 365를 사용하여 팀 작업 영역에서 모든 콘텐츠, 도구 및 대화를 가져올 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| Power Automate (파워 오토메이트) | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL | https://support.microsoft.com/en-us/contactus |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://products.office.com/microsoft-teams/group-chat-software |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/ |
| 카테고리 | 합작; 통신 |
작업의 알려진 문제 및 제한 사항
| 간단한 설명 | Operations | 긴 설명 |
|---|---|---|
| 메시지 크기 제한 |
적응형 카드를 게시하고 응답을 기다립니다. 채팅 또는 채널에 적응형 카드 게시 채팅 또는 채널에 메시지 게시 채널에서 메시지와 함께 회신 채널에서 적응형 카드로 회신 채팅 또는 채널에서 적응형 카드 업데이트 |
작업이 메시지를 게시하면 메시지 크기 제한은 약 28KB입니다. 이 제한에는 텍스트, 이미지, 링크, 테이블, 멘션 등과 같은 모든 HTML 요소가 포함됩니다. 메시지 크기가 28KB를 초과하면 "엔터티 요청이 너무 큽니다"라는 오류와 함께 작업이 실패합니다. |
| 게스트 사용자를 팀 소유자로 설정 | 팀에 구성원 추가 | 팀에 구성원을 추가할 때 게스트 사용자를 팀 소유자로 설정할 수 있습니다. |
| Exchange Online 사서함 필요 | Teams 모임 만들기 | Teams 모임을 만들고 표준 시간대를 선택하려는 경우 이 작업을 수행하려면 Exchange 온라인 사서함이 필요합니다. |
| 채팅당 최대 사용자 수 | 채팅 만들기 | 채팅을 만들 때 이 작업은 채팅당 최대 20명의 사용자를 처리할 수 있지만 게스트 사용자를 지원하지는 않습니다. |
| 워크플로 앱 필요 |
적응형 카드를 게시하고 응답을 기다립니다. 채팅 또는 채널에 적응형 카드 게시 채팅 또는 채널에 메시지 게시 채널에서 메시지와 함께 회신 채널에서 적응형 카드로 회신 채팅 또는 채널에서 적응형 카드 업데이트 |
이러한 작업을 수행하려면 워크플로(이전의 Power Automate) 앱 가용성과 Teams 관리 센터의 "허용" 상태로 앱으로 설정해야 합니다. |
| 누군가가 적응형 카드에 응답할 때 트리거와 결합할 수 없음 | 채팅 또는 채널에 적응형 카드 게시 | "트리거 + 수신기" 워크플로에서 이 트리거를 사용하면 카드를 제출할 때 "문제가 발생했습니다. 다시 시도하세요" 오류가 발생할 수 있습니다. 이 오류는 트리거 흐름(채팅 또는 채널에 적응형 카드를 게시함)이 카드를 게시한 후 호출 응답을 처리하지 않기 때문에 발생합니다. 대신 수신기 흐름은 호출 응답 이벤트를 캡처하고 처리를 계속하도록 설계되었습니다. 그러나 트리거 흐름은 응답을 처리하지 않으므로 오류를 반환합니다. 사후 적응형 카드를 사용하고 대안으로 응답을 기다립니다. |
트리거의 알려진 문제 및 제한 사항
| 간단한 설명 | Operations | 긴 설명 |
|---|---|---|
| 흐름당 사용자만 지원합니다. | 새 채팅 메시지가 추가된 경우 | Teams에 참가하는 모든 채팅에 새 채팅 메시지가 게시되면 트리거는 흐름당 한 명의 사용자만 지원할 수 있습니다. |
| 단일 단어만 지원합니다. | 키워드가 언급되는 경우 | 트리거는 한 단어보다 긴 구에 대해 실행되지 않습니다. |
| 모든 메시지 관련 데이터에 대해 발생 | 키워드가 언급되는 경우 | 이 데이터에는 메시지 보낸 사람 및 메시지를 보낸 시간이 포함된 텍스트가 포함됩니다. |
| 채널에 추가된 루트 메시지에 대해서만 발생 | 새 채널 메시지가 추가되는 경우 | Teams의 채널에 새 메시지가 게시되면 트리거가 기존 채널 메시지에 대한 회신에 대해 발생하지 않습니다. |
| 기본 환경에서만 작동합니다. |
선택한 메시지의 경우 작성 상자에서(V2) 누군가가 적응형 카드에 응답하는 경우 |
이러한 트리거는 기본 환경에서만 작동합니다. |
| 게스트 또는 외부 사용자에 대해 작동하지 않음 |
선택한 메시지의 경우 누군가가 적응형 카드에 응답하는 경우 |
이 트리거는 팀의 게스트 또는 외부 사용자에게는 작동하지 않습니다. |
| 폴링 간격이 3분입니다. |
새 채널 메시지가 추가되는 경우 채널 메시지에 언급된 경우 |
이러한 트리거는 3분 폴링 간격을 사용합니다. |
| 폴링 간격이 5분입니다. |
새 팀 구성원이 추가되는 경우 새 팀 구성원이 제거된 경우 |
이러한 트리거는 기본 API의 제한으로 인해 5분 폴링 간격을 사용합니다. 이로 인해 트리거가 동일한 이벤트에 대해 여러 번 실행될 수 있습니다. |
| 숨겨진 멤버가 있는 통합 그룹에서 작동하지 않음 |
새 팀 구성원이 추가되는 경우 새 팀 구성원이 제거된 경우 |
이러한 트리거는 숨겨진 멤버가 있는 통합 그룹에서 작동하지 않습니다. |
| Power Automate Actions 앱 필요 | 선택한 메시지의 경우 | Power Automate에서 이 트리거를 사용하려면 Power Automate Actions 앱(앱 ID: 00001016-de05-492e-9106-4828fc8a8687)을 차단 해제해야 합니다. 관리자 계정을 사용하여 Teams 관리 센터에서 앱이 사용하도록 설정되어 있는지 확인합니다. |
| Microsoft Cloud for Sovereignty에서 지원되지 않음 |
선택한 메시지의 경우 작성 상자에서 |
이러한 트리거는 GCC, GCCH 및 DoD와 같은 소버린 클라우드에서 지원되지 않습니다. |
일반적인 알려진 문제 및 제한 사항
- Teams Conector를 사용하려면 이러한 구독 중 하나를 사용하도록 설정해야 합니다.
- 현재 개인 채널에 메시지 또는 적응형 카드를 게시하는 것은 지원되지 않습니다.
- Power Virtual Agents를 사용하여 메시지 또는 카드를 게시하려면 받는 사람이 Microsoft Teams에 봇을 설치해야 합니다. 자세한 내용은 Microsoft Teams에서 사용자에게 자동 관리 메시지 보내기를 참조하세요.
- 단일 메시지는 최대 20명의 사용자와 20개의 태그만 사용할 수 @mention 있습니다.
Microsoft Teams 웹후크
Teams 웹후크 요청이 수신되는 경우
작업 ID: TeamsIncomingWebhookTrigger
이 트리거를 사용하면 트리거에 의해 노출되는 엔드포인트에 대한 POST 요청을 수행하여 흐름을 시작할 수 있습니다. 요청 본문에 있는 적응형 카드 배열을 트리거에 보내 흐름의 이후 작업에 사용할 수 있습니다. 이 트리거는 POST 요청만 지원하며 GET 요청을 지원하지 않습니다.
사용되지 않는 Office Webhook와 달리 Teams 웹후크 요청이 수신되면 사용자는 누구, 테넌트에 있는 사용자 또는 테넌트에 있는 특정 하위 집합의 사용자만 트리거를 호출할 수 있는지 여부를 지정할 수 있습니다. 이 트리거는 사용되지 않는 Office 웹후크와 달리 실행 가능한 메시지도 지원하지 않습니다.
흐름을 저장할 때 트리거의 콜백 URL이 표시됩니다. Power Automate 또는 Teams의 Power Automate 디자이너에서 만든 흐름을 편집하여 콜백 URL에 액세스할 수도 있습니다.
적응형 카드를 작성하는 방법에 대한 자세한 내용은 적응 형 카드를 Microsoft Teams에 게시하는 흐름 만들기와 적응형 카드 스키마 모범 사례 및 적응형 카드 디자이너를 참조하세요.
요청 본문 스키마
요청 본문
| 이름 | Key | 필수 | 유형 | Description |
|---|---|---|---|---|
| type | type | yes | 문자열 | 값은 항상 "message"여야 합니다. |
| attachments | attachments | yes | 개체 배열 | 적응형 카드 항목 개체의 배열입니다. 개체 스키 마는 아래 AdaptiveCardItemSchema 를 참조하세요. |
AdaptiveCardItemSchema
| 이름 | Key | 필수 | 유형 | Description |
|---|---|---|---|---|
| 콘텐츠 유형 | 콘텐츠 유형 | yes | 문자열 | 값은 항상 "application/vnd.microsoft.card.adaptive"여야 합니다. |
| 콘텐츠URL | 콘텐츠URL | yes | 문자열 | 값은 항상 null이어야 합니다. |
| 내용 | 내용 | yes | 객체 | JSON 형식의 적응형 카드 개체입니다. 샘플 및 템플릿은 다음을 참조하세요. https://adaptivecards.io/samples |
요청 본문 예제
{
"type":"message",
"attachments":[
{
"contentType":"application/vnd.microsoft.card.adaptive",
"contentUrl":null,
"content":{
"$schema":"http://adaptivecards.io/schemas/adaptive-card.json",
"type":"AdaptiveCard",
"version":"1.2",
"body":[
{
"type": "TextBlock",
"text": "For Samples and Templates, see [https://adaptivecards.io/samples](https://adaptivecards.io/samples)"
}
]
}
}
]
}
적응형 카드 JSON 파일의 속성은 다음과 같습니다.
-
"type"필드는 여야"message"합니다. - 배열에는
"attachments"카드 개체 집합이 포함되어 있습니다. -
"contentType"필드는 적응형 카드 유형으로 설정해야 합니다. -
"content"개체는 JSON으로 서식이 지정된 카드입니다.
Postman을 사용하여 적응형 카드를 테스트합니다.
- Postman을 사용하여 적응형 카드를 테스트하여 들어오는 웹후크를 설정하기 위해 만든 URL에 POST 요청을 보냅니다.
- 요청 본문에 JSON 파일을 붙여넣고 Teams에서 적응형 카드 메시지를 봅니다.
팁 (조언)
적응형 카드 코드 샘플 및 템플릿을 사용하여 POST 요청 본문을 테스트합니다.
요청 보내기 예제
var adaptiveCardJson = @"{
""type"": ""message"",
""attachments"": [
{
""contentType"": ""application/vnd.microsoft.card.adaptive"",
""content"": {
""type"": ""AdaptiveCard"",
""body"": [
{
""type"": ""TextBlock"",
""text"": ""Message Text""
}
],
""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
""version"": ""1.2""
}
}
]
}";
var webhookUrl = "Retrieve this from the url of the trigger, e.g. https://xxxxx.logic.azure.com:443/xxxxxxxxx";
var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);
매개 변수
| 이름 | Key | 필수 | 유형 | Description |
|---|---|---|---|---|
| triggerAuthenticationType | triggerAuthenticationType | 문자열 | 모든 사용자, 테넌트 내 사용자 또는 테넌트 내의 특정 사용자만 흐름을 트리거할 수 있는지 여부입니다. | |
| triggerAllowedUsers | triggerAllowedUsers | 문자열 | 흐름을 트리거할 수 있는 사용자 목록입니다. triggerAuthenticationType이 "내 테넌트에 있는 특정 사용자"로 설정된 경우에만 사용됩니다. |
- "모든 사용자" 인증 옵션을 선택한 경우 인증 토큰 헤더를 전달하지 마세요. 그렇지 않으면 트리거에 대한 POST 요청이 실패합니다.
- "내 테넌트에 있는 모든 사용자" 또는 "내 테넌트에 있는 특정 사용자" 인증 옵션을 선택하는 경우 요청에서 인증 토큰을 Teams 웹후크 요청이 수신될 때 트리거에 전달해야 합니다.
- 다음 문서에서 필요한 클레임에 대한 자세한 정보를 찾을 수 있습니다. HTTP 요청 트리거에 대한 OAuth 인증 추가
반품
| 이름 | 경로 | 유형 | Description |
|---|---|---|---|
| body | body | 객체 | 출력은 트리거로 전송된 요청 본문과 동일합니다. 출력 또는 요청 본문 스키마의 예는 위의 예제를 참조하세요. |
제한 한도
- Power Automate 성능 프로필은 "Teams 웹후크 요청을 받은 경우" 트리거의 제한 제한을 결정합니다. 성능 프로필에서 성능 프로필을 확인할 수 있습니다.
- 이러한 제한은 런타임 엔드포인트 요청 제한과 동일합니다.
- 흐름 제한 제한에 대한 일반적인 내용은 자동화, 예약 및 인스턴트 흐름의 제한을 참조하세요.
| 이름 | 한계 | 비고 |
|---|---|---|
| 동시 인바운드 호출 | 약 1,000 | 필요에 따라 동시 요청 수를 줄이거나 기간을 단축할 수 있습니다. |
| 5분당 통화 읽기 | 6,000: 낮음; 다른 모든 사용자에 대한 60,000 | 이 제한은 클라우드 흐름의 실행 기록에서 원시 입력 및 출력을 가져오는 호출에 적용됩니다. 필요에 따라 둘 이상의 흐름에 워크로드를 분산할 수 있습니다. |
| 5분당 호출 호출 | 낮음의 경우 4,500; 45,000 | 필요에 따라 둘 이상의 흐름에 워크로드를 분산할 수 있습니다. |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| Microsoft Teams 자격 증명(Teams GCC High) | Microsoft Teams 자격 증명(Teams GCC High)을 사용하여 로그인합니다. | Azure Government만 | 공유할 수 없음 |
| Microsoft Teams 자격 증명(Teams 공개/Teams GCC) | Microsoft Teams 자격 증명(Teams 공개/Teams GCC)을 사용하여 로그인합니다. | Azure Government만 | 공유할 수 없음 |
| 기본값 | 자격 증명으로 로그인합니다. | Azure Government를 제외한 모든 지역 | 공유할 수 없음 |
Microsoft Teams 자격 증명(Teams GCC High)
인증 ID: oauthGccHigh
적용 가능: Azure Government만 해당
Microsoft Teams 자격 증명(Teams GCC High)을 사용하여 로그인합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
Microsoft Teams 자격 증명(Teams 공개/Teams GCC)
인증 ID: oauthPublic
적용 가능: Azure Government만 해당
Microsoft Teams 자격 증명(Teams 공개/Teams GCC)을 사용하여 로그인합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
기본값
적용 가능: Azure Government를 제외한 모든 지역
자격 증명으로 로그인합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
| 트리거 폴링 빈도 | 1 | 600초 |
| 연결당 비 가져오기 요청(목록 채팅, 피드 알림 게시, 적응형 카드를 흐름 봇으로 게시 및 기타 흐름 봇 작업의 경우) | 25 | 300초 |
| 연결당 비 가져오기 요청(다른 모든 작업) | 300 | 300초 |
동작
| Microsoft Graph HTTP 요청 보내기 |
Microsoft Teams 엔드포인트에 대해 호출할 Microsoft Graph REST API 요청을 생성합니다. 이러한 세그먼트는 지원됩니다. 첫 번째 세그먼트: /teams, /me, /users 2번째 세그먼트: 채널, 채팅, installedApps, 메시지, pinnedMessages. 더 알아보세요: https://docs.microsoft.com/en-us/graph/use-the-api |
| Teams 모임 만들기 |
Microsoft Teams에서 온라인으로 모임에 참가하기 위한 초대의 맨 아래에 링크가 있는 모임을 만듭니다. |
| Teams 사용자에게 적응형 카드를 게시하고 응답을 기다립니다.[사용되지 않음] |
대기 흐름을 계속하기 위한 작업이 포함된 Teams 사용자에게 메시지를 보내는 프로세스를 쉽게 자동화할 수 있습니다. |
| Teams 채널에 적응형 카드를 게시하고 응답을 기다립니다.[사용되지 않음] |
대기 흐름을 계속하기 위한 작업이 포함된 Teams 채널에 메시지를 보내는 프로세스를 쉽게 자동화할 수 있습니다. |
| 교대 근무: Open Shift 업데이트 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 업데이트를 사용하세요.
|
| 교대 근무: Open Shift 요청 거절[사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 요청 거절을 사용하세요.
|
| 교대 근무: Open Shift 요청 승인 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 요청 승인을 사용하세요.
|
| 교대 근무: 교대 근무 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Shift 가져오기를 사용하세요.
|
| 교대 근무: 교대 근무 삭제 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Shift 삭제를 사용하세요.
|
| 교대 근무: 모든 Open Shift 요청 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 Open Shift 요청을 나열하세요.
|
| 교대 근무: 모든 교대 근무 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 교대 근무 목록을 사용하세요.
|
| 교대 근무: 모든 스왑 교대 근무 요청 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 스왑 시프트 요청을 나열하세요.
|
| 교대 근무: 모든 시간 끄기 이유 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀에서 모든 시간 제한 이유 목록을 사용하세요.
|
| 교대 근무: 모든 시간 제한 요청 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 시간 제한 요청 목록을 사용하세요.
|
| 교대 근무: 모든 일정 그룹 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 일정 그룹 목록을 사용하세요.
|
| 교대 근무: 모든 제품 교대 근무 요청 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 제품 교대 근무 요청을 나열 하세요.
|
| 교대 근무: 새 Open Shift 만들기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 새 Open Shift 만들기를 사용하세요.
|
| 교대 근무: 스왑 교대 근무 요청 거절 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 스왑 시프트 요청 거절을 사용하세요.
|
| 교대 근무: 스왑 교대 근무 요청 승인 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 교환 교대 근무 요청 승인을 사용하세요.
|
| 교대 근무: 시간 제한 요청 거절[사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 시간 해제 요청 거절을 사용하세요.
|
| 교대 근무: 시간 제한 요청 승인 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 시간 제한 요청 승인을 사용하세요.
|
| 교대 근무: 열려 있는 모든 교대 근무 나열 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 Open Shifts 목록을 사용하세요.
|
| 교대 근무: 열린 교대 근무 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 가져오기를 사용하세요.
|
| 교대 근무: 열린 교대 근무 삭제 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 삭제를 사용하세요.
|
| 교대 근무: 일정 그룹 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 예약 그룹 가져오기를 사용하세요.
|
| 교대 근무: 일정 세부 정보 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 일정의 세부 정보 가져오기 를 사용하세요.
|
| 교대 근무: 제안 교대 근무 요청 승인 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 제안 시프트 요청 승인을 사용하세요.
|
| 교대 근무: 제안 시프트 요청 거절[사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 제안 시프트 요청 거절을 사용하세요.
|
| 메시지 가져오기 |
특정 팀의 채널에서 메시지를 가져옵니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 메시지 게시(V2) [사용되지 않음] |
특정 팀의 채널에 메시지를 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 메시지 게시(V3) [사용되지 않음] |
특정 팀의 채널에 메시지를 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 메시지 게시 [사용되지 않음] |
특정 팀의 채널에 메시지를 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 메시지 세부 정보 가져오기 |
채팅 또는 채널에서 메시지의 세부 정보를 가져옵니다. |
| 메시지에 회신 게시(V2) [사용되지 않음] |
특정 팀의 채널에서 메시지에 회신을 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 메시지에 회신 게시[사용되지 않음] |
특정 팀의 채널에서 메시지에 회신을 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 멤버 나열 |
그룹 채팅 또는 채널의 직접 구성원 나열 |
| 모든 채널 나열 |
팀과 공유되는 채널을 포함하여 특정 팀의 모든 채널을 나열합니다. |
| 사용자 고유의 적응형 카드를 Flow 봇으로 사용자에게 게시[사용되지 않음] |
JSON 카드 정의를 추가하여 Teams 사용자에 대한 사용자 지정 메시지를 만듭니다. 메시지에는 이미지, 그래프, 텍스트 등이 포함될 수 있습니다. |
| 사용자 고유의 적응형 카드를 흐름 봇으로 채널에 게시[사용되지 않음] |
JSON 카드 정의를 추가하여 Teams 채널에 대한 사용자 지정 게시물을 만듭니다. 게시물에는 이미지, 그래프, 텍스트 등이 포함될 수 있습니다. |
| 사용자에 대한 @mention 토큰 가져오기 |
사용자에게 메시지 또는 적응형 카드에 삽입할 수 있는 토큰을 @mention 만듭니다. |
| 사용자에게 Flow 봇으로 메시지 게시[사용되지 않음] |
Teams에서 다른 사람에게 메시지를 보내는 프로세스를 쉽게 자동화할 수 있습니다. |
| 사용자에게 Flow 봇으로 선택한 옵션 게시 |
Microsoft Teams 사용자에게 흐름이 계속되기 전에 응답해야 하는 옵션 집합을 보냅니다. 이 작업은 사용자가 옵션에 응답할 때까지 흐름을 일시 중지합니다. |
| 연결된 팀 나열 |
직접 구성원이거나 팀 내에서 호스트되는 공유 채널의 구성원인 모든 팀을 나열합니다. |
| 적응형 카드를 게시하고 응답을 기다립니다. |
적응형 카드를 채팅 또는 채널에 게시하고 사용자의 응답을 기다립니다. 그러면 사용자가 응답할 때까지 흐름이 일시 중지됩니다. |
| 참가한 팀 나열 |
사용자가 소속된 Microsoft Teams의 모든 팀을 나열합니다. |
| 채널 나열 |
특정 팀의 모든 채널을 나열합니다. |
| 채널 만들기 |
지정된 팀 내에서 새 채널 만들기 |
| 채널 메시지의 회신 나열 |
특정 팀의 채널에 있는 메시지에 대한 회신을 나열합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 채널에 Flow 봇으로 메시지 게시[사용되지 않음] |
Teams 채널에 메시지를 게시하는 프로세스를 쉽게 자동화할 수 있습니다. |
| 채널에서 메시지와 함께 회신 |
채널의 메시지에 메시지와 함께 회신 |
| 채널에서 적응형 카드로 회신 |
채널 메시지에 적응형 카드로 회신 |
| 채팅 나열 |
소속된 최근 채팅을 나열합니다. |
| 채팅 또는 채널에 메시지 게시 |
채팅 또는 채널에 메시지 게시 |
| 채팅 또는 채널에서 적응형 카드 업데이트 |
기존 적응형 카드를 업데이트합니다. |
| 채팅 또는 채널의 우편 카드 |
채팅 또는 채널에 카드 게시 |
| 채팅 만들기 |
하나 또는 그룹 채팅에 하나를 만듭니다. |
| 팀 가져오기 |
Microsoft Teams의 팀에 대한 세부 정보를 가져옵니다. |
| 팀 만들기 |
Microsoft Teams에서 새 팀 만들기 |
| 팀 태그 삭제 |
팀에서 태그를 삭제합니다. |
| 팀 태그에 대한 @mention 토큰 가져오기 |
채널에서 팀 태그로 사용자로 보낸 메시지 또는 적응형 카드에 삽입할 @mention 수 있는 토큰을 만듭니다. |
| 팀 태그에 멤버 추가 |
팀 태그에 사용자 추가 |
| 팀 태그에서 멤버 삭제 |
팀 태그에서 멤버를 삭제합니다. |
| 팀 태그의 멤버 나열 |
팀 태그의 멤버를 나열합니다. |
| 팀에 구성원 추가 |
Microsoft Teams의 팀에 구성원 추가 |
| 팀에 대한 태그 만들기 |
팀에서 태그를 만듭니다. |
| 팀의 모든 태그 나열 |
팀의 태그를 나열합니다. |
| 팀의 특정 채널에 대한 세부 정보 가져오기 |
채널 세부 정보 가져오기 |
| 피드 알림 게시 |
채팅 또는 팀에 연결하는 사용자의 활동 피드에 알림을 게시합니다. |
Microsoft Graph HTTP 요청 보내기
Microsoft Teams 엔드포인트에 대해 호출할 Microsoft Graph REST API 요청을 생성합니다. 이러한 세그먼트는 지원됩니다. 첫 번째 세그먼트: /teams, /me, /users 2번째 세그먼트: 채널, 채팅, installedApps, 메시지, pinnedMessages. 더 알아보세요: https://docs.microsoft.com/en-us/graph/use-the-api
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
전체 또는 상대 URI입니다. 예: |
|
메서드
|
Method | True | string |
HTTP 메서드(기본값: GET) |
|
몸
|
Body | binary |
요청 본문 콘텐츠 |
|
|
콘텐츠 유형 (Content-Type)
|
ContentType | string |
본문의 콘텐츠 형식 헤더(기본값: application/json) |
|
|
CustomHeader1
|
CustomHeader1 | string |
사용자 지정 헤더 1. 형식으로 지정: header-name: header-value |
|
|
CustomHeader2
|
CustomHeader2 | string |
사용자 지정 헤더 2. 형식으로 지정: header-name: header-value |
|
|
CustomHeader3
|
CustomHeader3 | string |
사용자 지정 헤더 3. 형식으로 지정: header-name: header-value |
|
|
CustomHeader4
|
CustomHeader4 | string |
사용자 지정 헤더 4. 형식으로 지정: header-name: header-value |
|
|
CustomHeader5
|
CustomHeader5 | string |
사용자 지정 헤더 5. 형식으로 지정: header-name: header-value |
반환
- response
- ObjectWithoutType
Teams 모임 만들기
Microsoft Teams에서 온라인으로 모임에 참가하기 위한 초대의 맨 아래에 링크가 있는 모임을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
일정 ID
|
calendarid | True | string |
값 선택 |
|
주제
|
subject | True | string |
이벤트 제목 줄의 텍스트 |
|
이벤트 메시지 콘텐츠
|
content | True | string |
이벤트의 내용 |
|
시간대
|
timeZone | True | string |
이벤트의 표준 시간대 |
|
시작 시간
|
dateTime | True | date-no-tz |
이벤트의 시작 시간(예: '2017-08-29T04:00:00') |
|
종료 시간
|
dateTime | True | date-no-tz |
이벤트의 종료 시간(예: '2017-08-29T05:00:00') |
|
필수 참석자
|
requiredAttendees |
세미콜론으로 구분된 이벤트에 필요한 참석자 |
||
|
선택적 참석자
|
optionalAttendees |
세미콜론으로 구분된 이벤트에 대한 선택적 참석자 |
||
|
display name(표시 이름)
|
displayName | string |
위치와 연결된 이름입니다. |
|
|
중요도
|
importance | string |
이벤트의 중요도: 낮음, 보통 또는 높음 |
|
|
되풀이
|
type | string |
되풀이에 대한 패턴입니다. 모임이 되풀이되는 경우 필수 |
|
|
되풀이 간격
|
interval | integer |
발생 사이의 단위 수입니다. 여기서 단위는 유형에 따라 일, 주, 월 또는 연도일 수 있습니다. 모임이 되풀이되는 경우 필수 |
|
|
요일
|
daysOfWeek | array of string |
쉼표로 구분된 주 일(예: '월요일,수요일,금요일') |
|
|
주 인덱스
|
index | string |
이벤트가 발생하는 요일을 지정합니다. 기본값은 첫 번째입니다. |
|
|
되풀이 시작 날짜
|
startDate | date |
되풀이의 시작 날짜로 YYYY-MM-DD 형식을 지정합니다. 모임이 되풀이되는 경우 필수 |
|
|
되풀이 종료 날짜
|
endDate | date |
되풀이의 종료 날짜, 형식 YYYY-MM-DD |
|
|
하루 종일 이벤트
|
isAllDay | boolean |
이벤트가 하루 종일 지속되는 경우 true로 설정 |
|
|
사전 이벤트 미리 알림 시간
|
reminderMinutesBeforeStart | integer |
미리 알림 경고가 발생하는 이벤트 시작 시간 전의 시간(분) |
|
|
미리 알림 사용
|
isReminderOn | boolean |
사용자에게 이벤트를 알리도록 경고가 설정된 경우 true로 설정 |
|
|
상태가 다음과 같이 표시됨
|
showAs | string |
이벤트 중에 표시할 상태 |
|
|
요청 응답
|
responseRequested | boolean |
이벤트가 수락될 때 발신자가 응답을 하려는 경우 true로 설정 |
반환
생성된 새 모임에 대한 응답
Teams 사용자에게 적응형 카드를 게시하고 응답을 기다립니다.[사용되지 않음]
대기 흐름을 계속하기 위한 작업이 포함된 Teams 사용자에게 메시지를 보내는 프로세스를 쉽게 자동화할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 업데이트
|
updateMessage | string |
응답에 따라 원래 카드 업데이트에 포함할 메시지 |
|
|
카드를 업데이트해야 합니다.
|
shouldUpdateCard | boolean |
다음 응답에 따라 카드를 업데이트할지 여부 |
|
|
Recipient
|
to | True | string |
이메일 주소 추가 |
|
요약
|
summary | string |
메시지 요약 |
|
|
IsAlert
|
isAlert | boolean |
메시지가 활동 피드에 표시되는 경우 |
|
|
Message
|
messageBody | True | string |
반환
Teams 채널에 적응형 카드를 게시하고 응답을 기다립니다.[사용되지 않음]
대기 흐름을 계속하기 위한 작업이 포함된 Teams 채널에 메시지를 보내는 프로세스를 쉽게 자동화할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
메시지 업데이트
|
updateMessage | string |
응답에 따라 원래 카드 업데이트에 포함할 메시지 |
|
|
카드를 업데이트해야 합니다.
|
shouldUpdateCard | boolean |
다음 응답에 따라 카드를 업데이트할지 여부 |
|
|
채널
|
channelId | True | string |
채널 ID 추가 |
|
Message
|
messageBody | True | string |
반환
교대 근무: Open Shift 업데이트 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 업데이트를 사용하세요.
일정에서 열린 교대 근무를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift ID 열기
|
openShiftId | True | string |
열린 시프트의 고유 ID입니다. |
|
그룹 ID 예약
|
schedulingGroupId | string |
그룹 ID 예약 |
|
|
표시 이름
|
displayName | string |
표시 이름 |
|
|
비고
|
notes | string |
비고 |
|
|
시작 시간부터
|
startDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Theme
|
theme | string |
Theme |
|
|
슬롯 개수 열기
|
openSlotCount | True | integer |
슬롯 개수 열기 |
|
지불
|
isPaid | boolean |
지불 |
|
|
시작 시간부터
|
startDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
코드
|
code | string |
코드 |
|
|
표시 이름
|
displayName | string |
표시 이름 |
반환
Shift 엔터티 열기
- Shift 열기
- OpenShiftResponse
교대 근무: Open Shift 요청 거절[사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 요청 거절을 사용하세요.
이 작업을 통해 관리자는 열린 교대 근무 요청을 거부할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift 변경 요청 ID 열기
|
openShiftChangeRequestId | True | string |
요청의 고유 ID |
|
관리자의 메시지
|
message | string |
요청이 거부될 때 관리자가 보낸 사람/받는 사람에게 보내는 메시지입니다. |
교대 근무: Open Shift 요청 승인 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 요청 승인을 사용하세요.
이 작업을 통해 관리자는 Open Shift 요청을 승인할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift 변경 요청 ID 열기
|
openShiftChangeRequestId | True | string |
요청의 고유 ID |
|
관리자의 메시지
|
message | string |
요청이 수락되면 관리자가 보낸 사람/받는 사람에게 보내는 메시지입니다. |
교대 근무: 교대 근무 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Shift 가져오기를 사용하세요.
이 작업은 교대 근무의 고유 ID를 사용하여 교대 근무에 대한 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift ID
|
shiftId | True | string |
교대 근무의 고유 ID입니다. |
반환
Shift 엔터티
교대 근무: 교대 근무 삭제 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Shift 삭제를 사용하세요.
이 작업은 교대 근무의 고유 ID를 사용하여 교대 근무를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift ID
|
shiftId | True | string |
교대 근무의 고유 ID입니다. |
교대 근무: 모든 Open Shift 요청 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 Open Shift 요청을 나열하세요.
이 작업은 열려 있는 모든 교대 근무 변경 요청을 일정에 따라 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
상위 개수
|
$top | integer |
검색할 총 요청 수 |
|
|
요청 상태
|
state | string |
요청 상태 필터 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Shift 변경 요청 목록 열기
|
value | array of OpenShiftChangeRequestResponse |
일정에서 열린 교대 근무 변경 요청 목록 |
교대 근무: 모든 교대 근무 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 교대 근무 목록을 사용하세요.
이 작업은 팀 구성원에게 할당된 모든 교대 근무를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
시작 시간부터
|
startTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
|
종료 시간
|
endTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
|
상위 개수
|
$top | integer |
검색할 총 교대 근무 수 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Shifts 목록
|
value | array of ShiftResponse |
일정의 교대 근무 목록 |
교대 근무: 모든 스왑 교대 근무 요청 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 스왑 시프트 요청을 나열하세요.
이 작업은 일정에 따라 모든 교환 교대 근무 요청을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
상위 개수
|
$top | integer |
검색할 총 요청 수 |
|
|
요청 상태
|
state | string |
요청 상태 필터 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Shifts 변경 요청 목록 교환
|
value | array of SwapShiftsChangeRequestResponse |
일정의 스왑 교대 근무 변경 요청 목록 |
교대 근무: 모든 시간 끄기 이유 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀에서 모든 시간 제한 이유 목록을 사용하세요.
이 작업은 팀과 연결된 시간 해제 이유 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
상위 개수
|
$top | integer |
검색해야 하는 총 시간 제한 이유 수 |
반환
시간 제한 이유 목록입니다.
- 팀과 관련된 시간 제한 이유 목록
- GetTimeOffReasonsResponse
교대 근무: 모든 시간 제한 요청 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 시간 제한 요청 목록을 사용하세요.
이 작업은 일정에 따라 모든 시간 해제 요청을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
상위 개수
|
$top | integer |
검색할 총 요청 수 |
|
|
요청 상태
|
state | string |
요청 상태 필터 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
TimeOff 요청 목록
|
value | array of TimeOffRequestResponse |
일정의 제한 시간 요청 목록 |
교대 근무: 모든 일정 그룹 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 일정 그룹 목록을 사용하세요.
이 작업은 일정의 모든 일정 그룹을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
상위 개수
|
$top | integer |
검색할 총 항목 수 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그룹 목록 예약
|
value | array of SchedulingGroupResponse |
일정의 일정 그룹 목록 |
교대 근무: 모든 제품 교대 근무 요청 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 제품 교대 근무 요청을 나열 하세요.
이 작업은 일정에 따라 모든 제품 교대 근무 요청을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
상위 개수
|
$top | integer |
검색할 총 요청 수 |
|
|
요청 상태
|
state | string |
요청 상태 필터 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
제안 교대 근무 요청 목록
|
value | array of OfferShiftRequestResponse |
일정의 제안 시프트 요청 목록 |
교대 근무: 새 Open Shift 만들기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 새 Open Shift 만들기를 사용하세요.
일정에 새 열린 교대 근무 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
그룹 ID 예약
|
schedulingGroupId | string |
그룹 ID 예약 |
|
|
표시 이름
|
displayName | string |
표시 이름 |
|
|
비고
|
notes | string |
비고 |
|
|
시작 시간부터
|
startDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Theme
|
theme | string |
Theme |
|
|
슬롯 개수 열기
|
openSlotCount | True | integer |
슬롯 개수 열기 |
|
지불
|
isPaid | boolean |
지불 |
|
|
시작 시간부터
|
startDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | True | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
코드
|
code | string |
코드 |
|
|
표시 이름
|
displayName | string |
표시 이름 |
반환
Shift 엔터티 열기
- Shift 열기
- OpenShiftResponse
교대 근무: 스왑 교대 근무 요청 거절 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 스왑 시프트 요청 거절을 사용하세요.
이 작업을 통해 사용자는 스왑 교대 근무 요청을 거절할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shifts 변경 요청 ID 교환
|
swapShiftsChangeRequestId | True | string |
요청의 고유 ID |
|
받는 사람/관리자의 메시지
|
message | string |
요청이 거부될 때의 메시지입니다. |
교대 근무: 스왑 교대 근무 요청 승인 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 교환 교대 근무 요청 승인을 사용하세요.
이 작업을 통해 사용자는 Shifts 교환 요청을 승인할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shifts 변경 요청 ID 교환
|
swapShiftsChangeRequestId | True | string |
요청의 고유 ID |
|
받는 사람/관리자의 메시지
|
message | string |
요청이 수락되는 경우의 메시지입니다. |
교대 근무: 시간 제한 요청 거절[사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 시간 해제 요청 거절을 사용하세요.
이 작업을 통해 관리자는 시간 제한 요청을 거절할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
제한 시간 요청 ID
|
timeOffRequestId | True | string |
시간 제한 요청의 고유 ID |
|
관리자의 메시지
|
message | string |
요청이 거부될 때 관리자가 보낸 사람/받는 사람에게 보내는 메시지입니다. |
교대 근무: 시간 제한 요청 승인 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 시간 제한 요청 승인을 사용하세요.
이 작업을 통해 관리자는 시간 제한 요청을 승인할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
제한 시간 요청 ID
|
timeOffRequestId | True | string |
시간 제한 요청의 고유 ID |
|
관리자의 메시지
|
message | string |
요청이 수락되면 관리자가 보낸 사람/받는 사람에게 보내는 메시지입니다. |
교대 근무: 열려 있는 모든 교대 근무 나열 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 팀의 모든 Open Shifts 목록을 사용하세요.
이 작업은 팀의 열려 있는 모든 교대 근무를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
시작 시간부터
|
startTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
|
종료 시간
|
endTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
|
상위 개수
|
$top | integer |
검색할 열린 교대 근무의 총 수 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Shifts 목록 열기
|
value | array of OpenShiftResponse |
일정의 열린 교대 근무 목록 |
교대 근무: 열린 교대 근무 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 가져오기를 사용하세요.
이 작업은 열린 교대 근무에 대한 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift ID 열기
|
openShiftId | True | string |
열린 시프트의 고유 ID입니다. |
반환
Shift 엔터티 열기
- Shift 열기
- OpenShiftResponse
교대 근무: 열린 교대 근무 삭제 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 Open Shift 삭제를 사용하세요.
이 작업은 열린 교대조를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
Shift ID 열기
|
openShiftId | True | string |
열린 시프트의 고유 ID입니다. |
교대 근무: 일정 그룹 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 예약 그룹 가져오기를 사용하세요.
이 작업은 고유 ID를 사용하여 예약 그룹에 대한 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
그룹 ID 예약
|
schedulingGroupId | True | string |
일정 그룹의 고유 ID입니다. |
반환
그룹 엔터티 예약
- 그룹 예약
- SchedulingGroupResponse
교대 근무: 일정 세부 정보 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 일정의 세부 정보 가져오기 를 사용하세요.
이 작업은 일정의 고유 ID를 사용하여 일정의 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
반환
엔터티 예약
교대 근무: 제안 교대 근무 요청 승인 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 제안 시프트 요청 승인을 사용하세요.
이 작업을 통해 받는 사람/관리자는 제안 교대 근무 요청을 승인할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
제안 시프트 요청 ID
|
offerShiftRequestId | True | string |
제안 시프트 요청의 고유 ID |
|
받는 사람/관리자의 메시지
|
message | string |
요청이 수락되는 경우의 메시지입니다. |
교대 근무: 제안 시프트 요청 거절[사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 제안 시프트 요청 거절을 사용하세요.
이 작업을 통해 사용자는 제품 교대 근무 요청을 거부할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
제안 시프트 요청 ID
|
offerShiftRequestId | True | string |
제안 시프트 요청의 고유 ID |
|
받는 사람/관리자의 메시지
|
message | string |
요청이 거부될 때의 메시지입니다. |
메시지 가져오기
특정 팀의 채널에서 메시지를 가져옵니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
반환
메시지 게시(V2) [사용되지 않음]
특정 팀의 채널에 메시지를 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
|
주제
|
subject | string |
메시지의 제목입니다. |
|
|
Message
|
content | True | string |
메시지의 본문입니다. |
|
유형
|
contentType | True | string |
콘텐츠 형식: html 또는 텍스트입니다. |
메시지 게시(V3) [사용되지 않음]
특정 팀의 채널에 메시지를 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
|
주제
|
subject | string |
메시지의 제목입니다. |
|
|
Message
|
content | True | html |
메시지의 본문입니다. |
반환
메시지 게시 [사용되지 않음]
특정 팀의 채널에 메시지를 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
|
Message
|
content | True | html |
메시지의 본문입니다. |
메시지 세부 정보 가져오기
채팅 또는 채널에서 메시지의 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Message
|
messageId | True | string |
메시지 ID |
|
메시지 유형
|
threadType | True | string |
메시지 유형 선택 |
|
메시지 세부 정보 요청 가져오기
|
body | True | dynamic |
메시지 세부 정보 가져오기 요청 |
반환
메시지에 회신 게시(V2) [사용되지 않음]
특정 팀의 채널에서 메시지에 회신을 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
|
Message
|
messageId | True | string |
메시지 ID |
|
주제
|
subject | string |
메시지의 제목입니다. |
|
|
회신
|
content | True | html |
메시지의 본문입니다. |
메시지에 회신 게시[사용되지 않음]
특정 팀의 채널에서 메시지에 회신을 게시합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
|
Message
|
messageId | True | string |
메시지 ID |
|
주제
|
subject | string |
메시지의 제목입니다. |
|
|
회신
|
content | True | string |
메시지의 본문입니다. |
|
유형
|
contentType | True | string |
콘텐츠 형식: html 또는 텍스트입니다. |
멤버 나열
그룹 채팅 또는 채널의 직접 구성원 나열
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
스레드 유형
|
threadType | True | string |
메시지 유형 선택 |
|
멤버 요청 나열
|
body | True | dynamic |
목록 멤버 요청 |
반환
멤버 응답 스키마 나열
모든 채널 나열
팀과 공유되는 채널을 포함하여 특정 팀의 모든 채널을 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 OData 필터 쿼리입니다(예: membershipType eq 'standard'). |
|
|
주문 기준
|
$orderby | string |
항목의 순서를 지정하기 위한 OData orderBy 쿼리 옵션(예: displayName asc)입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
채널 목록
|
value | array of ChannelWithOwnerTeamId |
특정 팀에 대한 하나 이상의 채널 목록 |
사용자 고유의 적응형 카드를 Flow 봇으로 사용자에게 게시[사용되지 않음]
JSON 카드 정의를 추가하여 Teams 사용자에 대한 사용자 지정 메시지를 만듭니다. 메시지에는 이미지, 그래프, 텍스트 등이 포함될 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
적응형 카드 요청 게시
|
PostAdaptiveCardRequest | True | dynamic |
사후 적응형 카드 요청 |
반환
사용자 고유의 적응형 카드를 흐름 봇으로 채널에 게시[사용되지 않음]
JSON 카드 정의를 추가하여 Teams 채널에 대한 사용자 지정 게시물을 만듭니다. 게시물에는 이미지, 그래프, 텍스트 등이 포함될 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
적응형 카드 요청 게시
|
PostAdaptiveCardRequest | True | dynamic |
사후 적응형 카드 요청 |
반환
사용자에 대한 @mention 토큰 가져오기
사용자에게 메시지 또는 적응형 카드에 삽입할 수 있는 토큰을 @mention 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자
|
userId | True | string |
사용자 계정 또는 사용자 ID를 로 지정합니다. @mention |
반환
@mention 토큰
사용자에게 Flow 봇으로 메시지 게시[사용되지 않음]
Teams에서 다른 사람에게 메시지를 보내는 프로세스를 쉽게 자동화할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
알림 후 요청
|
PostNotificationRequest | True | dynamic |
알림 후 요청 |
사용자에게 Flow 봇으로 선택한 옵션 게시
Microsoft Teams 사용자에게 흐름이 계속되기 전에 응답해야 하는 옵션 집합을 보냅니다. 이 작업은 사용자가 옵션에 응답할 때까지 흐름을 일시 중지합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
옵션 구독 요청이 있는 사용자 메시지
|
UserMessageWithOptionsSubscriptionRequest | True | dynamic |
옵션 구독 요청이 있는 사용자 메시지 |
반환
연결된 팀 나열
직접 구성원이거나 팀 내에서 호스트되는 공유 채널의 구성원인 모든 팀을 나열합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Teams 목록
|
value | array of AssociatedTeamInfo |
연결된 팀 목록 |
적응형 카드를 게시하고 응답을 기다립니다.
적응형 카드를 채팅 또는 채널에 게시하고 사용자의 응답을 기다립니다. 그러면 사용자가 응답할 때까지 흐름이 일시 중지됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
다음에서 게시
|
location | True | string |
옵션 선택 |
|
흐름 연속 구독 요청
|
body | True | dynamic |
흐름 연속 구독 요청 |
반환
참가한 팀 나열
사용자가 소속된 Microsoft Teams의 모든 팀을 나열합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Teams 목록
|
value | array of object |
구성원인 팀 목록 |
|
Description
|
value.description | string |
팀에 대한 선택적 설명 |
|
이름
|
value.displayName | string |
팀의 이름 |
|
아이디
|
value.id | string |
Microsoft 365 그룹 ID라고도 하는 팀의 고유 식별자 |
채널 나열
특정 팀의 모든 채널을 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 OData 필터 쿼리입니다(예: membershipType eq 'standard'). |
|
|
주문 기준
|
$orderby | string |
항목의 순서를 지정하기 위한 OData orderBy 쿼리 옵션(예: displayName asc)입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
채널 목록
|
value | array of GetChannelResponse |
특정 팀에 대한 하나 이상의 채널 목록 |
채널 만들기
지정된 팀 내에서 새 채널 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
Description
|
description | string |
채널에 대한 선택적 텍스트 설명 |
|
|
이름
|
displayName | True | string |
Microsoft Teams에 표시되는 채널 이름 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Description
|
description | string |
채널에 대한 선택적 텍스트 설명 |
|
표시 이름
|
displayName | string |
Microsoft Teams에 표시되는 채널 이름 |
|
아이디
|
id | string |
채널의 고유 식별자 |
채널 메시지의 회신 나열
특정 팀의 채널에 있는 메시지에 대한 회신을 나열합니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
|
Message
|
messageId | True | string |
메시지 ID |
|
최신 회신 수
|
$top | integer |
반환할 최신 회신 수입니다. 기본값은 20입니다. 지원되는 값은 1에서 50 사이입니다. |
반환
응답 스키마 나열
채널에 Flow 봇으로 메시지 게시[사용되지 않음]
Teams 채널에 메시지를 게시하는 프로세스를 쉽게 자동화할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
알림 후 요청
|
PostNotificationRequest | True | dynamic |
알림 후 요청 |
채널에서 메시지와 함께 회신
채널의 메시지에 메시지와 함께 회신
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
다음에서 게시
|
location | True | string |
옵션 선택 |
|
회신 메시지 요청
|
body | True | dynamic |
회신 메시지 요청 |
반환
채널에서 적응형 카드로 회신
채널 메시지에 적응형 카드로 회신
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
다음에서 게시
|
location | True | string |
옵션 선택 |
|
적응형 카드 요청 회신
|
body | True | dynamic |
회신 적응형 카드 요청 |
반환
채팅 나열
소속된 최근 채팅을 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
채팅 유형
|
chatType | True | string |
형식별로 필터링 |
|
주제
|
topic | True | string |
토픽 이름이 정의되었는지 여부를 필터링합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
채팅 목록
|
value | array of object |
소속된 하나 이상의 채팅 목록 |
|
주제
|
value.topic | string |
채팅의 주제 또는 주제입니다. 그룹 채팅에만 사용 가능 |
|
만든 날짜 시간
|
value.createdDateTime | date-time |
채팅을 만든 날짜 및 시간 |
|
마지막 업데이트 날짜 시간
|
value.lastUpdatedDateTime | date-time |
채팅 이름이 마지막으로 변경되었거나 구성원 목록이 마지막으로 업데이트된 날짜 및 시간입니다. |
|
대화 식별자
|
value.id | string |
채팅의 고유 식별자 |
채팅 또는 채널에 메시지 게시
채팅 또는 채널에 메시지 게시
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
다음에서 게시
|
location | True | string |
옵션 선택 |
|
메시지 게시 요청
|
body | True | dynamic |
메시지 게시 요청 |
반환
채팅 또는 채널에서 적응형 카드 업데이트
기존 적응형 카드를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
다음에서 게시
|
location | True | string |
옵션 선택 |
|
적응형 카드 요청 업데이트
|
body | True | dynamic |
적응형 카드 업데이트 요청 |
채팅 또는 채널의 우편 카드
채팅 또는 채널에 카드 게시
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
다음에서 게시
|
location | True | string |
옵션 선택 |
|
우편 카드 요청
|
body | True | dynamic |
우편 카드 요청 |
반환
채팅 만들기
하나 또는 그룹 채팅에 하나를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
제목
|
topic | string |
그룹 채팅에만 표시되는 제목 |
|
|
추가할 멤버
|
members | True | string |
세미콜론으로 구분된 사용자의 ID |
반환
생성된 새 채팅에 대한 응답
팀 가져오기
Microsoft Teams의 팀에 대한 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
반환
팀 응답 가져오기
팀 만들기
Microsoft Teams에서 새 팀 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀 이름
|
displayName | True | string |
팀의 이름 |
|
Description
|
description | True | string |
팀에 대한 선택적 설명 |
|
가시성
|
visibility | string |
팀의 가시성 |
반환
팀 태그 삭제
팀에서 태그를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
Tag
|
tagId | True | string |
태그 선택 |
팀 태그에 대한 @mention 토큰 가져오기
채널에서 팀 태그로 사용자로 보낸 메시지 또는 적응형 카드에 삽입할 @mention 수 있는 토큰을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
Tag
|
tagId | True | string |
태그 선택 |
반환
@mention 태그에 대한 토큰
팀 태그에 멤버 추가
팀 태그에 사용자 추가
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
Tag
|
tagId | True | string |
태그 선택 |
|
사용자의 ID
|
userId | True | string |
태그에 추가할 멤버의 사용자 ID는 '550e8400-e29b-41d4-a716-446655440000' 형식이어야 합니다. |
반환
팀 태그에서 멤버 삭제
팀 태그에서 멤버를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
Tag
|
tagId | True | string |
태그 선택 |
|
태그 멤버 ID
|
tagMemberId | True | string |
태그에서 제거할 멤버의 ID |
팀 태그의 멤버 나열
팀 태그의 멤버를 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
Tag
|
tagId | True | string |
태그 선택 |
반환
팀에 구성원 추가
Microsoft Teams의 팀에 구성원 추가
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
teamId | True | string |
팀 선택 |
|
사용자
|
userId | True | string |
추가할 사용자 계정 이름 또는 Microsoft Entra ID |
|
사용자를 팀 소유자로 설정
|
owner | boolean |
True, 사용자가 팀 소유자여야 하는 경우 |
팀에 대한 태그 만들기
팀에서 태그를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
표시 이름
|
displayName | True | string |
Microsoft Teams에서 사용자에게 표시되는 태그의 이름입니다. |
|
멤버의 ID
|
members | True | string |
세미콜론으로 구분된 사용자 ID 목록, 식별자는 '550e8400-e29b-41d4-a716-446655440000' 형식이어야 합니다. |
반환
팀에 대해 만든 태그
팀의 모든 태그 나열
팀의 특정 채널에 대한 세부 정보 가져오기
채널 세부 정보 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
반환
팀 채널 세부 정보 응답 가져오기
피드 알림 게시
채팅 또는 팀에 연결하는 사용자의 활동 피드에 알림을 게시합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
다음으로 게시
|
poster | True | string |
옵션 선택 |
|
알림 유형
|
notificationType | True | string |
알림 유형 선택 |
|
피드 후 알림 요청
|
body | True | dynamic |
게시물 피드 알림 요청 |
트리거
| @mentioned 때 |
현재 사용자가 지정된 채팅 또는 채널에 추가되는 새 메시지를 @mentions 트리거합니다. |
| 누군가가 적응형 카드에 응답하는 경우 |
이 트리거를 사용하면 Microsoft Teams에 게시된 적응형 카드에 대한 응답을 처리할 수 있습니다. (Power Automate에만 사용 가능) |
| 새 채널 메시지가 추가되는 경우 |
팀의 채널에 새 메시지가 게시될 때 트리거됩니다. 이 트리거는 루트 메시지가 채널에 추가된 경우에만 발생합니다. 기존 채널 메시지에 대한 회신은 트리거 이벤트가 발생하지 않습니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 새 채팅 메시지가 추가된 경우 |
사용자가 속한 채팅에 새 메시지가 게시되면 트리거됩니다. |
| 새 팀 구성원이 제거된 경우 |
지정된 팀에서 멤버가 제거될 때 트리거 |
| 새 팀 구성원이 추가되는 경우 |
멤버가 지정된 팀에 추가되면 트리거됩니다. |
| 선택한 메시지의 경우(V2) |
이 트리거를 사용하면 Microsoft Teams에서 선택한 메시지에 대한 흐름을 시작할 수 있습니다. (Power Automate에만 사용 가능) |
| 작성 상자에서(V2) |
이 트리거를 사용하면 Microsoft Teams의 작성 메시지 상자에서 흐름을 시작할 수 있습니다. (Power Automate에만 사용 가능) |
| 채널 메시지에 언급된 경우 |
현재 사용자가 팀의 채널에 추가되었다는 @mentions 새 메시지가 표시되면 트리거됩니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다. |
| 채팅 또는 채널에 새 메시지가 추가되는 경우 |
지정된 채팅 또는 채널에 새 메시지가 게시될 때 트리거됩니다. 메시지가 편집되면 트리거되지 않습니다. |
| 채팅에서 다른 사람이 메시지에 반응한 경우 |
누군가가 지정된 채팅 또는 채널의 메시지에 반응할 때 트리거됩니다. |
| 키워드가 언급되는 경우 |
지정된 채팅 또는 채널에서 키워드가 언급되면 트리거됩니다. 메시지가 편집되면 트리거되지 않습니다. |
@mentioned 때
현재 사용자가 지정된 채팅 또는 채널에 추가되는 새 메시지를 @mentions 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 유형
|
threadType | True | string |
메시지 유형 선택 |
|
requestBody
|
requestBody | dynamic |
Webhook의 요청 본문입니다. |
반환
누군가가 적응형 카드에 응답하는 경우
이 트리거를 사용하면 Microsoft Teams에 게시된 적응형 카드에 대한 응답을 처리할 수 있습니다. (Power Automate에만 사용 가능)
반환
새 채널 메시지가 추가되는 경우
팀의 채널에 새 메시지가 게시될 때 트리거됩니다. 이 트리거는 루트 메시지가 채널에 추가된 경우에만 발생합니다. 기존 채널 메시지에 대한 회신은 트리거 이벤트가 발생하지 않습니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
attachments
|
attachments | array of object |
attachments |
|
items
|
attachments | object | |
|
내용
|
body.content | string |
메시지의 내용 |
|
콘텐츠 형식
|
body.contentType | string |
콘텐츠의 형식입니다. 가능한 값은 텍스트 및 html입니다. |
|
만들기 타임스탬프
|
createdDateTime | date-time |
채팅 메시지를 만든 시기의 타임스탬프 |
|
삭제됨
|
deleted | boolean |
삭제됨 |
|
etag
|
etag | string |
채팅 메시지의 버전 번호입니다. |
|
신청
|
from.application | object |
신청 |
|
디바이스
|
from.device | string |
디바이스 |
|
display name(표시 이름)
|
from.user.displayName | string |
display name(표시 이름) |
|
아이디
|
from.user.id | string |
사용자의 식별자 |
|
아이덴티티제공자
|
from.user.identityProvider | string |
아이덴티티제공자 |
|
아이디
|
id | string |
메시지의 고유 ID |
|
중요성
|
importance | string |
메시지의 중요도입니다. 가능한 값은 보통, 높음, 긴급입니다. |
|
마지막으로 수정한 타임스탬프
|
lastModifiedDateTime | string |
응답이 추가 또는 제거되는 경우를 포함하여 채팅 메시지를 만들거나 수정할 때의 타임스탬프 |
|
지역 설정
|
locale | string |
클라이언트가 설정한 채팅 메시지의 로캘입니다. |
|
언급
|
mentions | array of object |
채팅 메시지에 언급된 엔터티 목록입니다. 지원되는 엔터티는 사용자, 봇, 팀 및 채널입니다. |
|
items
|
mentions | object | |
|
messageType
|
messageType | string |
채팅 메시지의 유형 |
|
반응
|
reactions | array of object |
이 채팅 메시지에 대한 반응(예: 좋아요) |
|
items
|
reactions | object | |
|
replyToId
|
replyToId | string |
스레드의 부모 메시지 ID |
|
제목
|
subject | string |
채팅 메시지의 제목(선택 사항) |
|
summary
|
summary | string |
푸시 알림 및 요약 보기 또는 대체 보기에 사용할 수 있는 메시지의 요약 텍스트 |
새 채팅 메시지가 추가된 경우
새 팀 구성원이 제거된 경우
지정된 팀에서 멤버가 제거될 때 트리거
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 ID
|
id | string |
사용자의 고유 ID |
새 팀 구성원이 추가되는 경우
멤버가 지정된 팀에 추가되면 트리거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 ID
|
id | string |
사용자의 고유 ID |
선택한 메시지의 경우(V2)
이 트리거를 사용하면 Microsoft Teams에서 선택한 메시지에 대한 흐름을 시작할 수 있습니다. (Power Automate에만 사용 가능)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
schema(스키마)
|
schema | object |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
body
|
body | object |
작성 상자에서(V2)
이 트리거를 사용하면 Microsoft Teams의 작성 메시지 상자에서 흐름을 시작할 수 있습니다. (Power Automate에만 사용 가능)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
schema(스키마)
|
schema | object |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
body
|
body | object |
채널 메시지에 언급된 경우
현재 사용자가 팀의 채널에 추가되었다는 @mentions 새 메시지가 표시되면 트리거됩니다. 공유 채널의 경우 팀 ID는 공유 채널을 소유한 팀인 호스트 팀을 참조해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
팀
|
groupId | True | string |
팀 선택 |
|
채널
|
channelId | True | string |
채널 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
attachments
|
attachments | array of object |
attachments |
|
items
|
attachments | object | |
|
내용
|
body.content | string |
메시지의 내용 |
|
콘텐츠 형식
|
body.contentType | string |
콘텐츠의 형식입니다. 가능한 값은 텍스트 및 html입니다. |
|
만들기 타임스탬프
|
createdDateTime | date-time |
채팅 메시지를 만든 시기의 타임스탬프 |
|
삭제됨
|
deleted | boolean |
삭제됨 |
|
etag
|
etag | string |
채팅 메시지의 버전 번호입니다. |
|
신청
|
from.application | object |
신청 |
|
디바이스
|
from.device | string |
디바이스 |
|
display name(표시 이름)
|
from.user.displayName | string |
display name(표시 이름) |
|
아이디
|
from.user.id | string |
사용자의 식별자 |
|
아이덴티티제공자
|
from.user.identityProvider | string |
아이덴티티제공자 |
|
아이디
|
id | string |
메시지의 고유 ID |
|
중요성
|
importance | string |
메시지의 중요도입니다. 가능한 값은 보통, 높음, 긴급입니다. |
|
마지막으로 수정한 타임스탬프
|
lastModifiedDateTime | string |
응답이 추가 또는 제거되는 경우를 포함하여 채팅 메시지를 만들거나 수정할 때의 타임스탬프 |
|
지역 설정
|
locale | string |
클라이언트가 설정한 채팅 메시지의 로캘입니다. |
|
언급
|
mentions | array of object |
채팅 메시지에 언급된 엔터티 목록입니다. 지원되는 엔터티는 사용자, 봇, 팀 및 채널입니다. |
|
items
|
mentions | object | |
|
messageType
|
messageType | string |
채팅 메시지의 유형 |
|
반응
|
reactions | array of object |
이 채팅 메시지에 대한 반응(예: 좋아요) |
|
items
|
reactions | object | |
|
replyToId
|
replyToId | string |
스레드의 부모 메시지 ID |
|
제목
|
subject | string |
채팅 메시지의 제목(선택 사항) |
|
summary
|
summary | string |
푸시 알림 및 요약 보기 또는 대체 보기에 사용할 수 있는 메시지의 요약 텍스트 |
채팅 또는 채널에 새 메시지가 추가되는 경우
지정된 채팅 또는 채널에 새 메시지가 게시될 때 트리거됩니다. 메시지가 편집되면 트리거되지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 유형
|
threadType | True | string |
메시지 유형 선택 |
|
requestBody
|
requestBody | dynamic |
Webhook의 요청 본문입니다. |
반환
채팅에서 다른 사람이 메시지에 반응한 경우
누군가가 지정된 채팅 또는 채널의 메시지에 반응할 때 트리거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
추적할 이모지
|
reactionKey | True | string |
메시지 반응을 모니터링할 이모지 선택 |
|
트리거 빈도
|
frequency | True | string |
흐름이 모든 반응에 의해 트리거되어야 하는지 또는 특정 메시지의 첫 번째 반응에 의해서만 트리거되어야 하는지 여부 |
|
누가 트리거할 수 있나요?
|
runningPolicy | True | string |
이 워크플로를 트리거할 수 있는 사용자 지정 |
|
메시지 유형
|
threadType | True | string |
메시지 유형 선택 |
|
requestBody
|
requestBody | dynamic |
Webhook의 요청 본문입니다. |
반환
메시지 세부 정보
키워드가 언급되는 경우
지정된 채팅 또는 채널에서 키워드가 언급되면 트리거됩니다. 메시지가 편집되면 트리거되지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 유형
|
threadType | True | string |
메시지 유형 선택 |
|
검색할 키워드
|
$search | True | string |
검색할 쉼표로 구분된 키워드 목록 |
|
requestBody
|
requestBody | dynamic |
Webhook의 요청 본문입니다. |
반환
정의
GetTagsResponseSchema
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
아이디
|
value.id | string |
태그의 고유 식별자 |
|
팀 ID
|
value.teamId | string |
태그가 정의된 팀의 ID |
|
표시 이름
|
value.displayName | string |
Microsoft Teams에서 사용자에게 표시되는 태그의 이름입니다. |
|
멤버 수
|
value.memberCount | integer |
태그에 할당된 사용자 수 |
GetTagMembersResponseSchema
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
태그 멤버 ID
|
value.id | string |
멤버의 고유 식별자입니다. |
|
임차인 ID
|
value.tenantId | string |
태그 멤버가 속한 테넌트 ID |
|
사용자 표시 이름
|
value.displayName | string |
멤버의 표시 이름 |
|
사용자 ID
|
value.userId | string |
멤버의 사용자 ID |
CreateTagResponseSchema
팀에 대해 만든 태그
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
태그의 고유 식별자 |
|
팀 ID
|
teamId | string |
태그가 정의된 팀의 ID |
|
표시 이름
|
displayName | string |
Microsoft Teams에서 사용자에게 표시되는 태그의 이름입니다. |
|
멤버 수
|
memberCount | integer |
태그에 할당된 사용자 수 |
AddMemberToTagResponseSchema
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
userId | string |
태그에 추가된 멤버의 사용자 ID |
ListMembersResponseSchema
멤버 응답 스키마 나열
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
멤버 목록
|
value | array of object |
멤버 응답 나열 |
|
표시 이름
|
value.displayName | string |
멤버의 표시 이름 |
|
전자 메일
|
value.email | string |
구성원의 전자 메일 주소 |
|
아이디
|
value.id | string |
멤버의 사용자 ID |
|
역할
|
value.roles | array of string |
해당 멤버의 역할 |
|
임차인 ID
|
value.tenantId | string |
멤버의 테넌트 ID |
|
사용자 ID
|
value.userId | string |
멤버의 사용자 ID |
|
대화의 표시 기록 시작 시간
|
value.visibleHistoryStartDateTime | string |
대화의 기록이 대화 멤버와 얼마나 멀리 공유되는지를 나타내는 타임스탬프 |
ListRepliesResponseSchema
응답 스키마 나열
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 회신 목록
|
value | array of object |
회신 응답 나열 |
|
아이디
|
value.id | string |
회신 ID |
|
ID에 회신
|
value.replyToId | string |
회신할 메시지의 ID |
|
ETag
|
value.etag | string |
회신의 ETag |
|
메시지 유형
|
value.messageType | string |
메시지 유형 |
|
만든 날짜 시간
|
value.createdDateTime | string |
회신의 만들기 타임스탬프 |
|
마지막으로 수정한 날짜 시간
|
value.lastModifiedDateTime | string |
회신의 마지막 수정 타임스탬프 |
|
마지막으로 편집한 날짜 시간
|
value.lastEditedDateTime | string |
마지막으로 편집한 회신 타임스탬프 |
|
삭제된 날짜 시간
|
value.deletedDateTime | string |
회신의 삭제 타임스탬프 |
|
주제
|
value.subject | string |
회신 제목 |
|
요약
|
value.summary | string |
회신 요약 |
|
채팅 ID
|
value.chatId | string |
회신과 연결된 채팅 ID |
|
중요도
|
value.importance | string |
회신의 중요도 |
|
로케일
|
value.locale | string |
회신의 로캘 |
|
웹 URL
|
value.webUrl | string |
회신의 웹 URL |
|
정책 위반
|
value.policyViolation | object |
정책 위반 세부 정보 |
|
이벤트 세부 정보
|
value.eventDetail | object |
회신과 관련된 이벤트 세부 정보 |
|
Application
|
value.from.application | object |
애플리케이션 세부 정보 |
|
Device
|
value.from.device | object |
디바이스 세부 정보 |
|
사용자 ID
|
value.from.user.id | string |
사용자 ID |
|
표시 이름
|
value.from.user.displayName | string |
사용자의 표시 이름 |
|
사용자 ID 유형
|
value.from.user.userIdentityType | string |
사용자 ID 유형 |
|
임차인 ID
|
value.from.user.tenantId | string |
사용자의 테넌트 ID |
|
콘텐츠 형식
|
value.body.contentType | string |
회신의 콘텐츠 형식 |
|
Content
|
value.body.content | string |
답장의 내용 |
|
팀 ID
|
value.channelIdentity.teamId | string |
팀 ID |
|
채널 ID
|
value.channelIdentity.channelId | string |
채널 ID |
|
Attachments
|
value.attachments | array of object |
회신의 첨부 파일 |
|
items
|
value.attachments | object | |
|
멘션
|
value.mentions | array of object |
회신의 멘션 |
|
items
|
value.mentions | object | |
|
반응
|
value.reactions | array of object |
회신에 대한 반응 |
|
items
|
value.reactions | object | |
|
메시지 기록
|
value.messageHistory | array of object |
메시지의 기록 |
|
items
|
value.messageHistory | object |
MessageReactionWebhookResponseSchema
메시지 세부 정보
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
ThreadType
|
threadType | string | |
|
ChatId
|
chatId | string |
채팅의 고유 식별자 |
|
TeamId
|
teamId | string |
팀의 고유 식별자 |
|
ChannelId
|
channelId | string |
채널의 고유 식별자 |
|
MessageId
|
messageId | string |
반응된 메시지의 ID |
|
ReplyToId
|
replyToId | string |
스레드의 부모 메시지 ID |
|
Messagelink
|
messageLink | string |
반응된 메시지에 대한 링크 |
|
UserId
|
userId | string |
반응하는 사용자의 ID |
|
MessageReaction
|
messageReaction | string |
사용된 메시지 반응 |
ChatMessageWebhookResponseSchema
메시지 세부 정보
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Message
|
value | array of object |
메시지 세부 정보 응답 |
|
대화 식별자
|
value.conversationId | string |
채팅의 고유 식별자 |
|
아이디
|
value.messageId | string |
메시지 ID |
|
Link
|
value.linkToMessage | string |
메시지 링크 |
MessageId
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 ID
|
id | string |
고유 메시지 식별자 |
GetMessagesFromChannel_Response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
@odata.context
|
@odata.context | string |
@odata.context |
|
@odata.count
|
@odata.count | integer |
@odata.count |
|
@odata.nextLink
|
@odata.nextLink | string |
@odata.nextLink |
|
메시지 목록
|
value | OnNewChannelMessage_Response |
팀의 특정 채널에 대한 하나 이상의 메시지 목록 |
OnNewChannelMessage_Response
팀의 특정 채널에 대한 하나 이상의 메시지 목록
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
attachments
|
attachments | array of object |
attachments |
|
items
|
attachments | object | |
|
내용
|
body.content | string |
메시지의 내용 |
|
콘텐츠 형식
|
body.contentType | string |
콘텐츠의 형식입니다. 가능한 값은 텍스트 및 html입니다. |
|
만들기 타임스탬프
|
createdDateTime | date-time |
채팅 메시지를 만든 시기의 타임스탬프 |
|
삭제됨
|
deleted | boolean |
삭제됨 |
|
etag
|
etag | string |
채팅 메시지의 버전 번호입니다. |
|
신청
|
from.application | object |
신청 |
|
디바이스
|
from.device | string |
디바이스 |
|
display name(표시 이름)
|
from.user.displayName | string |
display name(표시 이름) |
|
아이디
|
from.user.id | string |
사용자의 식별자 |
|
아이덴티티제공자
|
from.user.identityProvider | string |
아이덴티티제공자 |
|
아이디
|
id | string |
메시지의 고유 ID |
|
중요성
|
importance | string |
메시지의 중요도입니다. 가능한 값은 보통, 높음, 긴급입니다. |
|
마지막으로 수정한 타임스탬프
|
lastModifiedDateTime | string |
응답이 추가 또는 제거되는 경우를 포함하여 채팅 메시지를 만들거나 수정할 때의 타임스탬프 |
|
지역 설정
|
locale | string |
클라이언트가 설정한 채팅 메시지의 로캘입니다. |
|
언급
|
mentions | array of object |
채팅 메시지에 언급된 엔터티 목록입니다. 지원되는 엔터티는 사용자, 봇, 팀 및 채널입니다. |
|
items
|
mentions | object | |
|
messageType
|
messageType | string |
채팅 메시지의 유형 |
|
반응
|
reactions | array of object |
이 채팅 메시지에 대한 반응(예: 좋아요) |
|
items
|
reactions | object | |
|
replyToId
|
replyToId | string |
스레드의 부모 메시지 ID |
|
제목
|
subject | string |
채팅 메시지의 제목(선택 사항) |
|
summary
|
summary | string |
푸시 알림 및 요약 보기 또는 대체 보기에 사용할 수 있는 메시지의 요약 텍스트 |
GetTeamResponse
팀 응답 가져오기
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
팀 ID
|
id | string |
팀의 고유 식별자 |
|
표시 이름
|
displayName | string |
팀의 이름 |
|
팀에 대한 설명
|
description | string |
팀에 대한 설명(선택 사항) |
|
내부 ID
|
internalId | string |
팀의 내부 ID |
|
팀의 웹 URL
|
webUrl | string |
Microsoft Teams 클라이언트의 팀으로 이동하는 하이퍼링크 |
|
Archived
|
isArchived | boolean |
이 팀이 읽기 전용 모드인지 여부 |
|
멤버 설정
|
memberSettings | MemberSettings |
멤버가 특정 작업을 수행할 수 있는지 여부를 구성하는 설정(예: 팀에서 채널 만들기 및 봇 추가) |
|
게스트 설정
|
guestSettings | GuestSettings |
게스트가 팀에서 채널을 만들거나 업데이트하거나 삭제할 수 있는지 여부를 구성하는 설정 |
|
메시징 설정
|
messagingSettings | MessagingSettings |
팀에서 메시징 및 멘션을 구성하는 설정 |
|
재미있는 설정
|
funSettings | FunSettings |
팀에서 Giphy, 밈 및 스티커 사용을 구성하는 설정 |
|
검색 설정
|
discoverySettings | DiscoverySettings |
다른 사용자가 팀 검색 가능성을 구성하는 설정입니다. |
AssociatedTeamInfo
사용자와 연결된 팀을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
팀 ID
|
id | string |
팀의 고유 식별자 |
|
표시 이름
|
displayName | string |
팀의 이름 |
|
임차인 ID
|
tenantId | string |
이 팀이 속한 Microsoft Entra 테넌트 ID |
GetChannelResponse
팀 채널 세부 정보 응답 가져오기
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
채널 ID
|
id | string |
채널의 고유 식별자입니다. |
|
표시 이름
|
displayName | string |
채널의 이름 |
|
채널에 대한 설명
|
description | string |
채널에 대한 설명(선택 사항) |
|
채널의 전자 메일 주소
|
string |
채널에 메시지를 보내기 위한 전자 메일 주소 |
|
|
팀 테넌트 ID
|
tenantId | string |
Microsoft Entra 테넌트 ID입니다. |
|
Microsoft Teams의 채널에 대한 하이퍼링크
|
webUrl | string |
Microsoft Teams의 채널에 대한 하이퍼링크 |
|
채널에 대한 SharePoint 폴더 URL
|
filesFolderWebUrl | string |
채널의 SharePoint 폴더 URL |
|
채널 생성 시간
|
createdDateTime | date-time |
채널이 만들어진 타임스탬프입니다. 읽기 전용 |
|
채널의 형식입니다.
|
membershipType | string |
채널 멤버 자격 유형 |
ChannelWithOwnerTeamId
소유자 팀 ID가 있는 채널 리소스
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
object |
소유자 팀 ID가 있는 채널 리소스 |
GetTimeOffReasonsResponse
시간 제한 이유 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
시간 해제 이유가 포함된 배열
|
value | array of object |
시간 제한 이유 목록입니다. |
|
시간 끄기 이유 ID
|
value.id | string |
쉬는 이유의 고유 ID입니다. |
|
만든 시간
|
value.createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 날짜 시간
|
value.lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
표시 이름
|
value.displayName | string |
표시 이름 |
|
아이콘 유형
|
value.iconType | string |
아이콘 유형 |
|
활성 상태
|
value.isActive | boolean |
활성 상태 |
|
마지막으로 수정한 날짜
|
value.lastModifiedBy | LastModifiedBy |
마지막으로 수정한 날짜 |
TimeOffRequestResponse
TimeOff 요청 엔터티
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
TimeOff 요청의 고유 ID입니다. |
|
만든 시간
|
createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 시간
|
lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Assigned To
|
assignedTo | string |
요청이 할당된 사람: '관리자' 또는 '받는 사람' |
|
주
|
state | string |
'승인됨', '보류 중' 또는 '거부됨' |
|
보낸 사람 시간
|
senderDateTime | date-time |
요청이 전송된 시간 |
|
보낸 사람 메시지
|
senderMessage | string |
요청 발신자의 메시지 |
|
보낸 사람 ID
|
senderUserId | string |
요청을 보낸 사용자의 ID입니다. |
|
관리자 작업 시간
|
managerActionDateTime | date-time |
관리자가 응답한 시간 |
|
관리자 메시지
|
managerActionMessage | string |
관리자의 메시지 |
|
관리자 ID
|
managerUserId | string |
응답한 관리자의 ID입니다. |
|
시작 시간부터
|
startDateTime | date-time |
요청된 시간 시작 |
|
종료 시간
|
endDateTime | date-time |
종료 요청 끄기 |
|
TimeOff 이유 ID
|
timeOffReasonId | string |
TimeOff 이유의 ID |
OfferShiftRequestResponse
제안 Shift 요청 엔터티
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
제안 시프트 요청의 고유 ID입니다. |
|
만든 시간
|
createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 시간
|
lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Assigned To
|
assignedTo | string |
요청이 할당된 사람: '관리자' 또는 '받는 사람' |
|
주
|
state | string |
'승인됨', '보류 중' 또는 '거부됨' |
|
보낸 사람 시간
|
senderDateTime | date-time |
요청이 전송된 시간 |
|
보낸 사람 메시지
|
senderMessage | string |
요청 발신자의 메시지 |
|
보낸 사람 ID
|
senderUserId | string |
요청을 보낸 사용자의 ID입니다. |
|
보낸 사람 Shift ID
|
senderShiftId | string |
보낸 사람의 교대 근무 ID입니다. |
|
수신자 시간
|
recipientActionDateTime | date-time |
받는 사람이 응답한 시간 |
|
받는 사람 메시지
|
recipientActionMessage | string |
받는 사람의 메시지 |
|
받는 사람 ID
|
recipientUserId | string |
요청 받는 사람의 ID입니다. |
|
관리자 작업 시간
|
managerActionDateTime | date-time |
관리자가 응답한 시간 |
|
관리자 메시지
|
managerActionMessage | string |
관리자의 메시지 |
|
관리자 ID
|
managerUserId | string |
응답한 관리자의 ID입니다. |
SwapShiftsChangeRequestResponse
Shift 요청 엔터티 교환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
Shift 교환 요청의 고유 ID입니다. |
|
만든 시간
|
createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 시간
|
lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Assigned To
|
assignedTo | string |
요청이 할당된 사람: '관리자' 또는 '받는 사람' |
|
주
|
state | string |
'승인됨', '보류 중' 또는 '거부됨' |
|
보낸 사람 시간
|
senderDateTime | date-time |
요청이 전송된 시간 |
|
보낸 사람 메시지
|
senderMessage | string |
요청 발신자의 메시지 |
|
보낸 사람 ID
|
senderUserId | string |
요청을 보낸 사용자의 ID입니다. |
|
보낸 사람 Shift ID
|
senderShiftId | string |
보낸 사람의 교대 근무 ID입니다. |
|
수신자 시간
|
recipientActionDateTime | date-time |
받는 사람이 응답한 시간 |
|
받는 사람 메시지
|
recipientActionMessage | string |
받는 사람의 메시지 |
|
받는 사람 ID
|
recipientUserId | string |
요청 받는 사람의 ID입니다. |
|
받는 사람 교대 ID
|
recipientShiftId | string |
받는 사람의 교대 근무 ID입니다. |
|
관리자 작업 시간
|
managerActionDateTime | date-time |
관리자가 응답한 시간 |
|
관리자 메시지
|
managerActionMessage | string |
관리자의 메시지 |
|
관리자 ID
|
managerUserId | string |
응답한 관리자의 ID입니다. |
OpenShiftChangeRequestResponse
Shift 변경 요청 엔터티 열기
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
Shift 변경 열기 요청의 고유 ID입니다. |
|
만든 시간
|
createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 시간
|
lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Assigned To
|
assignedTo | string |
요청이 할당된 사람: '관리자' 또는 '받는 사람' |
|
주
|
state | string |
'승인됨', '보류 중' 또는 '거부됨' |
|
보낸 사람 시간
|
senderDateTime | date-time |
요청이 전송된 시간 |
|
보낸 사람 메시지
|
senderMessage | string |
요청 발신자의 메시지 |
|
보낸 사람 ID
|
senderUserId | string |
요청을 보낸 사용자의 ID입니다. |
|
관리자 작업 시간
|
managerActionDateTime | date-time |
관리자가 응답한 시간 |
|
관리자 메시지
|
managerActionMessage | string |
관리자의 메시지 |
|
관리자 ID
|
managerUserId | string |
응답한 관리자의 ID입니다. |
|
Shift ID 열기
|
openShiftId | string |
요청 중인 열린 교대 근무의 ID입니다. |
OpenShiftResponse
Shift 엔터티 열기
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
열린 시프트의 고유 ID입니다. |
|
만든 날짜 시간
|
createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 날짜 시간
|
lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
그룹 ID 예약
|
schedulingGroupId | string |
그룹 ID 예약 |
|
마지막으로 수정한 날짜
|
lastModifiedBy | LastModifiedBy |
마지막으로 수정한 날짜 |
|
공유 Open Shift
|
sharedOpenShift | SharedOpenShift |
열린 교대 근무의 공유 버전 |
|
임시 오픈 시프트
|
draftOpenShift | DraftOpenShift |
오픈 시프트의 예비 버전 |
SharedOpenShift
열린 교대 근무의 공유 버전
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표시 이름
|
displayName | string |
표시 이름 |
|
비고
|
notes | string |
비고 |
|
시작 시간부터
|
startDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Theme
|
theme | string |
Theme |
|
슬롯 개수 열기
|
openSlotCount | integer |
슬롯 개수 열기 |
|
activities
|
activities | Activities |
교대 근무 활동 |
DraftOpenShift
오픈 시프트의 예비 버전
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표시 이름
|
displayName | string |
표시 이름 |
|
비고
|
notes | string |
비고 |
|
시작 시간부터
|
startDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Theme
|
theme | string |
Theme |
|
슬롯 개수 열기
|
openSlotCount | integer |
슬롯 개수 열기 |
|
activities
|
activities | Activities |
교대 근무 활동 |
ShiftResponse
Shift 엔터티
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
교대 근무의 고유 ID입니다. |
|
만든 날짜 시간
|
createdDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
수정된 날짜 시간
|
lastModifiedDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
사용자 ID에 할당됨
|
userId | string |
사용자 ID에 할당됨 |
|
그룹 ID 예약
|
schedulingGroupId | string |
그룹 ID 예약 |
|
마지막으로 수정한 날짜
|
lastModifiedBy | LastModifiedBy |
마지막으로 수정한 날짜 |
|
공유 Shift
|
sharedShift | SharedShift |
교대 근무의 공유 버전 |
|
임시 교대 근무
|
draftShift | DraftShift |
교대 근무의 예비 버전 |
SharedShift
교대 근무의 공유 버전
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표시 이름
|
displayName | string |
표시 이름 |
|
비고
|
notes | string |
비고 |
|
시작 시간부터
|
startDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Theme
|
theme | string |
Theme |
|
activities
|
activities | Activities |
교대 근무 활동 |
DraftShift
교대 근무의 예비 버전
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표시 이름
|
displayName | string |
표시 이름 |
|
비고
|
notes | string |
비고 |
|
시작 시간부터
|
startDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
Theme
|
theme | string |
Theme |
|
activities
|
activities | Activities |
교대 근무 활동 |
ScheduleResponse
엔터티 예약
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
일정 ID
|
id | string |
일정의 고유 ID입니다. |
|
표준 시간대 예약
|
timeZone | string |
일정의 표준 시간대입니다. |
|
프로비전 상태 예약
|
provisionStatus | string |
일정의 프로비전 상태입니다. |
|
프로비전 상태 코드 예약
|
provisionStatusCode | string |
일정의 프로비전 상태 코드입니다. |
CreateATeamResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
새 팀 ID
|
newTeamId | string |
방금 만든 팀의 팀 ID |
PostToConversationResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 ID
|
id | string |
고유 메시지 ID |
|
메시지 링크
|
messageLink | string |
Microsoft Teams의 메시지에 연결 |
|
대화 식별자
|
conversationId | string |
채팅의 고유 식별자 |
Activities
교대 근무 활동
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
지불
|
isPaid | boolean |
지불 |
|
시작 시간부터
|
startDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
종료 시간
|
endDateTime | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
코드
|
code | string |
코드 |
|
표시 이름
|
displayName | string |
표시 이름 |
SchedulingGroupResponse
그룹 엔터티 예약
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
예약 그룹의 고유 ID입니다. |
|
표시 이름
|
displayName | string |
예약 그룹의 표시 이름입니다. |
|
활성 상태
|
isActive | boolean |
새 엔터티를 만들거나 기존 엔터티를 업데이트할 때 예약 그룹을 사용할 수 있는지 여부를 나타냅니다. |
|
사용자 ID
|
userIds | array of string |
예약 그룹의 사용자 ID 목록입니다. |
AtMentionUser_V1
@mention 토큰
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
@mention
|
atMention | string |
@mention 사용자에 대한 토큰입니다. 이 속성은 메시지에 삽입할 수 있습니다. |
AtMentionTagResponse
@mention 태그에 대한 토큰
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
@mention 태그
|
atMention | string |
태그에 대한 토큰입니다 @mention. 사람이 보낸 메시지 및 적응형 카드에 삽입할 수 있습니다. |
NewChatResponse
생성된 새 채팅에 대한 응답
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
대화 식별자
|
id | string |
채팅의 고유 식별자 |
NewMeetingRespone
생성된 새 모임에 대한 응답
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
이벤트에 대한 고유 식별자 |
|
만든 타임스탬프
|
createdDateTime | string |
이벤트가 만들어진 타임스탬프 |
|
마지막으로 수정한 타임스탬프
|
lastModifiedDateTime | string |
이벤트가 마지막으로 수정된 타임스탬프 |
|
카테고리
|
categories | array of |
이벤트와 연결된 범주 |
|
시간대
|
timeZone | string |
이벤트의 표준 시간대 |
|
사전 이벤트 미리 알림 시간
|
reminderMinutesBeforeStart | integer |
미리 알림 경고가 발생하는 이벤트 시작 시간 전의 시간(분) |
|
미리 알림 사용
|
isReminderOn | boolean |
사용자에게 이벤트를 알리도록 경고가 설정된 경우 true로 설정 |
|
첨부 파일 있음
|
hasAttachments | boolean |
이벤트에 첨부 파일이 있는 경우 true로 설정 |
|
주제
|
subject | string |
이벤트 제목 줄의 텍스트 |
|
본문 미리 보기
|
bodyPreview | string |
이벤트와 연결된 메시지의 미리 보기 |
|
중요도
|
importance | string |
이벤트의 중요도입니다. 가능한 값은 낮음, 보통, 높음입니다. |
|
민감도
|
sensitivity | string |
이벤트의 민감도 |
|
하루 종일
|
isAllDay | boolean |
이벤트가 하루 종일 지속되는 경우 true로 설정 |
|
취소됨
|
isCancelled | boolean |
이벤트가 취소된 경우 true로 설정 |
|
이끌이인가요?
|
isOrganizer | boolean |
일정 소유자가 이벤트의 이끌이인 경우 true로 설정 |
|
요청된 응답
|
responseRequested | boolean |
이끌이는 초대된 사람에게 이벤트에 대한 응답을 보내려고 합니다. |
|
다음으로 표시
|
showAs | string |
표시할 상태입니다. 가능한 값은 무료, 미정, 없음, 똥, workingElsewhere, 알 수 없음입니다. |
|
유형
|
type | string |
이벤트 유형입니다. 가능한 값은 singleInstance, occurrence, exception, seriesMaster입니다. |
|
마지막 웹
|
webLink | string |
웹의 Outlook에서 이벤트를 열 URL입니다. |
|
온라인 모임 URL
|
onlineMeetingUrl | string |
온라인 모임의 URL |
|
새 시간 제안 허용
|
allowNewTimeProposals | boolean |
모임 이끌이가 초대자가 응답할 때 새 시간을 제안할 수 있도록 허용하면 True입니다. |
|
되풀이
|
recurrence.pattern | object |
이벤트의 빈도 |
|
되풀이 범위
|
recurrence.range | object |
이벤트 기간 |
|
응답
|
responseStatus.response | string |
응답 유형입니다. 가능한 값은 none, Organizer, tentativelyAccepted, accepted, declined, notResponded입니다. |
|
시간
|
responseStatus.time | string |
응답이 반환된 날짜 및 시간 |
|
콘텐츠 형식
|
body.contentType | string |
콘텐츠의 형식입니다. 가능한 값은 텍스트 및 html입니다. |
|
이벤트 메시지 콘텐츠
|
body.content | string |
이벤트의 내용 |
|
날짜 및 시간
|
start.dateTime | string |
이벤트의 시작 시간(예: '2017-08-29T04:00:00') |
|
날짜 및 시간
|
end.dateTime | string |
이벤트의 종료 시간(예: '2017-08-29T04:00:00') |
|
display name(표시 이름)
|
location.displayName | string |
위치와 연결된 이름입니다. |
|
참석자
|
attendees | array of object |
이벤트에 대한 참석자의 컬렉션입니다. |
|
type
|
attendees.type | string |
참석자 유형: 필수, 선택 사항, 리소스 |
|
response
|
attendees.status.response | string |
응답 유형입니다. 가능한 값은 none, Organizer, tentativelyAccepted, accepted, declined, notResponded입니다. |
|
time
|
attendees.status.time | string |
응답이 반환된 날짜 및 시간 |
|
이름
|
attendees.emailAddress.name | string |
참석자의 표시 이름 |
|
address
|
attendees.emailAddress.address | string |
참석자의 전자 메일 주소 |
|
이름
|
organizer.emailAddress.name | string |
이끌이의 표시 이름 |
|
address
|
organizer.emailAddress.address | string |
이끌이의 전자 메일 주소 |
|
조인 URL
|
onlineMeeting.joinUrl | string |
온라인 모임을 시작하는 외부 링크 |
최근 수정자
마지막으로 수정한 날짜
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Application
|
application | string |
Application |
|
Device
|
device | string |
Device |
|
대화
|
conversation | string |
대화 |
|
아이디
|
user.id | string |
아이디 |
|
표시 이름
|
user.displayName | string |
표시 이름 |
MemberSettings
멤버가 특정 작업을 수행할 수 있는지 여부를 구성하는 설정(예: 팀에서 채널 만들기 및 봇 추가)
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
구성원은 채널을 만들거나 업데이트할 수 있습니다.
|
allowCreateUpdateChannels | boolean |
true로 설정하면 멤버가 채널을 추가하고 업데이트할 수 있습니다. |
|
구성원은 채널을 삭제할 수 있습니다.
|
allowDeleteChannels | boolean |
true로 설정하면 멤버가 채널을 삭제할 수 있습니다. |
|
멤버는 앱을 추가/제거할 수 있습니다.
|
allowAddRemoveApps | boolean |
true로 설정하면 멤버가 앱을 추가 및 제거할 수 있습니다. |
|
멤버는 탭 만들기/업데이트/제거가 허용됩니다.
|
allowCreateUpdateRemoveTabs | boolean |
true로 설정하면 멤버가 탭을 추가, 업데이트 및 제거할 수 있습니다. |
|
멤버는 커넥터 만들기/업데이트/제거가 허용됩니다.
|
allowCreateUpdateRemoveConnectors | boolean |
true로 설정하면 멤버가 커넥터를 추가, 업데이트 및 제거할 수 있습니다. |
GuestSettings
게스트가 팀에서 채널을 만들거나 업데이트하거나 삭제할 수 있는지 여부를 구성하는 설정
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
게스트는 채널을 만들거나 업데이트할 수 있습니다.
|
allowCreateUpdateChannels | boolean |
true로 설정하면 게스트가 채널을 추가하고 업데이트할 수 있습니다. |
|
게스트는 채널을 삭제할 수 있습니다.
|
allowDeleteChannels | boolean |
true로 설정하면 게스트가 채널을 삭제할 수 있습니다. |
MessagingSettings
팀에서 메시징 및 멘션을 구성하는 설정
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자가 메시지를 편집할 수 있도록 허용
|
allowUserEditMessages | boolean |
true로 설정하면 사용자가 메시지를 편집할 수 있습니다. |
|
사용자가 메시지를 삭제하도록 허용
|
allowUserDeleteMessages | boolean |
true로 설정하면 사용자가 메시지를 삭제할 수 있습니다. |
|
소유자가 메시지를 삭제하도록 허용
|
allowOwnerDeleteMessages | boolean |
true로 설정하면 소유자는 메시지를 삭제할 수 있습니다. |
|
팀 멘션 허용
|
allowTeamMentions | boolean |
true @team 로 설정하면 멘션이 허용됩니다. |
|
채널 멘션 허용
|
allowChannelMentions | boolean |
true @channel 로 설정하면 멘션이 허용됩니다. |
FunSettings
팀에서 Giphy, 밈 및 스티커 사용을 구성하는 설정
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Giphy 허용
|
allowGiphy | boolean |
true로 설정하면 Giphy 사용을 사용하도록 설정합니다. |
|
Giphy 콘텐츠 등급
|
giphyContentRating | string |
Giphy 콘텐츠 등급입니다. 가능한 값은 보통, 엄격한 값입니다. |
|
스티커와 밈 허용
|
allowStickersAndMemes | boolean |
true로 설정하면 사용자가 스티커와 밈을 포함할 수 있습니다. |
|
사용자 지정 밈 허용
|
allowCustomMemes | boolean |
true로 설정하면 사용자가 사용자 지정 밈을 포함할 수 있습니다. |
DiscoverySettings
다른 사용자가 팀 검색 가능성을 구성하는 설정입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
팀의 검색 및 제안에 표시
|
showInTeamsSearchAndSuggestions | boolean |
true로 설정하면 Teams 클라이언트의 검색 및 제안을 통해 팀이 표시됩니다. |