Configure um webhook bidirecional para Microsoft Teams Graph spoke

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Configure um webhook para assinar o Microsoft Teams com um URL de retorno de chamada da ServiceNow.

    Antes de Iniciar

    • Solicite a assinatura do IntegrationHub necessária
    • Ative o. Microsoft Teams Graph spoke
    • Função necessária: administrador

    Registre um webhook do Microsoft Teams Graph na instância da ServiceNow

    Registre o Microsoft Teams em sua instância da ServiceNow para notificar o aplicativo ServiceNow quando determinados eventos ocorrerem no Microsoft Teams.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Spoke do gráfico do Microsoft Teams > Registro do Webhook.
    2. Clique em Nova.
    3. No formulário, preencha os seguintes campos:
      Nome Nome para identificar o registro do webhook. Por exemplo, Registro do webhook do MS Teams Graph .
      Estado do cliente Estado do cliente
      Caminho Caminho do webhook do Microsoft Teams Graph. Este campo é preenchido automaticamente para api/sn_msteams_ahv2/ms_teams_webhook .
      Descrição Descrição do registro do webhook.
    4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    5. Clique em URL de retorno de chamada .
      O sistema preenche automaticamente o URL de retorno de chamada do webhook.

    Criar assinatura de webhook para um canal

    Crie uma assinatura de webhook para o canal necessário em uma equipe testando o subfluxo Assinar webhook.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Automação de Processo > Workflow Studio.
    2. Clique em Subfluxos .
    3. Abra o. Webhook subfluxo.
    4. Clique em Testar.
    5. No formulário, preencha esses valores.
      Campo Descrição
      Nome do registro do Webhook Nome do registro do webhook que você forneceu quando você Webhook registrado na instância da ServiceNow . Por exemplo, Registro do webhook do MS Teams Graph .
      Tipo de mudança Tipo de mudança no recurso inscrito que deve enviar uma notificação de mudança. Os valores compatíveis são: criado , atualizado e excluído . Você pode fornecer vários valores separados por vírgulas.
      ID da Equipe Identificador exclusivo da equipe.
      ID do canal Identificador exclusivo do canal.
      Figura 1. Teste o subfluxo Assinar webhook
      Teste o. Webhook subfluxo para os tipos de mudança necessários.
    6. Clique em Executar teste.
      A assinatura do canal necessário foi criada.

      Consulte Criando subfluxos para obter mais informações sobre como testar subfluxos.

    Personalize um subfluxo do spoke

    Personalize o subfluxo necessário que é enviado junto com o spoke criando uma cópia dele.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Automação de Processo > Workflow Studio.
    2. Clique em Subfluxos .
    3. Abra o subfluxo necessário que é enviado junto com o spoke do Microsoft Teams Graph.
      Por exemplo, Processar notificações de entrada subfluxo.
    4. Clique no ícone Mais ações ( Menu Mais ações) e selecione Copiar subfluxo .
    5. Em Novo nome do fluxo insira um nome exclusivo que você deseja que o subfluxo copiado tenha.
      Por exemplo, Cópia das notificações de entrada do processo subfluxo.
    6. Clique em Cópia .
      Uma cópia do subfluxo é criada.
    7. Personalize o subfluxo de acordo com seu requisito e publique-o.
      Consulte Criando subfluxos para obter mais informações sobre como criar e usar subfluxos.

    Configure a política de decisão do webhook do Microsoft Teams Graph

    Crie política de roteamento de webhook e subfluxo de acordo com seus requisitos.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Spoke do gráfico do Microsoft Teams > Política da Decisão do Webhook
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de decisão
      Campo Descrição
      Rótulo Rótulo exclusivo para identificar a política de roteamento.
      Resposta

      Subfluxo que deve ser acionado quando as condições são atendidas.

      1. Clique em Pesquisa ícone .
      2. Selecione o subfluxo necessário em Documento : lista. Por exemplo, Cópia das notificações de entrada do processo .
      Resposta padrão Opção para especificar se esta resposta é a resposta padrão. A resposta padrão é aplicável quando as condições não são atendidas.
      Condição Condições a serem atendidas quando o webhook de entrada entregar dados do Microsoft Teams.
    4. Clique em Enviar.
      Nota:
      Essas políticas de roteamento são salvas nas tabelas de decisão. Os usuários são advertidos contra atualizar ou modificar diretamente os dados nessas tabelas.