Spoke do Microsoft Teams Graph
O Microsoft Teams Graph spoke gerencia aplicações, calendário, equipes, canais, bate-papos, notificações e webhooks no Microsoft Teams. Para criar, gerenciar ou excluir usuários e grupos, use o Microsoft Entra ID spoke (antigo Microsoft spoke do Azure Active Directory).
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 no Microsoft Teams Graph spoke são criadas a partir dos grupos no Microsoft Entra ID (anteriormente Microsoft Azure Active Directory). Para criar uma equipe usando o Microsoft Teams Graph spoke, o grupo associado deve estar presente no Microsoft Entra ID.
- A gestão de usuários e grupos pode ser feita usando somente o Microsoft Entra ID e não Microsoft Teams Graph spoke.
- As equipes podem ser criadas a partir do Microsoft grupo do Office 365 somente.
- O ID da equipe em Microsoft Teams é o mesmo que o ID do grupo associado em Microsoft Entra ID.
Assinatura do IntegrationHub
Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub.
Versão do spoke
Microsoft Teams Graph spoke v4.0.0 é a versão mais recente.
Versão compatível
Microsoft Graph REST API 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 IntegrationHub Tempo de execução (com.glide.hub.integration.runtime)
- Flow Designer Designer Model (com.glide.hub.designer_backend.model)
- Objeto complexo (com.glide.cobject)
- ServiceNow IntegrationHub Etapa de ação - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub 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 do spoke
O Microsoft Teams Graph spoke fornece um fluxo de amostra, Publicar atualizações das anotações de trabalho do incidente da ServiceNow no bate-papo do Microsoft Teams, para demonstrar a automatizaçã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
O Microsoft Teams Graph spoke fornece amostras de subfluxos 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:
| Subfluxo | Descrição |
|---|---|
| Publicar detalhes do incidente | Publica detalhes do incidente necessário em um canal do Microsoft Teams. |
| Processar notificações de entrada | Recupera os detalhes da mensagem especificada com base nos dados de entrada recebidos da assinatura do webhook. |
| Subfluxo do auxiliar de renovação de assinatura de webhook | Renova uma assinatura se a renovação for necessária, o que é decidido com base nas entradas. |
| Renovar assinaturas de webhook | Recupera todas as assinaturas de webhook e as renova se a renovação for necessária. |
| Assinar webhook | Cria uma assinatura de webhook para o canal da equipe especificada. |
Ações do spoke
O Microsoft Teams Graph spoke fornece ações para automatizar tarefas de equipe e canal quando um incidente é criado na instância ServiceNow.
Você pode executar algumas ações usando a conexão do Microsoft Teams Spoke e as ações restantes usando a conexão de credenciais do Microsoft Teams Graph Client.
As ações na tabela a seguir usam o registro de alias de conexão e credencial do Microsoft Teams Spoke. Essas ações exigem as permissões delegadas.
| Categoria | Ação | Descrição | Permissões necessárias (do menos para o mais privilegiado) | |
|---|---|---|---|---|
| Gestão de aplicações | Instalar aplicação para usuário | Instala a aplicação especificada no escopo pessoal do usuário. | Delegado (conta corporativa ou de estudante) | TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser |
| 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 de estudante) | TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser | |
| Gestão de calendário | Pesquisar programações | Recupera as informações de disponibilidade (livre ou ocupada) de uma coleção de usuários, listas de distribuição ou recursos (salas ou equipamentos) para o período especificado. | Delegado (conta corporativa ou de estudante) | Calendários.Leitura, Calendários.LeituraGravata |
| Gestão de canais | Adicionar membro ao canal | Adiciona o membro especificado ao canal especificado. | Delegado (conta corporativa ou de estudante) | ChannelMember.ReadWrite.All |
| Criar Canal | Crie um novo canal em uma equipe. | Delegado (conta corporativa ou de estudante) | Canal.Criar, Grupo.LeituraGravação.Todos**, Diretório.LeituraGravata.Todos** | |
| Excluir canal | Remove o canal especificado da equipe necessária e exclui todas as conversas. | Delegado (conta corporativa ou de estudante) | Channel.Delete.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Pesquisar canal | Recupera as propriedades e os relacionamentos de um canal. | Delegado (conta corporativa ou de estudante) | Channel.Read.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Pesquisar canal por nome | Recupera o ID do canal e as propriedades de acordo com um nome de canal e ID de equipe. | Delegado (conta corporativa ou de estudante) | Channel.Read.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Pesquisar membros do canal | Recupera uma lista de membros do canal. | Delegado (conta corporativa ou de estudante) | 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 de estudante) | ChannelMessage.Read.All | |
| Pesquisar canais | Recupera a lista de canais nessa equipe. | Delegado (conta corporativa ou de estudante) | Channel.Read.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Remover membro do canal | Remove o usuário indicado do canal especificado. | Delegado (conta corporativa ou de estudante) | ChannelMember.ReadWrite.All | |
| Gestão do bate-papo | Criar bate-papo | Cria um bate-papo entre usuários. | Delegado (conta corporativa ou de estudante) | Bate-papo.Criar, Bate-papo.LeituraGravar |
| Pesquisar fluxo de Deltas de mensagens de bate-papo | Recupera a lista de mensagens (sem as respostas) do canal de uma equipe. | Delegado (conta corporativa ou de estudante) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |||
| Pesquisar mensagens de bate-papo | Recupera a lista de mensagens em um bate-papo. | Delegado (conta corporativa ou de estudante) | Bate-papo.Leitura, Bate-papo.LeituraGravata | |
| Pesquisar conversas | Recupera a lista de bate-papos em que o usuário participa. | Delegado (conta corporativa ou de estudante) | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | |
| Pesquisar mensagem | Recupera os detalhes da mensagem especificada. | Delegado (conta corporativa ou de estudante) | Bate-papo.Leitura, Bate-papo.LeituraGravata | |
| Pesquisar fluxo de respostas a mensagens | Recupera a lista de respostas da mensagem especificada do canal de uma equipe. | Delegado (conta corporativa ou de estudante) | ChannelMessage.Read.All | |
| Publicar mensagem no bate-papo | Publica mensagens em um bate-papo do Microsoft Teams. | Delegado (conta corporativa ou de estudante) | Mensagem.Chat.Enviar, Bate-papo.LeituraGravata | |
| 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 de estudante) | ChannelMessage.Send, Group.ReadWrite.All** |
| Publicar detalhes do incidente | Publica detalhes do incidente necessário em um canal do Microsoft Teams. | Delegado (conta corporativa ou de estudante) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publicar mensagem | Publica mensagens em um canal do Microsoft Teams. | Delegado (conta corporativa ou de estudante) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publicar detalhes do problema | Publica detalhes do problema necessário em um canal do Microsoft Teams. | Delegado (conta corporativa ou de estudante) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publicar resposta à mensagem | Publica uma resposta à mensagem especificada. | Delegado (conta corporativa ou de estudante) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Gestão de equipe | Adicionar membro à equipe | Adiciona o usuário especificado à equipe especificada. | Delegado (conta corporativa ou de estudante) | MembroDaEquipe.LeituraGravação.Todos |
| Arquivar equipe | Quando uma equipe é arquivada, os usuários não podem mais enviar ou curtir mensagens em nenhum canal da equipe ou fazer atualizações nas configurações da equipe. | Delegado (conta corporativa ou de estudante) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Criar Equipe | Crie uma equipe a partir de um grupo do Office 365 existente. Nota: O ID da equipe é igual ao ID do grupo. |
Delegado (conta corporativa ou de estudante) | Grupo.LeituraGravação.Todos, Diretório.LeituraGravata.Todos | |
| Excluir equipe | Exclui a equipe especificada. | Delegado (conta corporativa ou de estudante) | Grupo.LeituraGravação.Todos | |
| Pesquisar equipe | Recupera as propriedades e os relacionamentos de uma equipe. | Delegado (conta corporativa ou de estudante) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Pesquisar fluxo de membros da equipe | Recupera uma lista de membros da equipe. | Delegado (conta corporativa ou de estudante) | 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 de estudante) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** | |
| Remover membro da equipe | Remove o membro indicado da equipe especificada. | Delegado (conta corporativa ou de estudante) | MembroDaEquipe.LeituraGravação.Todos | |
| Desarquivar equipe | Restaura uma equipe arquivada. Permite que os membros publiquem em canais na equipe, façam comentários e curtam publicações novamente. | Delegado (conta corporativa ou de estudante) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Atualizar equipe | Atualiza as propriedades de uma equipe específica. | Delegado (conta corporativa ou de estudante) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
As ações na tabela a seguir usam a conexão do Microsoft Teams Graph Client e o registro de alias de credencial. Essas ações exigem as permissões da aplicação.
| Categoria | Ação | Descrição | Permissões necessárias (do menos para o mais privilegiado) | |
|---|---|---|---|---|
| Gestão de calendário | Criar reunião | Cria um evento de reunião on-line no calendário do MS Teams. | Aplicação | Calendários.Leitura/Gravação |
| Excluir reunião | Exclui o evento de reunião do calendário do MS Teams. | Aplicação | Calendários.Leitura/Gravação | |
| Pesquisar reunião | Recupera detalhes do evento da reunião do calendário do MS Teams. | Aplicação | Calendários.Leitura | |
| Pesquisar ocorrências de reunião | Recupera a ID da reunião secundária de recorrência do calendário do MS Teams. | Aplicação | Calendários.Leitura | |
| Pesquisar fluxo de reuniões | Recupera detalhes de eventos de reunião do calendário do MS Teams. | Aplicação | Calendários.Leitura, Calendários.LeituraGravata | |
| Atualizar reunião | Cria um evento de reunião on-line no calendário do MS Teams. | Aplicação | Calendários.Leitura/Gravação | |
| Gestão de Webhook | Pesquisar assinaturas de webhook | Recupera os detalhes da assinatura de webhook obrigatória. | Aplicação | ChannelMessage.Read.All, Chat.Read.All |
| Pesquisar fluxo de assinaturas de webhook | Recupera detalhes de todas as assinaturas de webhook. | Aplicação | ChannelMessage.Read.All, Chat.Read.All | |
| Renovar assinatura de webhook | Renova a assinatura do webhook especificada. | Aplicação | ChannelMessage.Read.All, Chat.Read.All | |
| Assinar webhook | Cria uma assinatura de webhook para o recurso especificado. | Aplicação | ChannelMessage.Read.All, Chat.Read.All | |
| Cancelar assinatura do webhook | Exclui a assinatura do webhook especificada. | Aplicação | ChannelMessage.Read.All, Chat.Read.All | |
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 na ação Pesquisar programações na categoria Gestão de calendário usam o alias de conexão e de credencial do Microsoft Teams Spoke e exigem permissões delegadas.
- As ações do spoke do Calendar e do Webhook Management (exceto Pesquisar ações de programações no Calendar Management) usam o alias de conexão e de credencial das credenciais do cliente de gráfico do Microsoft Teams e essas ações exigem permissões do aplicativo.
Se você quiser usar o Microsoft Teams Graph Spoke 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 Graph API do Microsoft Teams 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 o artigo da Base de conhecimento - KB1635160 na 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, o ID do grupo ou o ID da equipe como uma das entradas. Para saber esses detalhes, faça login em Microsoft Teams, navegue até Teamse clique em Obter link para o canal do 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%3a1aa3730712e245a0af31e4095d66d613%40thread.skipe /New%2520channel%2520in%2520team? groupId= 7fb91938-5e8c-4968-bf7d-3987df7716f3 &tenantId= a46df9b7-2c9b-49d5-8c9f-d1b3de4ba59f, the group ID and team ID are 7fb91938-5e8c-4968-bf7d-3987df7716f3, and the channel ID is19:1aa3730712e245a0af31e4095d66d613@thread .Skey ou 1aa3730712e245a0af31e4095d66d613.
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 do spoke
O Microsoft Teams Graph spoke adiciona o Microsoft Teams Graph Spoke à sua instância da ServiceNow e inclui esses módulos.
| 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 de webhook | Exibe os detalhes das assinaturas de webhook. |
Microsoft requisitos de conta
O Microsoft Teams Graph spoke requer o registro de uma aplicação usando o portal do Azure Microsoft para gerar tokens OAuth 2.0.
Requisitos de aliases de conexão e credencial
IntegrationHub O usa aliases para gerenciar informações de conexão e de credencial 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 Configurar Microsoft Teams Graph spoke..
Requisitos do MID Server
As ações Microsoft Teams Graph spoke usam chamadas REST, que podem ser executadas em uma instância ou MID Server. Use o registro de conexão associado ao alias Microsoft para configurar onde as ações são executadas, bem como definir MID Server atributos de seleção. Para obter mais informações, consulte MID server.