Microsoft Teams Graph Spoke

Solicitar aplicativos na Store

Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

Nota:

Equipes em Microsoft Teams Graph spokesão criados a partir dos grupos em MicrosoftEntra ID (anteriormente Microsoft Azure Active Directory ). Para criar uma equipe usando Microsoft Teams Graph spoke, o grupo associado deve estar presente em MicrosoftEntra ID.
A gestão de usuários e grupos pode ser feita usando MicrosoftEntra ID e não Microsoft Teams Graph spoke.
As equipes podem ser criadas a partir de MicrosoftSomente grupo do Office 365.
O ID da equipe em Microsoft TeamsÉ igual ao ID do grupo associado em MicrosoftEntra ID.

Assinatura do Integration Hub

Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

Versão do spoke

Microsoft Teams Graph spokev 4.1.2 é a versão mais recente.

Versão compatível

Microsoft API REST de gráfico v1.0.

Dependências do spoke

Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:

ServiceNow Integration Hub Tempo de execução (com.glide.hub.integration.runtime)
Modelo de Designer de Fluxo (com.glide.hub.designer_backend.model)
Objeto complexo (com.glide.cobject)
ServiceNow Integration Hub Etapa de ação - REST (com.glide.hub.action_step.rest)
ServiceNow Integration Hub Modelo de ação - Fluxo de dados (com.glide.hub.action_type.datastream)
Tabelas remotas (com.glide.script.vtable)
Etapa de ação do ServiceNow IntegrationHub — Obter informações de conexão (com.glide.hub.action_step.get_connection_info)

Nota:

Alguns desses plug-ins são recursos licenciáveis e exigem licenças apropriadas, se usados fora da implementação do spoke.

Fluxos de spoke

. Microsoft Teams Graph spokeFornece um fluxo de amostra, Atualizações de Workknotes de incidentes pós-ServiceNow no bate-papo do Microsoft Teams, para demonstrar a automação da tarefa de publicar uma mensagem de bate-papo do Microsoft Teams para o usuário atribuído com detalhes sobre as anotações de trabalho mais recentes adicionadas ao incidente.

Subfluxos do spoke

. Microsoft Teams Graph spokefornece subfluxos de amostra para demonstrar a automação das tarefas. Para personalizar um fluxo de amostra, copie-o para o escopo da aplicação necessário. Os subfluxos de amostra disponíveis incluem:

Tabela 1. Microsoft Teams Graph subfluxos de spoke
Subfluxo	Descrição
Publicar detalhes do incidente	Publica detalhes do incidente necessário em um canal do Microsoft Teams.
Notificações de entrada do processo	Recupera os detalhes da mensagem especificada com base nos dados de entrada recebidos da assinatura do webhook.
Subfluxo Auxiliar de assinatura do webhook	Renova uma assinatura se a renovação for necessária, que é decidida com base nas entradas.
Renovar assinaturas do webhook	Recupera todas as assinaturas do webhook e as renova se a renovação for necessária.
Webhook	Cria uma assinatura de webhook para o canal da equipe especificada.

Ações do spoke

. Microsoft Teams Graph spokefornece ações para automatizar tarefas de equipe e canal quando um incidente é criado no ServiceNowinstância.

Você pode executar algumas ações usando a conexão Spoke do Microsoft Teams e as ações restantes usando a conexão Credenciais do cliente do Microsoft Teams Graph.

As ações na tabela a seguir usam o registro de alias de credencial e conexão do spoke do Microsoft Teams. Essas ações exigem as permissões delegadas.

Tabela 2. Microsoft Teams Graph Ações do spoke que usam o alias de credencial e a conexão do spoke do Microsoft Teams
Categoria	Ação	Descrição	Permissões necessárias (do menos para o mais privilegiado)
Gestão de aplicações	Instale a aplicação para o usuário	Instala a aplicação especificada no escopo pessoal do usuário.	Delegado (conta corporativa ou escolar)	TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser
Gestão de aplicações	Pesquisar instalação da aplicação do usuário	Recupera os detalhes da instalação da aplicação especificada para o usuário.	Delegado (conta corporativa ou escolar)	TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser
Gestão de calendários	Pesquisar cronogramas	Recupera as informações de disponibilidade (livre ou ocupado) de uma coleção de usuários, listas de distribuições ou recursos (salas ou equipamentos) para o período especificado.	Delegado (conta corporativa ou escolar)	Calendars.Read, Calendars.ReadWrite
Gestão de canais	Adicionar membro ao canal	Adiciona o membro especificado ao canal especificado.	Delegado (conta corporativa ou escolar)	Membro.ReadWrite.Todos
	Criar Canal	Crie um novo canal em uma equipe.	Delegado (conta corporativa ou escolar)	Channel.Criar, Group.ReadWrite.All, Directory.ReadWrite.All
	Excluir canal	Remove o canal especificado da equipe necessária e exclui todas as conversas.	Delegado (conta corporativa ou escolar)	Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All
	Pesquisar canal	Recupera as propriedades e os relacionamentos de um canal.	Delegado (conta corporativa ou escolar)	ReadBasic.Todos, Configurações de Canal.Ler.Todos, Configurações de Canal.ReadWrite.Todos, Grupo.Ler.Todos, Grupo.ReadWrite.Todos, Directory.Read.All, Directory.ReadWrite.All
	Pesquisar canal por nome	Recupera o ID do canal e as propriedades com um nome de canal e um ID de equipe.	Delegado (conta corporativa ou escolar)	ReadBasic.Todos, Configurações de Canal.Ler.Todos, Configurações de Canal.ReadWrite.Todos, Grupo.Ler.Todos, Grupo.ReadWrite.Todos, Directory.Read.All, Directory.ReadWrite.All
	Pesquisar membros do canal	Recupera uma lista de membros do canal.	Delegado (conta corporativa ou escolar)	ChannelMember.Read.All, ChannelMember.ReadWrite.All
	Pesquisar mensagens do canal	Recupera a lista de mensagens em um canal de uma equipe.	Delegado (conta corporativa ou escolar)	Mensagem.Ler.Tudo
	Pesquisar canais	Recupera a lista de canais nesta equipe.	Delegado (conta corporativa ou escolar)	ReadBasic.Todos, Configurações de Canal.Ler.Todos, Configurações de Canal.ReadWrite.Todos, Grupo.Ler.Todos, Grupo.ReadWrite.Todos, Directory.Read.All, Directory.ReadWrite.All
	Remover membro do canal	Remove o usuário especificado do canal especificado.	Delegado (conta corporativa ou escolar)	Membro.ReadWrite.Todos
Gestão de bate-papo	Criar bate-papo	Cria um bate-papo entre os usuários.	Delegado (conta corporativa ou escolar)	Bate-papo.Criar, Bate-papo.ReadWrite
	Pesquisar fluxo de deltas de mensagem de bate-papo	Recupera a lista de mensagens (sem as respostas) do canal de uma equipe.	Delegado (conta corporativa ou escolar)	ReadBasic, Mail.Read, Mail.ReadWrite
	Pesquisar fluxo de deltas de mensagem de bate-papo		Delegado (conta pessoal da Microsoft)	ReadBasic, Mail.Read, Mail.ReadWrite
	Pesquisar mensagens de bate-papo	Recupera a lista de mensagens em um bate-papo.	Delegado (conta corporativa ou escolar)	Bate-papo.Ler, Bate-papo.ReadWrite
	Pesquisar bate-papos	Recupera a lista de bate-papos dos quais o usuário faz parte.	Delegado (conta corporativa ou escolar)	Bate-papo.ReadBasic, Bate-papo.Ler, Bate-papo.ReadWrite
	Pesquisar mensagem	Recupera os detalhes da mensagem especificada.	Delegado (conta corporativa ou escolar)	Bate-papo.Ler, Bate-papo.ReadWrite
	Pesquisar fluxo de respostas de mensagem	Recupera a lista de respostas da mensagem especificada do canal de uma equipe.	Delegado (conta corporativa ou escolar)	Mensagem.Ler.Tudo
	Publicar mensagem no bate-papo	Publica mensagem em um bate-papo do Microsoft Teams.	Delegado (conta corporativa ou escolar)	Bate-papo.Enviar, Bate-papo.readWrite, Grupo.readWrite.All
Gestão de notificações	Publicar detalhes da mudança	Publica detalhes da mudança necessária em um canal do Microsoft Teams.	Delegado (conta corporativa ou escolar)	Mensagem.Enviar, Grupo.ReadWrite.Todos**
	Publicar detalhes do incidente	Publica detalhes do incidente necessário em um canal do Microsoft Teams.	Delegado (conta corporativa ou escolar)	Mensagem.Enviar, Grupo.ReadWrite.Todos**
	Publicar mensagem	Publica mensagem em um canal do Microsoft Teams.	Delegado (conta corporativa ou escolar)	Mensagem.Enviar, Grupo.ReadWrite.Todos**
	Publicar detalhes do problema	Publica detalhes do problema necessário em um canal do Microsoft Teams.	Delegado (conta corporativa ou escolar)	Mensagem.Enviar, Grupo.ReadWrite.Todos**
	Publicar resposta à mensagem	Publica uma resposta para a mensagem especificada.	Delegado (conta corporativa ou escolar)	Mensagem.Enviar, Grupo.ReadWrite.Todos**
	Publicar detalhes do registro	Publica detalhes do registro especificado no canal especificado do Microsoft Teams.	Delegado (conta corporativa ou escolar)	Mensagem.Enviar, Grupo.ReadWrite.Todos**
Gestão de equipe	Adicionar membro à equipe	Adiciona o usuário especificado à equipe especificada.	Delegado (conta corporativa ou escolar)	TeamMember.ReadWrite.All
	Arquivar equipe	Quando uma equipe é arquivada, os usuários não podem mais enviar ou curtir mensagens em qualquer canal da equipe ou fazer atualizações de configuração da equipe.	Delegado (conta corporativa ou escolar)	TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All
	Criar Equipe	Crie uma equipe a partir de um grupo existente do Office 365. Nota: O ID da equipe é o mesmo que o ID do grupo.	Delegado (conta corporativa ou escolar)	ReadWrite.All, Directory.ReadWrite.All
	Excluir equipe	Exclui a equipe especificada.	Delegado (conta corporativa ou escolar)	ReadWrite.All
	Pesquisar equipe	Recupera as propriedades e os relacionamentos de uma equipe.	Delegado (conta corporativa ou escolar)	ReadBasic.Todos, TeamSettings.Ler.Todos, TeamSettings.ReadWrite.Todos, Grupo.Ler.Todos, Grupo.ReadWrite.Todos, Directory.Read.All, Directory.ReadWrite.All
	Pesquisar fluxo de membros da equipe	Recupera a lista de membros da equipe.	Delegado (conta corporativa ou escolar)	TeamMember.Read.All, TeamMember.ReadWrite.All
	Pesquisar equipes por usuário	Lista as equipes do usuário que contêm IDs e seus nomes de exibição.	Delegado (conta corporativa ou escolar)	ReadBasic.Tudo, TeamSettings.Ler.Tudo, TeamSettings.ReadWrite.Tudo, Usuário.Ler.Tudo, Usuário.ReadWrite.Tudo, Usuário.ReadWrite.Todos, Directory.Read.All, Directory.ReadWrite.All
	Remover membro da equipe	Remove o membro especificado da equipe especificada.	Delegado (conta corporativa ou escolar)	TeamMember.ReadWrite.All
	Desarquivar equipe	Restaura uma equipe arquivada. Permite que os membros publiquem nos canais da equipe, façam comentários e curtam postagens novamente.	Delegado (conta corporativa ou escolar)	TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All
	Atualizar equipe	Atualiza as propriedades de uma equipe específica.	Delegado (conta corporativa ou escolar)	TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All

As ações na tabela a seguir usam a conexão do cliente do Microsoft Teams Graph e o registro de alias de credencial. Essas ações exigem as permissões da aplicação.

Tabela 3. Microsoft Teams Graph Ações do spoke que usam o alias de credencial e a conexão de credenciais do cliente do Microsoft Teams Graph
Categoria	Ação	Descrição	Permissões necessárias (do menos para o mais privilegiado)
Gestão de calendários	Criar reunião	Cria um evento de reunião on-line no calendário do MS Teams.	Aplicação	Calendars.ReadWrite
	Excluir reunião	Exclui o evento de reunião do calendário do MS Teams.	Aplicação	Calendars.ReadWrite
	Pesquisar reunião	Recupera detalhes do evento da reunião do calendário do MS Teams.	Aplicação	Calendários.Ler
	Pesquisar ocorrências de reunião	Recupera o ID da reunião secundária de recorrência do calendário do MS Teams.	Aplicação	Calendários.Ler
	Pesquisar fluxo de reuniões	Recupera detalhes de eventos de reunião do calendário do MS Teams.	Aplicação	Calendars.Read, Calendars.ReadWrite
	Reunião de atualização	Cria um evento de reunião on-line no calendário do MS Teams.	Aplicação	Calendars.ReadWrite
Gestão de webhook	Pesquisar assinatura do webhook	Recupera detalhes da assinatura do webhook necessária.	Aplicação	Mensagem.Ler.Tudo, Bate-papo.Ler.Tudo
	Pesquisar fluxo de assinaturas do webhook	Recupera detalhes de todas as assinaturas do webhook.	Aplicação	Mensagem.Ler.Tudo, Bate-papo.Ler.Tudo
	Renovar assinatura do webhook	Renova a assinatura do webhook especificada.	Aplicação	Mensagem.Ler.Tudo, Bate-papo.Ler.Tudo
	Webhook	Cria uma assinatura de webhook para o recurso especificado.	Aplicação	Mensagem.Ler.Tudo, Bate-papo.Ler.Tudo
	Cancelar assinatura do webhook	Exclui a assinatura do webhook especificada.	Aplicação	Mensagem.Ler.Tudo, Bate-papo.Ler.Tudo

Importante:

Certifique-se de estar ciente dessas configurações de spoke padrão.

Por padrão, o tipo de concessão é definido como Código de autorização .
Todas as ações nas categorias Gestão de aplicações, Gestão de canais, Gestão de bate-papo, Gestão de notificações e Gestão de equipes e a ação Pesquisar cronogramas na categoria Gestão de calendários usam Spoke do Microsoft Teams o alias de conexão e credencial e essas ações exigem permissões delegadas.
As ações do spoke Calendário e Gestão de webhook (exceto a ação Pesquisar cronogramas na Gestão de calendários) usam Credenciais do cliente do Microsoft Teams Graph o alias de conexão e credencial e essas ações exigem permissões da aplicação.

Se você quiser usar o spoke do Microsoft Teams Graph sem interação do usuário, altere o tipo de concessão para Credenciais do cliente Para que a aplicação ServiceNow possa acessar a API do Microsoft Teams Graph sem o envolvimento do usuário. Para obter instruções sobre como mudar o tipo de concessão e as configurações necessárias, consulte artigo da base de conhecimento - KB1635160 ativado ServiceNow - NOW Support .

Para obter mais informações sobre as permissões necessárias, consulte Microsoft Teams documentação.

Nota:

Algumas das ações do spoke exigem o ID do canal, ID do grupo ou ID da equipe como uma das entradas. Para saber esses detalhes, faça login em Microsoft Teams, navegue até Equipes e clique em Obter link para o canal para o canal necessário. O link do canal contém os detalhes necessários. Por exemplo, se o link do canal for https://teams.microsoft.com/l/channel/ 19%3a1aa3730712e245a0af3e4095d66d613%40thread.skype /Novo%2520canal%2520em%2520equipe? 7fb91938-5e8c-4968-bf7d-3987df7716f3 &tenantId a46df9b7-2c9b-49d5-8c9f-d1b3de4ba59f , O ID do grupo e o ID da equipe são 7fb91938-5e8c-4968-bf7d-3987df7716f3 E o ID do canal é 19:1aa3730712e245a0af31e4095d66d613 ou 1aa3730712e245a0af3e4095d66d613 .

Para obter mais informações sobre como acessar o ID do canal e o ID do grupo por meio de Microsoft Teams, consulte Microsoft Teams documentação.

Módulos de spoke

. Microsoft Teams Graph spokeAdiciona o Spoke do Microsoft Teams Graph à sua instância da ServiceNow e inclui esses módulos.

Tabela 4. Módulos de spoke do Microsoft Teams Graph
Módulo	Descrição
Token Delta	Exibe a lista de tokens Delta disponíveis.
Registro do Webhook	Exibe a lista de registros de webhook disponíveis.
Política da Decisão do Webhook	Exibe a lista de políticas de decisão.
Assinaturas do webhook	Exibe os detalhes das assinaturas do webhook.

Microsoft requisitos da conta

. Microsoft Teams Graph spokerequer o registro de uma aplicação usando o. MicrosoftPortal do Azure para gerar tokens OAuth 2,0.

Requisitos de aliases de conexão e credencial

Integration Hub usa aliases para gerenciar conexões e informações de credenciais e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.

Para obter informações sobre como configurar o spoke, consulte Configure o. Microsoft Teams Graph spoke.

Requisitos do MID Server

. Microsoft Teams Graph spokeAs ações usam chamadas REST, que podem ser executadas em uma instância ou em um MID Server. Use o registro de conexão associado ao Microsoftalias para configurar onde as ações são executadas e definidas MID Serveratributos de seleção. Para obter mais informações, consulte MID server.