Configurar um webhook bidirecional para o Microsoft Teams Graph spoke

Configure um webhook para assinar o Microsoft Teams com um URL de retorno de chamada da ServiceNow.

Antes de Iniciar

• Solicitar a assinatura do IntegrationHub necessária
• Ativar o Microsoft Teams Graph spoke
• Função necessária: administrador

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

Registre o Microsoft Teams em sua instância da ServiceNow para notificar o aplicativo da 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 de 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 subfluxo Assinar Webhook.
4. Clique em Testar.
5. No formulário, preencha estes valores.

   Campo	Descrição
   Nome do registro do webhook	Nome do registro de webhook que você forneceu ao registrar o webhook na instância da ServiceNow. Por exemplo, Registro de 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, atualizadoe excluído. Você pode fornecer vários valores separados por vírgula.
   ID da Equipe	Identificador exclusivo da equipe.
   ID do Canal	Identificador exclusivo do canal.

   Figura 1. Testar o subfluxo de assinatura de webhook

   

6. Clique em Executar teste.
   A assinatura do canal necessário foi criada.

   Consulte Criação de subfluxos para obter mais informações sobre como testar subfluxos.

Personalizar 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. 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, subfluxo Processar notificações de entrada.
4. Clique no ícone de mais ações ( ) e selecione Copiar subfluxo.
5. Em Novo nome de fluxo, insira um nome exclusivo que você deseja que o subfluxo copiado tenha.
   Por exemplo, Cópia do subfluxo de notificações de entrada do processo.
6. Clique em Copiar.
   Uma cópia do subfluxo é criada.
7. Personalize o subfluxo de acordo com seus requisitos e publique-o.
   Consulte Criação de subfluxos para obter mais informações sobre como criar e usar subfluxos.

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

Crie uma política de roteamento de webhook e um 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 forem atendidas. Clique no ícone Pesquisar . Selecione o subfluxo necessário na lista Documento:. Por exemplo, Cópia de processar 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 alertados para não atualizar ou modificar diretamente os dados dessas tabelas.