이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Microsoft Teams

통합 버전: 23.0

이 문서에서는 Microsoft Teams를 Google Security Operations (Google SecOps)와 통합하는 방법을 안내합니다.

Google Security Operations와 연동되도록 Microsoft Teams 통합 구성

통합 구성에 사용되는 계정에 Microsoft Teams 라이선스가 사용 설정되어 있는지 확인합니다. 이렇게 하려면 Microsoft 관리 센터로 이동하여 필요한 사용자에게 적용된 라이선스를 확인하세요.
필요한 사용자에게 라이선스가 있는지 확인한 후 Microsoft Teams용 앱을 만들기 시작할 수 있습니다. 먼저 Azure Active Directory > 앱 등록으로 이동해야 합니다.
새 등록을 클릭하고 다음을 제공합니다.
- Teams 앱의 이름
- 리디렉션 URI: 'https://localhost'
리디렉션 URI는 프로세스에서 나중에 필요하므로 어딘가에 저장해 두세요.
개요 페이지로 이동하여 다음을 복사합니다.
- 애플리케이션 (클라이언트) ID: 통합 구성의 '클라이언트 ID' 매개변수에 해당합니다.
- 디렉터리 (테넌트) ID: 통합 구성의 '테넌트' 매개변수에 해당합니다.
필요한 권한을 추가합니다. 적용된 모든 권한이 '위임됨'이며 다음과 같이 표시됩니다.

권한에 대한 관리자 동의를 부여해야 합니다.
인증서 및 보안 비밀 탭으로 이동하여 새 클라이언트 보안 비밀번호를 추가합니다. 클라이언트 보안 비밀번호가 생성되면 값 열에서 데이터를 복사해야 합니다. 이 값은 통합 구성의 '클라이언트 보안 비밀번호' 매개변수에 필요합니다.
Google SecOps SOAR 구성 페이지로 이동하여 다음 매개변수를 입력합니다.
- 클라이언트 ID
- 클라이언트 보안 비밀번호
- 리디렉션 URI
- 테넌트
'새로고침 토큰' 매개변수의 자리표시자 문자열을 입력하고 구성을 저장합니다.
케이스 탭으로 이동하여 케이스를 엽니다. 케이스가 없는 경우 시뮬레이션할 수 있습니다.
케이스에서 알림을 선택하고 수동 작업을 클릭합니다.
Microsoft Teams 통합으로 이동하여 '인증 받기' 작업을 실행합니다. 이 작업은 앱에 인증하는 데 사용되는 링크를 생성합니다.
결과를 확인하려면 케이스 월 탭으로 이동하여 결과 보기를 클릭합니다.

다음과 비슷한 결과가 출력됩니다.
작업에서 제공하는 링크를 클릭합니다. 이 통합에 사용되는 사용자로 로그인해야 합니다. 브라우저에서 링크를 열면 다른 페이지로 리디렉션됩니다. 이 페이지는 다음과 같이 표시됩니다. https://localhost/?code=0.ATwAylKP1BpbCEeO0…&session_state=a149d18b-4131-4649-8956-2f0d09a98743# Copy everything till "&session_state"(예): https://localhost/?code=0.ATwAylKP1BpbCEeO0…
'토큰 생성' 작업을 실행합니다.
케이스 월 탭으로 이동하여 결과를 확인합니다. 출력 메시지에서 토큰을 확인할 수 있습니다. 이 토큰을 복사하여 '새로고침 토큰' 매개변수에 붙여넣습니다.
모든 작업을 올바르게 완료했다면 녹색 체크표시가 표시됩니다.

Google SecOps에서 Microsoft Teams 통합 구성

Google SecOps에서 통합을 구성하는 방법에 대한 자세한 내용은 통합 구성을 참고하세요.

통합 매개변수

다음 매개변수를 사용하여 통합을 구성합니다.

매개변수 이름	유형	기본값	필수 항목	설명
인스턴스 이름	문자열	해당 사항 없음	No	통합을 구성할 인스턴스의 이름입니다.
설명	문자열	해당 사항 없음	No	인스턴스에 대한 설명입니다.
클라이언트 ID	문자열	해당 사항 없음	예	해당 사항 없음
보안 비밀 ID	비밀번호	해당 사항 없음	예	해당 사항 없음
테넌트	문자열	해당 사항 없음	예	해당 사항 없음
갱신 토큰	비밀번호	해당 사항 없음	예	해당 사항 없음
리디렉션 URL	문자열	http://localhost	아니요	통합을 인증하는 데 사용될 리디렉션 URL을 지정합니다. 기본값은 http://localhost입니다. 이 매개변수는 '승인 가져오기' 및 '토큰 생성' 작업에 영향을 미칩니다.

작업

응답 대기

설명

작업은 지정된 메시지에서 예상되는 답장을 기다립니다.

이 작업은 비동기식으로 실행됩니다. 필요에 따라 Google SecOps IDE에서 작업의 스크립트 제한 시간 값을 조정합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	팀 이름을 지정합니다.
채널 이름	문자열	해당 사항 없음	예	채널 이름을 지정합니다.
메시지 ID	문자열	해당 사항 없음	예	답장이 있을 것으로 예상되는 메시지의 ID를 지정합니다.
예상 답장	문자열	해당 사항 없음	예	예상되는 답장의 텍스트를 지정합니다. 이 값이 제공되지 않으면 작업은 모든 대답에서 실행을 중지합니다.
대기 메서드	DDL	첫 번째 답장 확인 가능한 값은 다음과 같습니다. 첫 번째 답장 확인 제한 시간까지 대기	아니요	작업의 대기 메서드를 지정합니다. 첫 번째 답장 확인을 선택하면 작업에서 첫 번째 답장을 반환하거나 예상 값과 비교합니다. 시간 제한까지 대기를 선택하면 작업은 시간 제한에 도달할 때까지 예상 값을 기다리거나 시간 제한 기간 동안 전송된 모든 메시지를 반환합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

토큰 생성

설명

이전 단계에서 수신한 승인 URL을 사용하여 액세스 토큰을 가져옵니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
승인 URL	문자열	해당 사항 없음	예	이전 단계에서 수신한 승인 URL을 사용하여 액세스 토큰을 요청합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_connected	True/False	is_connected:False

승인 가져오기

설명

작업을 실행하고 수신된 URL로 이동합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
리디렉션 URL	문자열	해당 사항 없음	예	이전 단계에서 수신한 승인 URL을 사용하여 액세스 토큰을 요청합니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_connected	True/False	is_connected:false

팀 ID 가져오기

설명

특정 팀의 속성을 가져옵니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	팀 이름입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

사용자 세부정보 가져오기

설명

특정 사용자의 속성과 관계를 가져옵니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
사용자 이름	문자열	해당 사항 없음	예	Microsoft 팀의 사용자 이름

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
    "isResourceAccount": null,
    "mailNickname": "username.co#EXT#",
    "surname": null,
    "deletedDateTime": null,
    "assignedLicenses": [{
        "skuId": "16ddbbfc-09ea-4de2-b1d7-312db6112d70",
        "disabledPlans": []
    }],
    "userPrincipalName": "username.co#EXT#@tenant.onmicrosoft.com",
    "faxNumber": null,
    "consentProvidedForMinor": null,
    "userType": "Member",
    "officeLocation": null,
    "usageLocation": "IL",
    "city": null,
    "employeeId": null,
    "onPremisesImmutableId": null,
    "preferredLanguage": null,
    "streetAddress": null,
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users/$entity",
    "id": "5e457a85-a705-4b65-8a9f-3a3d2ad7715c",
    "state": null,
    "businessPhones": [],
    "postalCode": null,
    "mail": "john_doe@example.com",
    "onPremisesSamAccountName": null,
    "onPremisesLastSyncDateTime": null,
    "accountEnabled": true,
    "mobilePhone": null,
    "refreshTokensValidFromDateTime": "2018-11-12T13:28:53Z",
    "companyName": null,
    "deviceKeys": [],
    "jobTitle": null,
    "preferredDataLocation": null,
    "showInAddressList": false,
    "department": null,
    "proxyAddresses": ["SMTP:mail"],
    "externalUserStateChangeDateTime": "2018-11-12T13:29:41Z",
    "onPremisesProvisioningErrors": [],
    "legalAgeGroupClassification": null,
    "onPremisesSyncEnabled": null,
    "onPremisesExtensionAttributes": {
        "extensionAttribute4": null,
        "extensionAttribute5": null,
        "extensionAttribute6": null,
        "extensionAttribute7": null,
        "extensionAttribute12": null,
        "extensionAttribute1": null,
        "extensionAttribute2": null,
        "extensionAttribute3": null,
        "extensionAttribute10": null,
        "extensionAttribute11": null,
        "extensionAttribute8": null,
        "extensionAttribute9": null,
        "extensionAttribute14": null,
        "extensionAttribute15": null,
        "extensionAttribute13": null
    },
    "assignedPlans": [{
        "capabilityStatus": "Enabled",
        "servicePlanId":
        "617d9209-3b90-4879-96e6-838c42b2701d",
        "service": "MicrosoftCommunicationsOnline",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }, {
        "capabilityStatus": "Enabled",
        "servicePlanId": "902b47e5-dcb2-4fdc-858b-c63a90a2bdb9",
        "service": "SharePoint",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }, {
        "capabilityStatus": "Enabled",
        "servicePlanId": "4fa4026d-ce74-4962-a151-8e96d57ea8e4",
        "service": "TeamspaceAPI",
        "assignedDateTime": "2018-11-12T13:28:57Z"
    }],
    "passwordProfile": null,
    "passwordPolicies": null,
    "externalUserState": "Accepted",
    "otherMails": ["mail"],
    "displayName": "name",
    "imAddresses": [],
    "provisionedPlans": [{
        "capabilityStatus": "Enabled",
        "provisioningStatus": "Success",
        "service": "SharePoint"
    }],
    "createdDateTime": "2018-11-12T13:28:53Z",
    "country": null,
    "onPremisesDistinguishedName": null,
    "onPremisesSecurityIdentifier": null,
    "onPremisesDomainName": null,
    "onPremisesUserPrincipalName": null,
    "givenName": null,
    "ageGroup": null
}

채널 나열

설명

특정 팀에 있는 모든 채널의 세부정보를 가져옵니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	팀 이름입니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
all_channels_details	해당 사항 없음	해당 사항 없음

팀 나열

설명

모든 팀의 세부정보를 가져옵니다.

매개변수

이 작업에는 입력 매개변수가 없습니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
팀	해당 사항 없음	해당 사항 없음

JSON 결과

[
    {
        "mailNickname": "Test",
        "classification": null,
        "deletedDateTime": null,
        "renewedDateTime": "2018-11-12T15:03:50Z",
        "onPremisesProvisioningErrors": [],
        "membershipRuleProcessingState": null,
        "preferredLanguage": null,
        "expirationDateTime": null,
        "id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
        "theme": null,
        "preferredDataLocation": null,
        "mail": "john_doe@example.com",
        "membershipRule": null,
        "onPremisesLastSyncDateTime": null,
        "description": "Test",
        "securityEnabled": false,
        "proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
        "visibility": "Public",
        "resourceProvisioningOptions": ["Team"],
        "displayName": "Test",
        "groupTypes": ["Unified"],
        "onPremisesSyncEnabled": null,
        "createdDateTime": "2018-11-12T15:03:50Z",
        "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
        "onPremisesSecurityIdentifier": null,
        "mailEnabled": true
    }, {
        "mailNickname": "user",
        "classification": null,
        "deletedDateTime": null,
        "renewedDateTime": "2018-11-28T13:46:50Z",
        "onPremisesProvisioningErrors": [],
        "membershipRuleProcessingState": null,
        "preferredLanguage": null,
        "expirationDateTime": null,
        "id": "67149c85-7139-4062-bfae-059d18ee7e5d",
        "theme": null,
        "preferredDataLocation": null,
        "mail": "john_doe@example.com",
        "membershipRule": null,
        "onPremisesLastSyncDateTime": null,
        "description": "user",
        "securityEnabled": false, "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
        "visibility": "Public",
        "resourceProvisioningOptions": ["Team"],
        "displayName": "user",
        "groupTypes": ["Unified"],
        "onPremisesSyncEnabled": null,
        "createdDateTime": "2018-11-28T13:46:50Z",
        "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
        "onPremisesSecurityIdentifier": null,
        "mailEnabled": true
    }

사용자 표시

설명

모든 사용자의 세부정보를 가져옵니다.

매개변수

이 작업에는 입력 매개변수가 없습니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
사용자	해당 사항 없음	해당 사항 없음

JSON 결과

[{
    "mailNickname": "Test",
    "classification": null,
    "deletedDateTime": null,
    "renewedDateTime": "2018-11-12T15:03:50Z",
    "onPremisesProvisioningErrors": [],
    "membershipRuleProcessingState": null,
    "preferredLanguage": null,
    "expirationDateTime": null,
    "id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
    "theme": null,
    "preferredDataLocation": null,
    "mail": "john_doe@example.com",
    "membershipRule": null,
    "onPremisesLastSyncDateTime": null,
    "description": "Test",
    "securityEnabled": false,
    "proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
    "visibility": "Public",
    "resourceProvisioningOptions": ["Team"],
    "displayName": "Test",
    "groupTypes": ["Unified"],
    "onPremisesSyncEnabled": null,
    "createdDateTime": "2018-11-12T15:03:50Z",
    "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
    "onPremisesSecurityIdentifier": null,
    "mailEnabled": true
}, {
    "mailNickname": "user",
    "classification": null,
    "deletedDateTime": null,
    "renewedDateTime": "2018-11-28T13:46:50Z",
    "onPremisesProvisioningErrors": [],
    "membershipRuleProcessingState": null,
    "preferredLanguage": null,
    "expirationDateTime": null,
    "id": "67149c85-7139-4062-bfae-059d18ee7e5d",
    "theme": null,
    "preferredDataLocation": null,
    "mail": "john_doe@example.com",
    "membershipRule": null,
    "onPremisesLastSyncDateTime": null,
    "description": "user",
    "securityEnabled": false,
    "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
    "visibility": "Public",
    "resourceProvisioningOptions": ["Team"],
    "displayName": "user",
    "groupTypes": ["Unified"],
    "onPremisesSyncEnabled": null,
    "createdDateTime": "2018-11-28T13:46:50Z",
    "resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
    "onPremisesSecurityIdentifier": null,
    "mailEnabled": true
}]

핑

설명

연결을 테스트합니다.

매개변수

이 작업에는 입력 매개변수가 없습니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_connected	True/False	is_connected:False

메시지 보내기

설명

특정 채널에 메시지를 전송합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	팀 이름입니다.
채널 이름	문자열	해당 사항 없음	예	채널 이름입니다.
메시지	문자열	해당 사항 없음	예	Message의 적절한 하위 클래스가 아닌 경우).

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

[{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2')/messages/$entity",
    "id":"1601372154742",
    "replyToId":null,
    "etag":"1601372154742",
    "messageType":"message",
    "createdDateTime":"2020-09-29T09:35:54.742Z",
    "lastModifiedDateTime":"2020-09-29T09:35:54.742Z",
    "lastEditedDateTime":null,
    "deletedDateTime":null,
    "subject":null,
    "summary":null,
    "chatId":null,
    "importance":"normal",
    "locale":"en-us",
    "webUrl":"https://teams.microsoft.com/l/message/19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2/1601372154742?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1601372154742&parentMessageId=1601372154742",
    "policyViolation":null,
    "from":{
        "application":null,
        "device":null,
        "conversation":null,
        "user":{
            "id":"b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName":"u05D2'u05D9u05D9u05DEu05E1 u05D1u05D5u05E0u05D3",
            "userIdentityType":"aadUser"
        }},
    "body":{
        "contentType":"text",
        "content":"Hello there"
    },
    "channelIdentity":{
        "teamId":"192c0699-fad2-4d02-88a2-84efd6369894",
        "channelId":"19:e3acbb17a8754cae9df724f493b5342f@thread.tacv2"
    },
    "attachments":[],
    "mentions":[],
    "reactions":[]
}]

사용자 메시지 보내기

설명

Microsoft Teams에서 사용자에게 채팅 메시지를 보냅니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
사용자 식별자	CSV	해당 사항 없음	아니요	메시지를 보낼 사용자 식별자를 쉼표로 구분된 목록으로 지정합니다. 참고: 이 작업은 이 매개변수에 제공된 유효한 항목과 값을 결합하여 모든 항목에 메시지를 전송합니다.
텍스트	문자열	해당 사항 없음	예	메시지 내용을 지정합니다.
응답 대기	체크박스	선택	예	사용 설정하면 작업은 모든 항목의 답장이 제공될 때까지 기다립니다.
콘텐츠 유형	DDL	선택됨	예	메일의 콘텐츠 유형을 지정합니다.
사용자 선택	DDL	텍스트 가능한 값은 다음과 같습니다. 텍스트 HTML	항목 및 사용자 식별자 가능한 값은 다음과 같습니다. 항목 및 사용자 식별자 항목에서 사용자 식별자	사용자에게 사용해야 하는 선택 유형을 지정합니다. '엔티티 및 사용자 식별자'를 선택하면 작업에서 관련 엔티티와 '사용자 식별자' 매개변수에 제공된 값을 모두 검색합니다. '항목에서'이 제공되면 작업은 관련 항목에만 작동하며 '사용자 식별자' 매개변수에 제공된 값은 무시됩니다. '사용자 식별자'를 선택하면 '사용자 식별자'의 값만 사용할 수 있으며 '사용자 식별자' 매개변수가 필수 항목이 됩니다.

실행

이 작업은 다음 항목에서 실행됩니다.

사용자 이름
이메일 주소

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
    "id": "1632820681737",
    "replyToId": null,
    "etag": "1632820681737",
    "messageType": "message",
    "createdDateTime": "2021-09-28T09:18:01.737Z",
    "lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "user": {
            "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName": "ג'יימס בונד",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "qqq"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams에서 다음 사용자에게 메시지를 보냈습니다. {entity.identifier}.' 엔티티와 연결된 채팅을 찾을 수 없는 경우 (is_success = true): 'Microsoft Teams: {entity.identifier}의 다음 사용자에게 메시지를 보낼 수 없습니다.' 엔티티가 있는 모든 채팅을 찾을 수 없는 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자에게 전송된 메시지가 없습니다.' 비동기 메시지: '다음 사용자의 답장을 기다리고 있습니다: {entity.identifier}.' 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Send User Message". 이유: {0}'.format(error.Stacktrace) 제한 시간이 초과된 경우: ''사용자 메시지 보내기' 작업 실행 중에 오류가 발생했습니다. 이유: 메시지가 전송되었지만 다음 사용자의 답장을 기다리는 동안 작업 제한 시간이 초과되었습니다. {entity.identifier}' IDE에서 제한 시간을 늘린 후 다시 시도하세요. 참고: 작업을 다시 시도하면 다른 메시지가 전송됩니다.	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams에서 다음 사용자에게 메시지를 보냈습니다. {entity.identifier}.'

엔티티와 연결된 채팅을 찾을 수 없는 경우 (is_success = true): 'Microsoft Teams: {entity.identifier}의 다음 사용자에게 메시지를 보낼 수 없습니다.'

엔티티가 있는 모든 채팅을 찾을 수 없는 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자에게 전송된 메시지가 없습니다.'

비동기 메시지:

'다음 사용자의 답장을 기다리고 있습니다: {entity.identifier}.'

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Send User Message". 이유: {0}'.format(error.Stacktrace)

제한 시간이 초과된 경우: ''사용자 메시지 보내기' 작업 실행 중에 오류가 발생했습니다. 이유: 메시지가 전송되었지만 다음 사용자의 답장을 기다리는 동안 작업 제한 시간이 초과되었습니다. {entity.identifier}' IDE에서 제한 시간을 늘린 후 다시 시도하세요. 참고: 작업을 다시 시도하면 다른 메시지가 전송됩니다.

일반

채널 만들기

설명

Microsoft Teams에서 채널을 만듭니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	채널을 만들어야 하는 팀의 이름을 지정합니다.
채널 이름	문자열	해당 사항 없음	예	채널의 고유한 이름을 지정합니다.
채널 유형	DDL	표준 가능한 값은 다음과 같습니다. 표준 비공개	예	만들어야 하는 채널의 유형을 지정합니다. 표준 채널은 팀의 모든 구성원이 액세스할 수 있지만 비공개 채널은 사용자를 추가해야 합니다.
설명	문자열	해당 사항 없음	아니요	채널의 설명을 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('c084d2c7-a7e6-47a5-921b-0c32c3ab41d1')/channels/$entity",
    "id": "19:92ce922c1790450fae81f6713dbffbe3@thread.tacv2",
    "createdDateTime": "2021-11-18T11:37:39.8186647Z",
    "displayName": "Architecturea Discussion",
    "description": null,
    "isFavoriteByDefault": false,
    "email": "",
    "webUrl": "https://teams.microsoft.com/l/channel/19%3a92ce922c1790450fae81f6713dbffbe3%40thread.tacv2/Architecturea+Discussion?groupId=c084d2c7-a7e6-47a5-921b-0c32c3ab41d1&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a",
    "membershipType": "standard"
}

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{team name}' 팀에서 '{channel name}' 채널을 만들었습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Create Channel". 이유: {0}'.format(error.Stacktrace) 팀을 찾을 수 없는 경우: "'채널 만들기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다. 400 상태 코드가 보고된 경우: '채널 만들기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {innerError/message}	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{team name}' 팀에서 '{channel name}' 채널을 만들었습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Create Channel". 이유: {0}'.format(error.Stacktrace)

팀을 찾을 수 없는 경우: "'채널 만들기' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다.

400 상태 코드가 보고된 경우: '채널 만들기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {innerError/message}

일반

채널 삭제

설명

Microsoft Teams에서 채널을 삭제합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	채널을 삭제해야 하는 팀의 이름을 지정합니다.
채널 이름	문자열	해당 사항 없음	예	삭제해야 하는 채널의 이름을 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 204 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{team name}' 팀에서 '{channel name}' 채널을 삭제했습니다.' 채널을 찾을 수 없는 경우 (is_success = true): 'Microsoft Teams의 팀 '{team name}'에 채널 '{channel name}'이 이미 없습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Delete Channel". 이유: {0}'.format(error.Stacktrace) 팀을 찾을 수 없는 경우: "'채널 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다.	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

204 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{team name}' 팀에서 '{channel name}' 채널을 삭제했습니다.'

채널을 찾을 수 없는 경우 (is_success = true): 'Microsoft Teams의 팀 '{team name}'에 채널 '{channel name}'이 이미 없습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Delete Channel". 이유: {0}'.format(error.Stacktrace)

팀을 찾을 수 없는 경우: "'채널 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다.

일반

채널에 사용자 추가

설명

Microsoft Teams의 비공개 채널에 사용자를 추가합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	채널을 검색할 팀의 이름을 지정합니다.
채널 이름	문자열	해당 사항 없음	예	사용자를 추가할 채널의 이름을 지정합니다.

실행

이 작업은 다음 항목에서 실행됩니다.

사용자 이름
이메일 주소

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 항목 하나에 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{팀 이름}' 팀에 속한 '{채널 이름}' 채널에 다음 사용자를 추가했습니다. {entity.identifier}' 항목 하나에 대해 사용자를 찾을 수 없는 경우 (is_success = true): '작업이 Microsoft Teams: {entity.identifier}에서 다음 사용자를 찾을 수 없습니다.' 항목 하나에 400 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{팀 이름}' 팀에 있는 '{채널 이름}' 채널에 다음 사용자를 추가할 수 없습니다: {entity.identifier}. 사용자가 '{팀 이름}' 팀에 속해 있는지 확인합니다. 일부 사용자를 찾을 수 없는 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자를 찾을 수 없습니다.' 모두에 대해 400 상태 코드가 보고된 경우 (is_success = false): 'Microsoft Teams의 '{team name}' 팀에서 제공된 사용자를 '{Channel Name}' 채널에 추가할 수 없습니다. 사용자가 '{팀 이름}' 팀에 속해 있는지 확인합니다. 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: ''채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace) 팀을 찾을 수 없는 경우: "'채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다. 채널을 찾을 수 없는 경우: "'채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {채널 이름}인 채널을 찾을 수 없습니다. 채널의 'membershipType'이 'private'이 아닌 경우: ''채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 이름이 {채널 이름}인 채널이 비공개가 아닙니다.	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

항목 하나에 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{팀 이름}' 팀에 속한 '{채널 이름}' 채널에 다음 사용자를 추가했습니다. {entity.identifier}'

항목 하나에 대해 사용자를 찾을 수 없는 경우 (is_success = true): '작업이 Microsoft Teams: {entity.identifier}에서 다음 사용자를 찾을 수 없습니다.'

항목 하나에 400 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{팀 이름}' 팀에 있는 '{채널 이름}' 채널에 다음 사용자를 추가할 수 없습니다: {entity.identifier}. 사용자가 '{팀 이름}' 팀에 속해 있는지 확인합니다.

일부 사용자를 찾을 수 없는 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자를 찾을 수 없습니다.'

모두에 대해 400 상태 코드가 보고된 경우 (is_success = false): 'Microsoft Teams의 '{team name}' 팀에서 제공된 사용자를 '{Channel Name}' 채널에 추가할 수 없습니다. 사용자가 '{팀 이름}' 팀에 속해 있는지 확인합니다.

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: ''채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

팀을 찾을 수 없는 경우: "'채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다.

채널을 찾을 수 없는 경우: "'채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {채널 이름}인 채널을 찾을 수 없습니다.

채널의 'membershipType'이 'private'이 아닌 경우: ''채널에 사용자 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 이름이 {채널 이름}인 채널이 비공개가 아닙니다.

일반

채널에서 사용자 삭제

설명

Microsoft Teams의 비공개 채널에서 사용자를 삭제합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	채널을 검색할 팀의 이름을 지정합니다.
채널 이름	문자열	해당 사항 없음	예	사용자를 삭제할 채널의 이름을 지정합니다.

실행

이 작업은 다음 항목에서 실행됩니다.

사용자 이름
이메일 주소 (이메일 정규식과 일치하는 사용자 이름)

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 하나의 항목에 대해 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{팀 이름}' 팀에 있는 '{채널 이름}' 채널에서 다음 사용자를 삭제했습니다. {entity.identifier}' 사용자가 채널에 속하지 않는 경우 (is_success = true): '다음 사용자는 이미 Microsoft Teams의 '{팀 이름}' 팀에 있는 '{채널 이름}' 채널에 속하지 않습니다. {entity.identifier}' 모든 사용자가 채널에 속하지 않는 경우 (is_success = true): '제공된 사용자 중 Microsoft Teams의 '{팀 이름}' 팀에 속한 사용자가 '{채널 이름}' 채널에 속하지 않습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Remove Users From Channel". 이유: {0}'.format(error.Stacktrace) 팀을 찾을 수 없는 경우: "'채널에서 사용자 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다. 채널을 찾을 수 없는 경우: "'채널에서 사용자 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {채널 이름}인 채널을 찾을 수 없습니다. 채널의 'membershipType'이 'private'이 아닌 경우: ''채널에서 사용자 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 이름이 {채널 이름}인 채널이 비공개가 아닙니다.	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

하나의 항목에 대해 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams의 '{팀 이름}' 팀에 있는 '{채널 이름}' 채널에서 다음 사용자를 삭제했습니다. {entity.identifier}'

사용자가 채널에 속하지 않는 경우 (is_success = true): '다음 사용자는 이미 Microsoft Teams의 '{팀 이름}' 팀에 있는 '{채널 이름}' 채널에 속하지 않습니다. {entity.identifier}'

모든 사용자가 채널에 속하지 않는 경우 (is_success = true): '제공된 사용자 중 Microsoft Teams의 '{팀 이름}' 팀에 속한 사용자가 '{채널 이름}' 채널에 속하지 않습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Remove Users From Channel". 이유: {0}'.format(error.Stacktrace)

팀을 찾을 수 없는 경우: "'채널에서 사용자 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {team, name}인 팀을 찾을 수 없습니다.

채널을 찾을 수 없는 경우: "'채널에서 사용자 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: Microsoft Teams에서 이름이 {채널 이름}인 채널을 찾을 수 없습니다.

채널의 'membershipType'이 'private'이 아닌 경우: ''채널에서 사용자 삭제' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 이름이 {채널 이름}인 채널이 비공개가 아닙니다.

일반

채팅 만들기

설명

Microsoft Teams에서 사용자 채팅을 만듭니다.

매개변수

이 작업에는 입력 매개변수가 없습니다.

실행

이 작업은 다음 항목에서 실행됩니다.

사용자 이름
이메일 주소 (이메일 정규식과 일치하는 사용자 이름)

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats/$entity",
    "id": "19:b786d3cf-e97d-4511-b61c-0559e9f4da75_cb786032-1ba9-439a-b714-99286e185921@unq.gbl.spaces",
    "topic": null,
    "createdDateTime": "2021-10-13T11:24:15.696Z",
    "lastUpdatedDateTime": "2021-10-13T11:24:15.696Z",
    "chatType": "oneOnOne"
}

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams에서 다음 사용자와 채팅을 만들었습니다. {entities}' 사용자를 찾을 수 없는 경우 (is_success = true): 'Microsoft Teams에서 다음 사용자를 찾을 수 없습니다: {entities}' 모든 사용자를 찾을 수 없는 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자를 찾을 수 없습니다: {entities}' 하나의 항목에 대해 400 상태 코드가 보고된 경우 (is_success = true): '작업에서 Microsoft Teams의 다음 사용자와 채팅을 만들 수 없습니다: {entities}' 모든 항목에 대해 400 상태 코드가 보고된 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자와 채팅을 만들 수 없습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Create Chat". 이유: {0}'.format(error.Stacktrace)	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams에서 다음 사용자와 채팅을 만들었습니다. {entities}'

사용자를 찾을 수 없는 경우 (is_success = true): 'Microsoft Teams에서 다음 사용자를 찾을 수 없습니다: {entities}'

모든 사용자를 찾을 수 없는 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자를 찾을 수 없습니다: {entities}'

하나의 항목에 대해 400 상태 코드가 보고된 경우 (is_success = true): '작업에서 Microsoft Teams의 다음 사용자와 채팅을 만들 수 없습니다: {entities}'

모든 항목에 대해 400 상태 코드가 보고된 경우 (is_success = false): 'Microsoft Teams에서 제공된 사용자와 채팅을 만들 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Create Chat". 이유: {0}'.format(error.Stacktrace)

일반

채팅 나열

설명

Microsoft Teams에서 사용 가능한 채팅을 나열합니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
채팅 유형	DDL	전체 가능한 값은 다음과 같습니다. 전체 그룹 채팅 회의 채팅 일대일 채팅	아니요	반환해야 하는 채팅 유형을 지정합니다.
필터 키	DDL	다음 중 하나를 선택하세요. 가능한 값은 다음과 같습니다. 주제 회원 표시 이름 회원 이메일	아니요	채팅을 필터링하는 데 사용해야 하는 키를 지정합니다.
필터 로직	DDL	지정되지 않음 가능한 값은 다음과 같습니다. 지정되지 않음 같음 포함	아니요	적용할 필터 로직을 지정합니다. 필터링 로직은 '필터 키' 매개변수에 제공된 값을 기반으로 작동합니다.
필터 값	문자열	해당 사항 없음	아니요	필터에 사용할 값을 지정합니다. '같음'을 선택하면 작업에서 결과 중 정확한 일치 항목을 찾으려고 시도합니다. '포함'을 선택하면 작업에서 해당 하위 문자열이 포함된 결과를 찾으려고 시도합니다. 이 매개변수에 아무것도 제공되지 않으면 필터가 적용되지 않습니다. 필터링 로직은 '필터 키' 매개변수에 제공된 값을 기반으로 작동합니다.
반환할 최대 레코드 수	정수	50	아니요	반환할 레코드 수를 지정합니다. 아무것도 제공되지 않으면 작업에서 50개의 레코드를 반환합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
    "id": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "topic": null,
    "createdDateTime": "2021-04-12T08:36:52.572Z",
    "lastUpdatedDateTime": "2021-09-28T09:31:58.045Z",
    "chatType": "oneOnOne",
    "members@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75%40unq.gbl.spaces')/members",
    "members": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyM1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTI=",
            "roles": [
                "Owner"
            ],
            "displayName": "yuriy",
            "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
            "userId": "5af81bea-9c9f-4f9f-8745-9df1fdba8e12",
            "email": null,
            "tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMember",
            "id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyNiNzg2ZDNjZi1lOTdkLTQ1MTEtYjYxYy0wNTU5ZTlmNGRhNzU=",
            "roles": [
                "Owner"
            ],
            "displayName": "ג'יימס בונד",
            "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
            "userId": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "email": "james.bond@siemplifycyarx.onmicrosoft.com",
            "tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
        }
    ]
}

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 데이터를 사용할 수 있는 경우 (is_success = true): 'Microsoft Teams에서 제공된 기준에 맞는 채팅을 찾았습니다.' 데이터를 사용할 수 없는 경우 (is_success=false): 'Microsoft Teams에서 제공된 기준에 대한 채팅을 찾을 수 없습니다.' '필터 값' 매개변수 필드가 비어 있는 경우 (is_success=true): '매개변수 '필터 값'이 비어 있어 필터가 적용되지 않았습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. '필터 키' 매개변수가 '하나 선택'으로 설정되고 '필터 논리' 매개변수가 '같음' 또는 '포함'으로 설정된 경우: '{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: '필터 키' 매개변수에서 필드를 선택해야 합니다.' '반환할 최대 레코드 수' 매개변수에 잘못된 값이 제공된 경우: '{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: '반환할 최대 레코드'에 잘못된 값이 제공되었습니다. 양수를 입력해야 합니다.' 잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우: '{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)	일반
케이스 월 테이블	표 이름: Available Chats(사용 가능한 채팅) 테이블 열: ID - id 유형 - chatType 구성원 - 구성원/표시의 CSV 이름 주제 - 주제	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

데이터를 사용할 수 있는 경우 (is_success = true): 'Microsoft Teams에서 제공된 기준에 맞는 채팅을 찾았습니다.'

데이터를 사용할 수 없는 경우 (is_success=false): 'Microsoft Teams에서 제공된 기준에 대한 채팅을 찾을 수 없습니다.'

'필터 값' 매개변수 필드가 비어 있는 경우 (is_success=true):

'매개변수 '필터 값'이 비어 있어 필터가 적용되지 않았습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

'필터 키' 매개변수가 '하나 선택'으로 설정되고 '필터 논리' 매개변수가 '같음' 또는 '포함'으로 설정된 경우:

'{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: '필터 키' 매개변수에서 필드를 선택해야 합니다.'

'반환할 최대 레코드 수' 매개변수에 잘못된 값이 제공된 경우:

'{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: '반환할 최대 레코드'에 잘못된 값이 제공되었습니다. 양수를 입력해야 합니다.'

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우:

'{작업 이름} 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

일반

케이스 월 테이블

표 이름: Available Chats(사용 가능한 채팅)

테이블 열:

ID - id
유형 - chatType
구성원 - 구성원/표시의 CSV
이름 주제 - 주제

일반

채팅 메시지 보내기

설명

Microsoft Teams에서 채팅 메시지를 보냅니다.

매개변수

매개변수 표시 이름	유형	기본값	필수 항목	설명
채팅 ID	DDL	해당 사항 없음	예	메시지를 보낼 채팅의 ID를 지정합니다.
텍스트	문자열	해당 사항 없음	예	메시지 내용을 지정합니다.
응답 대기	체크박스	선택	예	사용 설정하면 작업은 응답을 기다립니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
    "id": "1632820681737",
    "replyToId": null,
    "etag": "1632820681737",
    "messageType": "message",
    "createdDateTime": "2021-09-28T09:18:01.737Z",
    "lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "user": {
            "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
            "displayName": "ג'יימס בונד",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "qqq"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams에서 ID가 {채팅 ID}인 채팅으로 메시지를 보냈습니다.' 답장을 사용할 수 있는 경우 (is_success = true): 'Microsoft Teams의 ID {채팅 ID} 채팅에서 메시지를 보내고 답장을 받았습니다.' 비동기 메시지: 응답 대기 중... 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Send Chat Message". 이유: {0}'.format(error.Stacktrace) 404 상태 코드가 보고된 경우: ''채팅 메시지 보내기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: Microsoft Teams에서 ID가 인 채팅을 찾을 수 없습니다. 제한 시간이 초과된 경우: ''채팅 메시지 보내기' 작업 실행 중에 오류가 발생했습니다.' 이유: 메시지가 전송되었지만 답장을 기다리는 동안 작업 제한 시간이 초과되었습니다. IDE에서 제한 시간을 늘린 후 다시 시도하세요. 참고: 다시 시도하면 작업에서 다른 메시지를 보냅니다.	일반

결과 유형

값/설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

201 상태 코드가 보고된 경우 (is_success = true): 'Microsoft Teams에서 ID가 {채팅 ID}인 채팅으로 메시지를 보냈습니다.'

답장을 사용할 수 있는 경우 (is_success = true): 'Microsoft Teams의 ID {채팅 ID} 채팅에서 메시지를 보내고 답장을 받았습니다.'

비동기 메시지: 응답 대기 중...

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Send Chat Message". 이유: {0}'.format(error.Stacktrace)

404 상태 코드가 보고된 경우: ''채팅 메시지 보내기' 작업을 실행하는 중에 오류가 발생했습니다. 이유: Microsoft Teams에서 ID가 인 채팅을 찾을 수 없습니다.

제한 시간이 초과된 경우: ''채팅 메시지 보내기' 작업 실행 중에 오류가 발생했습니다.' 이유: 메시지가 전송되었지만 답장을 기다리는 동안 작업 제한 시간이 초과되었습니다. IDE에서 제한 시간을 늘린 후 다시 시도하세요. 참고: 다시 시도하면 작업에서 다른 메시지를 보냅니다.

일반

메시지 답장 보내기

설명

Microsoft Teams의 채널 메시지에 답장을 보냅니다.

매개변수

매개변수	유형	기본값	필수 항목	설명
팀 이름	문자열	해당 사항 없음	예	답장을 보낼 팀을 지정합니다.
채널 이름	문자열	해당 사항 없음	예	답장을 보낼 채널을 지정합니다.
메시지 ID	문자열	해당 사항 없음	예	답장을 보낼 메시지의 ID를 지정합니다.
콘텐츠 유형	DDL	텍스트	아니요	메일의 콘텐츠 유형을 지정합니다. 가능한 값은 다음과 같습니다. 텍스트 HTML
텍스트	문자열	해당 사항 없음	예	메시지 내용을 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예
is_success	True/False	is_success:False

JSON 결과

{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2')/messages('1686652339690')/replies/$entity",
"id": "1686653341151",
"replyToId": "1686652339690",
"etag": "1686653341151",
"messageType": "message",
"createdDateTime": "2023-06-13T10:49:01.151Z",
"lastModifiedDateTime": "2023-06-13T10:49:01.151Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2/1686653341151?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1686653341151&parentMessageId=1686652339690",
"policyViolation": null,
"eventDetail": null,
"from": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName": "ג'יימס בונד",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "text",
"content": "Reply"
},
"channelIdentity": {
"teamId": "192c0699-fad2-4d02-88a2-84efd6369894",
"channelId": "19:4649fcf41fa5417f9aa78a5840bea442@thread.tacv2"
},
"attachments": [],
"mentions": [],
"reactions": []
}

케이스 월

결과 유형	값/설명	유형
출력 메시지*	작업이 실패하거나 플레이북 실행을 중지하지 않습니다. 하나의 경우 201 (is_success = true): print 'Microsoft Teams의 메시지에 답장을 보냈습니다.' 작업이 실패하고 플레이북 실행을 중지해야 합니다. 심각한 오류가 발생한 경우: ''메시지 답장 보내기' 작업을 실행하는 중에 오류가 발생했습니다.'를 출력합니다. 이유: {0}''.format(error.Stacktrace) 팀을 찾을 수 없는 경우: print 'Error executing action "Send Message Reply". 이유: Microsoft Teams에서 이름이 {팀 이름}인 팀을 찾을 수 없습니다. 맞춤법을 확인하세요. 채널을 찾을 수 없는 경우: '메시지 답장' 작업을 실행하는 동안 오류가 발생했다고 출력합니다. 이유: Microsoft Teams에서 이름이 {채널 이름}인 채널을 찾을 수 없습니다. 맞춤법을 확인하세요. 대답에 'error'가 있는 경우: '메시지 답장' 작업을 실행하는 동안 오류가 발생했다고 출력합니다. 이유: {error.message}	일반

작업

Google 보안 운영에서 작업을 구성하려면 응답 > 작업 스케줄러로 이동합니다.

갱신 토큰 갱신 작업

갱신 토큰 갱신 작업의 목표는 통합에 사용되는 갱신 토큰을 주기적으로 업데이트하는 것입니다.

기본적으로 갱신 토큰은 90일마다 만료되므로 만료되면 통합을 사용할 수 없습니다. 갱신 토큰이 최신 상태인지 확인하려면 7일 또는 14일마다 이 작업을 실행하는 것이 좋습니다.

작업 입력

작업을 구성하려면 다음 매개변수를 사용하세요.

매개변수

로그인 API 루트

매개변수
로그인 API 루트	필수 Microsoft ID 플랫폼으로 인증하는 데 사용되는 API 루트입니다. 기본값은 `https://login.microsoftonline.com`입니다.
API 루트	필수 Microsoft Graph 인스턴스의 API 루트입니다. 기본값은 `https://graph.microsoft.com`입니다.
통합 환경	선택사항 작업이 갱신 토큰을 업데이트하는 통합 환경입니다. 이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다. 개별 값을 따옴표 (`" "`)로 묶습니다.

필수

Microsoft ID 플랫폼으로 인증하는 데 사용되는 API 루트입니다.

기본값은 https://login.microsoftonline.com입니다.

API 루트

필수

Microsoft Graph 인스턴스의 API 루트입니다.

기본값은 https://graph.microsoft.com입니다.

통합 환경

선택사항

작업이 갱신 토큰을 업데이트하는 통합 환경입니다.

이 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다. 개별 값을 따옴표 (" ")로 묶습니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.