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 Microsoft EntraID spoke (anteriormente MicrosoftAzure Active Directory 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 no Microsoft Teams Graph spokesão criados a partir dos grupos em Microsoft Entra ID (anteriormente Microsoft Azure Active Directory ). Para criar uma equipe usando Microsoft Teams Graph spoke, o grupo associado deve estar presente em Microsoft Entra ID.
- A gestão de usuários e grupos pode ser feita usando 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É igual ao 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 Cronogramas jurídicos - Visão geral do IntegrationHub.
Versão do spoke
Microsoft Teams Graph spokev 4.3.0 é a versão mais recente.
Versão compatível
Microsoft REST API do gráfico v1.0.
Dependências do spoke
Se você estiver tendo problemas para instalar o app, confirme se estes plug-ins dependentes estão instalados:
- ServiceNow IntegrationHub Tempo de execução (com.glide.hub.integration.runtime)
- Modelo do Flow Designer (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 de spoke
. Microsoft Teams Graph spokeFornece um fluxo de amostra, Atualizações de anotações de trabalho de incidentes pós-ServiceNow no bate-papo do Microsoft Teams, para demonstrar como automatizar a 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:
| 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 Renovar Assistente de assinatura do webhook | Renova uma assinatura se a renovação for necessária, o que é decidido com base nas entradas. |
| Renovar assinaturas do webhook | Recupera todas as assinaturas do 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
. Microsoft Teams Graph spokefornece ações para automatizar tarefas de equipe e canal quando um incidente é criado no ServiceNow instância.
Você pode executar algumas ações usando a conexão do 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 a conexão do spoke do Microsoft Teams e o registro de alias de credencial. 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 escolar) | 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 escolar) | TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser | |
| Gestão de calendário | Pesquisar cronogramas | Recupera as informações de disponibilidade (livre ou ocupado) 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 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) | ChannelMember.ReadWrite.All |
| Criar Canal | Crie um novo canal em uma equipe. | Delegado (conta corporativa ou escolar) | Channel.Create, 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) | Channel.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.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 com um nome de canal e um ID de equipe. | Delegado (conta corporativa ou escolar) | ReadBasic.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 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) | ChannelMessage.Read.All | |
| Pesquisar canais | Recupera a lista de canais nessa equipe. | Delegado (conta corporativa ou escolar) | ReadBasic.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 escolar) | ChannelMember.ReadWrite.All | |
| Gestão do bate-papo | Criar bate-papo | Cria um bate-papo entre usuários. | Delegado (conta corporativa ou escolar) | Bate-papo.Criar, Bate-papo.ReadWrite |
| 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 escolar) | 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 escolar) | Bate-papo.Read, Bate-papo.ReadWrite | |
| Pesquisar conversas | Recupera a lista de bate-papos em que o usuário participa. | Delegado (conta corporativa ou escolar) | Bate-papo.ReadBasic, Bate-papo.Read, Bate-papo.ReadWrite | |
| Pesquisar mensagem | Recupera os detalhes da mensagem especificada. | Delegado (conta corporativa ou escolar) | Bate-papo.Read, Bate-papo.ReadWrite | |
| Pesquisar fluxo de respostas a mensagens | Recupera a lista de respostas da mensagem especificada do canal de uma equipe. | Delegado (conta corporativa ou escolar) | ChannelMessage.Read.All | |
| Publicar mensagem no bate-papo | Publica mensagens em um bate-papo do Microsoft Teams. | Delegado (conta corporativa ou escolar) | 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 escolar) | 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 escolar) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publicar mensagem | Publica mensagens em um canal do Microsoft Teams. | Delegado (conta corporativa ou escolar) | 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 escolar) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publicar resposta à mensagem | Publica uma resposta à mensagem especificada. | Delegado (conta corporativa ou escolar) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publicar detalhes do registro | Publica detalhes do registro definido no canal especificado do Microsoft Teams. | Delegado (conta corporativa ou escolar) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 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 é igual ao ID do grupo. | Delegado (conta corporativa ou escolar) | Group.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.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 escolar) | TeamMember.Read.All, TeamMember.ReadWrite.All | |
| Pesquisar equipes por usuário | Lista as equipes do usuário com IDs e seus nomes de exibição. | Delegado (conta corporativa ou escolar) | 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 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 publicações 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 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 | 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 a 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 | |
| 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 Spoke do Microsoft Teams os 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 Cronogramas de pesquisa na Gestão de calendários) usam Credenciais do cliente do Microsoft Teams Graph os 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%2520channel%2520em%2520equipe? 7fb91938-5e8c-4968-bf7d-3987df7716f3 e 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.
Agentes de IA disponíveis
Instalar Now Assist Spokes e comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist Para Spokes.
Este spoke fornece agentes de IA autônomos que imitam inteligência semelhante à humana para executar tarefas em seu ServiceNow instância.
- Em ServiceNow Sistema agentic, você pode criar um fluxo de trabalho agentic que compreende um conjunto de instruções de modelo de linguagem grande (LLM) junto com um ou mais agentes de IA autônomos para executar um objetivo. Consulte Create an agentic workflow Para obter informações sobre como adicionar agentes de IA para criar fluxos de trabalho do agente de acordo com sua necessidade e fornecer o gatilho necessário.
Você também pode pesquisar outros agentes de IA disponíveis e adicioná-los ao fluxo de trabalho do agente. Para obter mais informações, consulte Find AI agents.
- Você pode criar um clone do agente de IA do spoke necessário e personalizá-lo de acordo com seu requisito. Consulte Duplicate an AI agent para obter mais informações sobre como criar um clone.
- Consulte Now Assist AI agents Para obter informações sobre agentes de IA.
Os agentes de IA disponíveis incluem:
| Agente de IA | Descrição |
|---|---|
| Microsoft Teams Agente de IA de gestão de aplicações | Automatiza tarefas relacionadas ao Microsoft Teams e. IntegrationHub. Executa ações como pesquisar instalações de aplicações e instalar aplicações para os usuários. |
| Microsoft Teams Agente de IA de gestão de canais | Gerencia Microsoft Teams Por meio do IntegrationHub. Ele fornece recursos como criar canais, gerenciar membros e recuperar informações do canal. |
| Microsoft Teams Agente de IA de gestão de bate-papo | Automatiza fluxos de trabalho entre a ServiceNow e. Microsoft Teams fornecendo recursos como pesquisar bate-papos e mensagens. |
| Microsoft Teams Agente de IA de gestão de notificações | Automatiza a comunicação entre a ServiceNow e. Microsoft Teams enviando mensagens, atualizações e respostas para Microsoft Teams canais. O agente oferece suporte a ações como "Publicar detalhes da mudança", "Publicar mensagem" e "Publicar resposta à mensagem" para garantir uma gestão de notificações eficaz para solicitações de mudança. |
| Microsoft Teams Agente de IA de gestão de equipe | Automatiza tarefas como criar e gerenciar equipes, adicionar ou remover membros e recuperar informações relacionadas à equipe. Aprimora a gestão de equipes e os fluxos de trabalho de comunicação em uma organização. |
| Microsoft Teams Agente de IA de gestão de calendários | Automatiza fluxos de trabalho entre ServiceNow e. Microsoft Teams. Fornece recursos de gestão de calendário. Executa ações como excluir e recuperar detalhes da reunião. |
Procurando um agente de IA?
- Pode haver agentes de IA instalados com o. Now Assistaplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis em sua instância, consulte Encontre agentes de IA .
- Para encontrar agentes que podem não estar instalados em sua instância, visite Mercado de agentes de IA em ServiceNow Store.
Nota:
Certifique-se de que o usuário que executa um agente de IA tenha as funções e permissões necessárias para acessar dados ou executar operações em dados na tabela associada ao agente de IA.
Módulos de spoke
. Microsoft Teams Graph spokeAdiciona 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 do webhook. |
Microsoft requisitos de conta
. Microsoft Teams Graph spokerequer o registro de uma aplicação usando Microsoft Portal do Azure para gerar tokens OAuth 2,0.
Requisitos de aliases de conexão e credencial
IntegrationHub 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 Microsoft alias para configurar onde as ações são executadas e definidas MID Server atributos de seleção. Para obter mais informações, consulte MID server.
Para configurar o. MID Serverpara este spoke, consulte Configurar MID Server para um spoke.