Microsoft Teams Graph Spoke
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:
- As 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 Microsoft somente o 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 do grupo associado em Microsoft Entra 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 spoke v4.1.1 é 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 Integration Hub Tempo de execução (com.glide.hub.integration.runtime)
- Modelo do Flow Designer Designer (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
O Microsoft Teams Graph spoke fornece um fluxo de amostra, Atualizações das anotações de trabalho pós-incidente da ServiceNow no bate-papo do Microsoft Teams, para demonstrar a automatização da tarefa de publicação de 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 subfluxos de amostras 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. |
| Renovar subfluxo do auxiliar 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 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 Spoke do Microsoft Teams e as ações restantes usando a conexão de credenciais do cliente do Graph do Microsoft Teams.
As ações na tabela a seguir usam o registro de alias de conexão e credencial do Spoke do Microsoft Teams. 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 cronogramas | 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.LeituraGravação |
| Gestão de canais | Adicionar membro ao canal | Adiciona o membro especificado ao canal especificado. | Delegado (conta corporativa ou de estudante) | MembroDoCanal.LeituraGravação.Todos |
| Criar Canal | Crie um novo canal em uma equipe. | Delegado (conta corporativa ou de estudante) | Canal.Criar, Group.ReadWrite.All**, Diretório.ReadWrite.All** | |
| Excluir canal | Remove o canal especificado da equipe necessária e exclui todas as conversas. | Delegado (conta corporativa ou de estudante) | Canal.Excluir.Todos, Group.ReadWrite.All**, Diretório.ReadWrite.All** | |
| Pesquisar canal | Recupera as propriedades e os relacionamentos de um canal. | Delegado (conta corporativa ou de estudante) | Channel.Read.Basic.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.Basic.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) | MensagemDeCanal.Leitura.Todos | |
| Pesquisar canais | Recupera a lista de canais nessa equipe. | Delegado (conta corporativa ou de estudante) | Channel.Read.Basic.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) | MembroDoCanal.LeituraGravação.Todos | |
| 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.LerGravar |
| 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.LeituraGravar | |
| Pesquisar conversas | Recupera a lista de bate-papos em que o usuário participa. | Delegado (conta corporativa ou de estudante) | Bate-papo.LeituraBasic, Bate-papo.Leitura, Bate-papo.LeituraGravar | |
| Pesquisar mensagem | Recupera os detalhes da mensagem especificada. | Delegado (conta corporativa ou de estudante) | Bate-papo.Leitura, Bate-papo.LeituraGravar | |
| 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) | MensagemDeCanal.Leitura.Todos | |
| Publicar mensagem no bate-papo | Publica mensagens em um bate-papo do Microsoft Teams. | Delegado (conta corporativa ou de estudante) | ChatMessage.Send, Chat.ReadWrite, Group.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 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** | |
| Publicar detalhes do registro | Publica detalhes do registro definido no canal especificado do Microsoft Teams. | 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 existente do Office 365. Nota: O ID da equipe é igual ao ID do grupo. | Delegado (conta corporativa ou de estudante) | Group.ReadWrite.All, Diretório.ReadWrite.All | |
| Excluir equipe | Exclui a equipe especificada. | Delegado (conta corporativa ou de estudante) | Group.ReadWrite.All | |
| 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 nos canais da 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 o registro de alias de conexão e credencial do Cliente do Graph do Microsoft Teams. 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 | 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.Lidos | |
| 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.Lidos | |
| 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.LeituraGravação | |
| Atualizar reunião | Cria um evento de reunião on-line no calendário do MS Teams. | Aplicação | Calendars.ReadWrite | |
| 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 a ação Pesquisar cronogramas na categoria Gestão de calendários usam o alias de conexão e de credencial do Spoke do Microsoft Teams e exigem permissões delegadas.
- As ações de spoke do Gestão de calendários e webhook (exceto Pesquisar ação de cronogramas na Gestão de calendários) usam o alias de conexão e credencial de credenciais do cliente do Graph do Microsoft Teams e essas ações exigem permissões da aplicação.
Se você quiser usar o Spoke do Graph do Microsoft Teams 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 no ServiceNow - NOW Support.
Para obter mais informações sobre as permissões necessárias, consulte Microsoft Teams documentação.
Nota:
Algumas das ações de 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é Equipese 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 .skipe 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 de spoke
O Microsoft Teams Graph spoke adiciona o Spoke do Graph do Microsoft Teams à 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
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 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 em uma MID Server. Use o registro de conexão associado ao alias Microsoft para configurar onde as ações são executadas, bem como definir atributos de seleção MID Server. Para obter mais informações, consulte MID server.