Configure um webhook bidirecional para Microsoft Teams Graph spoke

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 necessária do IntegrationHub
    • 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 a aplicação 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 de webhook Assinar.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegue 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 estes 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 do webhook de assinatura
      Teste o. Webhook subfluxo para os tipos de mudança necessários.
    6. Clique em Executar teste.
      A assinatura para o canal necessário foi criada.

      Consulte Criando subfluxos para obter mais informações sobre testes de subfluxos.

    Personalize um subfluxo de 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. Navegue 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, Notificações de entrada do processo 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, Processo de notificações de entrada subfluxo.
    6. Clique em Cópia .
      Uma cópia do subfluxo é criada.
    7. Personalize o subfluxo de acordo com sua necessidade 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 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 no Documento : lista. Por exemplo, Processo de notificações de entrada .
      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.