Microsoft Teams Graph 스포크
Microsoft Teams Graph 스포크 에서 애플리케이션, 달력, 팀, 채널, 채팅, 알림 및 웹후크 Microsoft 팀를 관리합니다. 사용자 및 그룹을 만들거나 관리하거나 삭제하려면 ID 스포크(이전의 Microsoft Azure Active Directory 스포크)를 Microsoft Entra 사용합니다.
스토어에서 앱 요청
사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 ServiceNow Store 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.
- Microsoft 의 Microsoft Teams Graph 스포크 Teams는 Entra ID(이전의 Microsoft Azure Active Directory)의 Microsoft 그룹에서 만들어집니다. 를 사용하여 Microsoft Teams Graph 스포크팀을 생성하려면 연결된 그룹이 Entra ID에 있어야 합니다.
- 사용자 및 그룹 관리는 Entra ID만 사용하여 Microsoft 수행할 수 있으며 그렇지 않습니다 Microsoft Teams Graph 스포크.
- Teams는 Office 365 그룹에서만 Microsoft 만들 수 있습니다.
- 의 Microsoft 팀 팀 ID는 Entra ID에 있는 Microsoft 연결된 그룹의 그룹 ID와 동일합니다.
통합 허브 구독
이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.
스포크 버전
Microsoft Teams Graph 스포크 v4.4.1 이 최신 버전입니다.
지원되는 버전
Microsoft 그래프 REST API v1.0
스포크 종속성
- ServiceNow 통합 허브 Runtime(com.glide.hub.integration.runtime)
- Flow Designer 모델(com.glide.hub.designer_backend.model)
- 복합 객체(com.glide.cobject)
- ServiceNow 통합 허브 작업 단계 - REST(com.glide.hub.action_step.rest)
- ServiceNow 통합 허브 작업 템플릿 - 데이터 스트림(com.glide.hub.action_type.datastream)
- 원격 테이블(com.glide.script.vtable)
- ServiceNow 통합 허브 작업 단계 - 연결 정보 가져오기(com.glide.hub.action_step.get_connection_info)
스포크 플로우
Microsoft Teams Graph 스포크 인시던트에 추가된 최신 작업 메모에 대한 세부 정보와 함께 할당된 사용자에게 Microsoft Teams 채팅 메시지를 게시하는 작업을 자동화하는 방법을 보여주는 샘플 플로우인 Microsoft Teams 채팅에 ServiceNow 인시던트 작업 메모 업데이트 게시를 제공합니다.
스포크 하위 플로우
| 하위 플로우 | 설명 |
|---|---|
| 인시던트 상세 정보 게시 | Microsoft Teams 채널에 필요한 인시던트의 상세 정보를 게시합니다. |
| 인바운드 알림 처리 | 웹후크 구독에서 받은 입력 데이터를 기반으로 지정된 메시지의 상세 정보를 검색합니다. |
| 웹후크 구독 도우미 하위 플로우 갱신 | 갱신이 필요한 경우 구독을 갱신하며, 이는 입력에 따라 결정됩니다. |
| 웹후크 구독 갱신 | 모든 웹후크 구독을 검색하고 갱신이 필요한 경우 갱신합니다. |
| 웹후크 구독 | 지정된 팀의 채널에 대한 웹후크 구독을 작성합니다. |
스포크 작업
인스턴스에 Microsoft Teams Graph 스포크 인시던트가 생성되면 팀 및 채널 작업을 자동화하는 작업을 제공합니다.ServiceNow
Microsoft Teams 스포크 연결을 사용하여 일부 작업을 수행하고 나머지 작업은 Microsoft Teams Graph 클라이언트 자격 증명 연결을 사용하여 수행할 수 있습니다.
다음 테이블의 작업은 Microsoft Teams 스포크 연결 및 자격 증명 별칭 기록을 사용합니다. 이러한 작업에는 위임된 권한이 필요합니다.
| 범주 | 동작 | 설명 | 필요한 권한(최소 권한에서 최대 권한 순으로) | |
|---|---|---|---|---|
| 애플리케이션 관리 | 사용자에게 애플리케이션 설치 | 사용자의 개인 범위에 지정된 애플리케이션을 설치합니다. | 위임됨(회사 또는 학교 계정) | TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser |
| 사용자 앱 설치 조회 | 사용자의 지정된 애플리케이션 설치에 대한 세부 정보를 검색합니다. | 위임됨(회사 또는 학교 계정) | TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser | |
| 달력 관리 | 일정 조회 | 지정된 기간 동안 사용자, 배포 목록 또는 자원(방 또는 장비)의 모음에 대한 가용성 정보(사용 가능 또는 없음)를 조회합니다. | 위임됨(회사 또는 학교 계정) | 달력.읽기, 달력.읽기쓰기 |
| 채널 관리 | 채널에 구성원 추가 | 지정된 구성원을 지정된 채널에 추가합니다. | 위임됨(회사 또는 학교 계정) | ChannelMember.ReadWrite.All |
| 채널 생성 | 팀에서 새 채널을 생성합니다. | 위임됨(회사 또는 학교 계정) | Channel.Create, Group.ReadWrite.All, Directory.ReadWrite.All | |
| 채널 삭제 | 필요한 팀에서 지정된 채널을 제거하고 모든 대화를 삭제합니다. | 위임됨(회사 또는 학교 계정) | Channel.Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All | |
| 채널 조회 | 채널의 속성과 관계를 검색합니다. | 위임됨(회사 또는 학교 계정) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | |
| 이름별 채널 조회 | 채널 이름과 팀 ID가 제공된 채널 ID 및 속성을 조회합니다. | 위임됨(회사 또는 학교 계정) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | |
| 채널 구성원 조회 | 채널 구성원 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | ChannelMember.Read.All, ChannelMember.ReadWrite.All | |
| 채널 메시지 조회 | 팀의 채널에서 메시지 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | 채널메시지.읽기.모두 | |
| 채널 조회 | 이 팀의 채널 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | |
| 채널에서 구성원 제거 | 지정된 채널에서 지정된 사용자를 제거합니다. | 위임됨(회사 또는 학교 계정) | ChannelMember.ReadWrite.All | |
| 채팅 관리 | 채팅 작성 | 사용자 간에 채팅을 생성합니다. | 위임됨(회사 또는 학교 계정) | Chat.Create, Chat.ReadWrite |
| 채팅 메시지 델타 스트림 조회 | 팀의 채널에서 메시지 목록을 검색합니다(회신 없음). | 위임됨(회사 또는 학교 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |||
| 채팅 메시지 조회 | 채팅에서 메시지 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | Chat.Read, Chat.ReadWrite | |
| 채팅 조회 | 사용자가 속한 채팅 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | |
| 메시지 조회 | 지정된 메시지의 상세 정보를 조회합니다. | 위임됨(회사 또는 학교 계정) | Chat.Read, Chat.ReadWrite | |
| 메시지 회신 스트림 조회 | 팀 채널에서 지정된 메시지에 대한 회신 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | 채널메시지.읽기.모두 | |
| 메시지를 채팅에 게시 | Microsoft Teams 채팅에 메시지를 게시합니다. | 위임됨(회사 또는 학교 계정) | ChatMessage.Send, Chat.ReadWrite, Group.ReadWrite.All | |
| 알림 관리 | 변경 세부 정보 포스팅 | Microsoft Teams 채널에 필요한 변경에 대한 상세 정보를 게시합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Send, Group.ReadWrite.All |
| 인시던트 상세 정보 게시 | Microsoft Teams 채널에 필요한 인시던트의 상세 정보를 게시합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Send, Group.ReadWrite.All | |
| 메시지 게시 | Microsoft Teams 채널에 메시지를 게시합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Send, Group.ReadWrite.All | |
| 문제 세부 정보 게시 | Microsoft Teams 채널에 필요한 문제에 대한 상세 정보를 게시합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Send, Group.ReadWrite.All | |
| 메시지에 대한 답장을 게시 | 지정된 메시지에 회신을 게시합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Send, Group.ReadWrite.All | |
| 기록 세부 정보 게시 | 지정된 기록의 세부 정보를 지정된 Microsoft Teams 채널에 게시합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Send, Group.ReadWrite.All | |
| 팀 관리 | 팀에 구성원 추가 | 지정된 사용자를 지정된 팀에 추가합니다. | 위임됨(회사 또는 학교 계정) | TeamMember.ReadWrite.All |
| 팀 보관 | 팀이 보관되면 사용자는 더 이상 팀 내 채널에서 메시지를 보내거나 좋아요를 누르거나 팀 설정을 업데이트할 수 없습니다. | 위임됨(회사 또는 학교 계정) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | |
| 팀 작성 | 기존 Office 365 그룹에서 팀을 만듭니다. 주: 팀 ID가 그룹 ID와 같습니다. | 위임됨(회사 또는 학교 계정) | Group.ReadWrite.All, Directory.ReadWrite.All | |
| 팀 삭제 | 지정된 팀을 삭제합니다. | 위임됨(회사 또는 학교 계정) | Group.ReadWrite.All | |
| 팀 조회 | 팀의 속성과 관계를 검색합니다. | 위임됨(회사 또는 학교 계정) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | |
| 팀 구성원 스트림 조회 | 팀 구성원 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | TeamMember.Read.All, TeamMember.ReadWrite.All | |
| 사용자별 팀 조회 | ID와 해당 표시 이름을 포함하는 사용자의 팀을 나열합니다. | 위임됨(회사 또는 학교 계정) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | |
| 구성원을 팀에서 제거 | 지정된 팀에서 지정된 구성원을 제거합니다. | 위임됨(회사 또는 학교 계정) | TeamMember.ReadWrite.All | |
| 팀 보관 해제 | 보관된 팀을 재개합니다. 구성원이 팀의 채널에 게시하고, 댓글을 작성하고, 게시물에 좋아요를 다시 누를 수 있습니다. | 위임됨(회사 또는 학교 계정) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | |
| 팀 업데이트 | 특정 팀의 속성을 업데이트합니다. | 위임됨(회사 또는 학교 계정) | TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All | |
다음 테이블의 작업에서는 Microsoft Teams Graph 클라이언트 연결 및 자격 증명 별칭 기록을 사용합니다. 이러한 작업에는 애플리케이션 권한이 필요합니다.
| 범주 | 동작 | 설명 | 필요한 권한(최소 권한에서 최대 권한 순으로) | |
|---|---|---|---|---|
| 달력 관리 | 회의 생성 | MS Teams 달력에서 온라인 회의 이벤트를 생성합니다. | 애플리케이션 | 달력.읽기쓰기 |
| 회의 삭제 | MS Teams 달력에서 회의 이벤트를 삭제합니다. | 애플리케이션 | 달력.읽기쓰기 | |
| 회의 조회 | MS Teams 달력에서 회의 이벤트 상세 정보를 검색합니다. | 애플리케이션 | 달력.읽기 | |
| 회의 발생 조회 | MS Teams 달력에서 반복 하위 회의 ID를 검색합니다. | 애플리케이션 | 달력.읽기 | |
| 회의 스트림 조회 | MS Teams 달력에서 회의 이벤트 상세 정보를 검색합니다. | 애플리케이션 | 달력.읽기, 달력.읽기쓰기 | |
| 회의 업데이트 | MS Teams 달력에서 온라인 회의 이벤트를 생성합니다. | 애플리케이션 | 달력.읽기쓰기 | |
| 웹후크 관리 | 웹후크 구독 조회 | 필요한 웹후크 구독의 상세 정보를 조회합니다. | 애플리케이션 | 채널메시지.읽기.모두, 채팅.읽기.모두 |
| 웹후크 구독 스트림 조회 | 모든 웹후크 구독의 상세 정보를 조회합니다. | 애플리케이션 | 채널메시지.읽기.모두, 채팅.읽기.모두 | |
| 웹후크 구독 갱신 | 지정된 웹후크 구독을 갱신합니다. | 애플리케이션 | 채널메시지.읽기.모두, 채팅.읽기.모두 | |
| 웹후크 구독 | 지정된 자원에 대한 웹후크 구독을 작성합니다. | 애플리케이션 | 채널메시지.읽기.모두, 채팅.읽기.모두 | |
| 웹후크 구독 취소 | 지정된 웹후크 구독을 삭제합니다. | 애플리케이션 | 채널메시지.읽기.모두, 채팅.읽기.모두 | |
- 기본적으로 권한 부여 유형은 인증 코드로 설정됩니다.
- 애플리케이션 관리, 채널 관리, 채팅 관리, 알림 관리, 팀 관리 범주의 모든 작업과 달력 관리 범주의 일정 조회 작업은 Microsoft Teams 스포크 연결 및 자격 증명 별칭을 사용하며 이러한 작업을 수행하려면 위임된 권한이 필요합니다.
- 달력 및 웹후크 관리 스포크 작업(달력 관리에서 일정 조회 작업 제외)은 Microsoft Teams Graph 클라이언트 자격 증명 연결 및 자격 증명 별칭을 사용하며 이러한 작업을 수행하려면 애플리케이션 권한이 필요합니다.
사용자 상호작용 없이 Microsoft Teams Graph 스포크를 사용하려면 ServiceNow 애플리케이션이 사용자 개입 없이 Microsoft Teams 그래프 API에 액세스할 수 있도록 권한 부여 유형을 클라이언트 자격 증명 으로 변경해야 합니다. 부여 유형 및 필수 구성을 변경하는 방법에 대한 지침은 지식베이스 문서 -ServiceNow에서 KB1635160 - NOW Support를 참조하십시오.
필요한 권한에 대한 자세한 내용은 다음을 참조하십시오. Microsoft 팀 설명서.
를 통해 Microsoft 팀채널 ID 및 그룹 ID에 액세스하는 방법에 대한 자세한 내용은 다음을 참조하십시오. Microsoft 팀 설명서.
사용 가능한 AI 에이전트
사용 가능한 AI 에이전트를 통합 허브 설치 Now Assist 하고 사용합니다. 자세한 내용은 통합 허브에 대한 Now Assist 문서를 참조하십시오.
- ServiceNow 에이전트 시스템에서는 목표를 실행하기 위한 하나 이상의 독립 실행형 AI 에이전트와 함께 대규모 언어 모델(LLM) 지침 세트로 구성된 에이전트 워크플로우를 생성할 수 있습니다. 요구 사항에 따라 에이전트 워크플로우를 생성하고 필요한 트리거를 제공하기 위해 AI 에이전트를 추가하는 방법에 대한 자세한 내용은 을 참조하십시오 .
사용 가능한 다른 AI 에이전트를 검색하고 에이전트 워크플로우에 추가할 수도 있습니다. 자세한 내용은 Find AI agents 문서를 참조하십시오.
- 필요한 스포크 AI 에이전트의 클론을 생성하고 요구 사항에 따라 사용자 지정할 수 있습니다. 클론 생성에 대한 자세한 내용은 을 참조하십시오 .
- AI 에이전트에 대한 자세한 내용은 을 참조하십시오 .
| AI 에이전트 | 설명 |
|---|---|
| Microsoft Teams 애플리케이션 관리 AI 에이전트 | Microsoft Teams 및 통합 허브. 앱 설치 조회 및 사용자를 위한 애플리케이션 설치와 같은 작업을 수행합니다. |
| Microsoft Teams 채널 관리 AI 에이전트 | 통합 허브를 통해 채널을 관리합니다 Microsoft Teams . 채널 생성, 구성원 관리, 채널 정보 검색 등의 기능을 제공합니다. |
| Microsoft Teams 채팅 관리 AI 에이전트 | 채팅 및 메시지 조회와 같은 기능을 제공하여 ServiceNow 간의 워크플로우를 Microsoft Teams 자동화합니다. |
| Microsoft Teams 알림 관리 AI 에이전트 | 채널로 메시지, 업데이트 및 회신 Microsoft Teams 을 전송하여 Microsoft Teams ServiceNow 간의 통신을 자동화합니다. 에이전트는 변경 요청에 대한 효과적인 알림 관리를 위해 '변경 상세 정보 게시', '메시지 게시' 및 '메시지에 회신 게시'와 같은 작업을 지원합니다. |
| Microsoft Teams 팀 관리 AI 에이전트 | 팀 생성 및 관리, 구성원 추가 또는 제거, 팀 관련 정보 검색과 같은 작업을 자동화합니다. 조직 내에서 팀 관리 및 커뮤니케이션 워크플로우를 개선합니다. |
| Microsoft Teams 달력 관리 AI 에이전트 | 와 . 사이의 워크플로우 ServiceNow 를 자동화합니다 Microsoft Teams. 달력 관리 기능을 제공합니다. 회의 상세 정보 삭제 및 검색과 같은 작업을 수행합니다. |
애플리케이션과 함께 Now Assist 설치된 AI 에이전트 중에 에이전틱 워크플로우에 사용되지 않을 수 있습니다. 사용할 수 있는 모든 에이전트를 보는 방법을 알아보려면 AI 에이전트 찾기를 참조하세요.
스포크 모듈
| 모듈 | 설명 |
|---|---|
| 델타 토큰 | 사용 가능한 델타 토큰 목록을 표시합니다. |
| 웹후크 레지스트리 | 사용 가능한 웹후크 레지스트리 목록을 표시합니다. |
| 웹후크 결정 정책 | 결정 정책 목록을 표시합니다. |
| 웹후크 구독 | 웹후크 구독의 상세 정보를 표시합니다. |
Microsoft 계좌 요구 사항
Microsoft Teams Graph 스포크 OAuth 2.0 토큰을 생성하려면 Azure Portal을 사용하여 Microsoft 애플리케이션을 등록해야 합니다.
연결 및 자격 증명 별칭 요구 사항
통합 허브 는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.
스포크 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 설정 Microsoft Teams Graph 스포크.
MID 서버 요구 사항
Microsoft Teams Graph 스포크 작업은 인스턴스 또는 MID 서버에서 실행할 수 있는 REST 호출을 사용합니다. 별칭과 Microsoft 연결된 연결 기록을 사용하여 작업이 실행되는 위치를 구성하고 선택 속성을 설정합니다 MID 서버 . 자세한 내용은 MID 서버를 참조하십시오.
이 스포크에 대해 설정 MID 서버 하려면 다음 문서를 참조하십시오 MID 서버 스포크 설정.