Microsoft Teams Graph 스포크
Microsoft Teams Graph 스포크는 Microsoft Teams에서 애플리케이션, 달력, 팀, 채널, 채팅, 알림 및 웹후크를 관리합니다. 사용자 및 그룹을 만들거나 관리하거나 삭제하려면 ID 스포크(이전의 Microsoft Azure Active Directory 스포크)를 Microsoft Entra 사용합니다.
스토어에서 앱 요청
ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.
주:
- 의 Microsoft Teams Graph 스포크 Teams는 Entra ID(이전의 Microsoft Azure Active Directory)의 Microsoft 그룹에서 만들어집니다. 를 Microsoft Teams Graph 스포크사용하여 팀을 생성하려면 연결된 그룹이 Entra ID에 Microsoft 있어야 합니다.
- 사용자 및 그룹 관리는 Entra ID만 사용하여 Microsoft 수행할 수 있습니다 Microsoft Teams Graph 스포크.
- Teams는 Office 365 그룹에서만 Microsoft 만들 수 있습니다.
- 의 Microsoft Teams 팀 ID는 Entra ID에 있는 Microsoft 연결된 그룹의 그룹 ID와 동일합니다.
통합 허브 구독
이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.
스포크 버전
Microsoft Teams Graph 스포크 v4.3.0 가 최신 버전입니다.
지원되는 버전
Microsoft 그래프 REST API v1.0.
스포크 종속성
앱을 설치하는 데 문제가 있는 경우 다음 종속 플러그인이 설치되어 있는지 확인합니다.
- ServiceNow 통합 허브 Runtime(com.glide.hub.integration.runtime)
- Flow Designer 모델(com.glide.hub.designer_backend.model)
- Complex Object (com.glide.cobject)
- ServiceNow 통합 허브 Action Step - 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 Graph 스포크 작업 자동화를 보여주는 샘플 하위 플로우를 제공합니다. 샘플 플로우를 사용자 지정하려면 필요한 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 하위 플로우는 다음과 같습니다.
| 하위 플로우 | 설명 |
|---|---|
| 인시던트 상세 정보 게시 | 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 | |
| 채널 메시지 조회 | 팀의 채널에서 메시지 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Read.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 | |
| 메시지 회신 스트림 조회 | 팀 채널에서 지정된 메시지에 대한 회신 목록을 검색합니다. | 위임됨(회사 또는 학교 계정) | ChannelMessage.Read.All | |
| 메시지를 채팅에 게시 | 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 | |
| 팀 삭제 | 지정된 팀을 삭제합니다. | 위임됨(회사 또는 학교 계정) | 그룹.읽기쓰기.모두 | |
| 팀 조회 | 팀의 속성과 관계를 검색합니다. | 위임됨(회사 또는 학교 계정) | 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 달력에서 온라인 회의 이벤트를 작성합니다. | 애플리케이션 | Calendars.ReadWrite |
| 회의 삭제 | MS Teams 달력에서 회의 이벤트를 삭제합니다. | 애플리케이션 | Calendars.ReadWrite | |
| 회의 조회 | MS Teams 달력에서 회의 이벤트 상세 정보를 검색합니다. | 애플리케이션 | Calendars.Read | |
| 회의 발생 조회 | MS Teams 달력에서 반복 하위 회의 ID를 검색합니다 | 애플리케이션 | Calendars.Read | |
| 회의 스트림 조회 | MS Teams 달력에서 회의 이벤트 상세 정보를 검색합니다. | 애플리케이션 | 달력.읽기, 달력.읽기쓰기 | |
| 회의 업데이트 | MS Teams 달력에서 온라인 회의 이벤트를 작성합니다. | 애플리케이션 | Calendars.ReadWrite | |
| 웹후크 관리 | 웹후크 구독 조회 | 필요한 웹후크 구독의 상세 정보를 조회합니다. | 애플리케이션 | ChannelMessage.Read.All, Chat.Read.All |
| 웹후크 구독 스트림 조회 | 모든 웹후크 구독의 상세 정보를 조회합니다. | 애플리케이션 | ChannelMessage.Read.All, Chat.Read.All | |
| 웹후크 구독 갱신 | 지정된 웹후크 구독을 갱신합니다. | 애플리케이션 | ChannelMessage.Read.All, Chat.Read.All | |
| 웹후크 구독 | 지정된 자원에 대한 웹후크 구독을 작성합니다. | 애플리케이션 | ChannelMessage.Read.All, Chat.Read.All | |
| 웹후크 구독 취소 | 지정된 웹후크 구독을 삭제합니다. | 애플리케이션 | ChannelMessage.Read.All, Chat.Read.All | |
중요사항:
이러한 기본 스포크 구성에 대해 알고 있어야 합니다.
- 기본적으로 권한 부여 유형은 인증 코드로 설정됩니다.
- 애플리케이션 관리, 채널 관리, 채팅 관리, 알림 관리, 팀 관리 범주의 모든 작업과 달력 관리 범주의 일정 조회 작업은 Microsoft Teams 스포크 연결 및 자격 증명 별칭을 사용하며 이러한 작업을 수행하려면 위임된 권한이 필요합니다.
- 달력 및 웹후크 관리 스포크 작업(달력 관리에서 일정 조회 작업 제외)은 Microsoft Teams Graph 클라이언트 자격 증명 연결 및 자격 증명 별칭을 사용하며 이러한 작업을 수행하려면 애플리케이션 권한이 필요합니다.
사용자 상호작용 없이 Microsoft Teams Graph 스포크를 사용하려면 ServiceNow 애플리케이션이 사용자 개입 없이 Microsoft Teams 그래프 API에 액세스할 수 있도록 권한 부여 유형을 클라이언트 자격 증명 으로 변경해야 합니다. 권한 부여 유형 및 필수 구성을 변경하는 방법에 대한 지침은 지식베이스 문서 -ServiceNow - NOW Support의 KB1635160 참조하십시오.
필요한 권한에 대한 자세한 내용은 다음을 참조하십시오. Microsoft Teams 설명서.
주:
일부 스포크 작업에는 채널 ID, 그룹 ID 또는 팀 ID가 입력 중 하나로 필요합니다. 이러한 세부 정보를 알아보려면 에 Microsoft Teams로그인하고 Teams로 이동한 다음 필요한 채널의 채널에 대한 링크 가져오기 를 클릭합니다. 채널 링크에는 필요한 상세 정보가 포함되어 있습니다. 예를 들어 채널 https://teams.microsoft.com/l/channel/ 링크가 19%3a1aa3730712e245a0af31e4095d66d613%40thread.skype /New%2520channel%2520in%2520team? groupId= 7fb91938-5e8c-4968-bf7d-3987df7716f3 &tenantId= a46df9b7-2c9b-49d5-8c9f-d1b3de4ba59f인 경우 그룹 ID와 팀 ID는 7fb91938-5e8c-4968-bf7d-3987df7716f3이고 채널 ID는19:1aa3730712e245a0af31e4095d66d613@thread.skype 또는 1aa3730712e245a0af31e4095d66d613입니다.
를 통해 Microsoft Teams채널 ID 및 그룹 ID에 액세스하는 방법에 대한 자세한 내용은 다음을 참조하십시오. Microsoft Teams 설명서.
사용 가능한 AI 에이전트
스포크를 설치하고 Now Assist 사용 가능한 AI 에이전트 사용을 시작합니다. 자세한 내용은 Now Assist 스포크용 문서를 참조하십시오.
이 스포크는 인간과 유사한 인텔리전스를 모방하여 인스턴스에서 작업을 ServiceNow 수행하는 독립 실행형 AI 에이전트를 제공합니다.
- ServiceNow 에이전트 시스템에서는 목표를 실행하기 위한 하나 이상의 독립 실행형 AI 에이전트와 함께 대규모 언어 모델(LLM) 지침 세트로 구성된 에이전트 워크플로우를 생성할 수 있습니다. 요구 사항에 따라 에이전트 워크플로우를 생성하고 필요한 트리거를 제공하기 위해 AI 에이전트를 추가하는 방법에 대한 자세한 내용은 을 참조하십시오 Create an agentic workflow .
사용 가능한 다른 AI 에이전트를 검색하고 에이전트 워크플로우에 추가할 수도 있습니다. 자세한 내용은 Find AI agents 문서를 참조하십시오.
- 필요한 스포크 AI 에이전트의 클론을 생성하고 요구 사항에 따라 사용자 지정할 수 있습니다. 클론 생성에 대한 자세한 내용은 을 참조하십시오 Duplicate an AI agent .
- AI 에이전트에 대한 자세한 내용은 을 참조하십시오 Now Assist AI agents .
사용 가능한 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. 달력 관리 기능을 제공합니다. 회의 상세 정보 삭제 및 검색과 같은 작업을 수행합니다. |
AI 에이전트를 찾고 계십니까?
- 애플리케이션과 함께 Now Assist 설치된 AI 에이전트 중에 에이전틱 워크플로우에 사용되지 않을 수 있습니다. 인스턴스에서 사용할 수 있는 모든 에이전트를 보는 방법에 대한 자세한 내용은 AI 에이전트 찾기를 참조하십시오.
- 인스턴스에 설치되어 있지 않을 수 있는 에이전트를 찾으려면 에서 ServiceNow StoreAI 에이전트 마켓플레이스를 방문하십시오.
주:
AI 에이전트를 실행하는 사용자에게 AI 에이전트와 연결된 테이블의 데이터에 액세스하거나 데이터에 대한 작업을 수행하는 데 필요한 역할과 권한이 있는지 확인합니다.
스포크 모듈
ServiceNow Microsoft Teams Graph 스포크 인스턴스에 Microsoft Teams Graph 스포크를 추가하고 다음 모듈을 포함합니다.
| 모듈 | 설명 |
|---|---|
| 델타 토큰 | 사용 가능한 델타 토큰 목록을 표시합니다. |
| 웹후크 레지스트리 | 사용 가능한 웹후크 레지스트리 목록을 표시합니다. |
| 웹후크 결정 정책 | 결정 정책 목록을 표시합니다. |
| 웹후크 구독 | 웹후크 구독의 상세 정보를 표시합니다. |
Microsoft 계좌 요구 사항
OAuth Microsoft Teams Graph 스포크 2.0 토큰을 생성하려면 Azure Portal을 사용하여 Microsoft 애플리케이션을 등록해야 합니다.
연결 및 자격 증명 별칭 요구 사항
통합 허브는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.
스포크 설정에 대한 자세한 내용은 다음을 참조하십시오. 설정 Microsoft Teams Graph 스포크.
MID 서버 요구 사항
이 Microsoft Teams Graph 스포크 작업은 인스턴스 또는 MID 서버에서 실행할 수 있는 REST 호출을 사용합니다. 별칭과 Microsoft 연결된 연결 기록을 사용하여 작업이 실행되는 위치를 구성하고 선택 속성을 설정합니다 MID 서버 . 자세한 내용은 MID 서버를 참조하십시오.
이 스포크에 대해 설정 MID 서버 하려면 다음 문서를 참조하십시오 MID 서버 스포크 설정.