Configure um evento de webhook

Configure um evento de API do webhook na tabela de configuração do provedor para permitir que os fornecedores de crachás compartilhem os dados de crachás coletados das tabelas de crachás usando o evento webhook.

Antes de Iniciar

Função necessária: sn_wsd_wc.admin

Por Que e Quando Desempenhar Esta Tarefa

Os dados do selo (JSON) são processados usando o. ServiceNow REST API explorer. Um ou vários registros brutos de dados de crachá (carga) podem ser compartilhados e processados usando o explorador da REST API. O evento webhook para dados de crachá é carregado na tabela Eventos do conector em um ou vários registros JSON. Vários registros são enviados como uma matriz. Para obter mais informações, consulte Análise de participação.

Procedimento

1. Navegar até Tudo > Conectores do Workplace > Configurações do conector do provedor.
2. Selecione Criar novo.

   No formulário, preencha os campos.

   Tabela 1. Formulário de configuração do conector do provedor

   Campo	Descrição
   Nome	Nome da configuração do provedor.
   Tipo de Origem	Origem de onde os dados do selo são coletados e carregados na tabela de presença do funcionário de destino. Selecione Webhook para configurar o evento webhook.
   Nome do parâmetro do token	. Nome do parâmetro do token e. Valor do token É um par de chave-valor secreto, que é usado para autenticar a chamada de API do sistema de crachá do fornecedor para o. Conectores para local de trabalho aplicação. Ambos os sistemas têm o valor do nome do token. Usando o nome do token, a aplicação autentica a solicitação de API.
   Valor do token	O valor do token é a chave secreta usada pelo fornecedor do selo ao chamar o evento da API para permitir que o servidor autentique a solicitação da API.
   Ativo	Opção para indicar que a configuração do provedor está Ativa.
   Configuração do Conector	Opção para pesquisar e selecionar o ícone da lista de pesquisa ( ) para selecionar Selo . Para obter mais informações, consulte Configurar conectores para dados de selo.
   URL do Retorno de Chamada	Opção para selecionar o ícone de URL de retorno de chamada ( ) Para bloquear ou editar o URL de retorno de chamada.

3. Selecione Atualizar.
4. Selecione o evento webhook recém-criado.

   O botão Gerar URL de retorno de chamada está disponível para gerar um URL de retorno de chamada para a solicitação da REST API.

5. Como fornecedor de crachá, compartilhe os dados do crachá no formato JSON navegando até Tudo > Serviços web do sistema > REST > REST API Explorer.
6. Na página Explorador da REST API, selecione o seguinte:
   • Namespace: Na lista suspensa, selecione sn_wsd_wc
   • Nome da API: Webhook do conector do local de trabalho
   • Versão da API: v1
7. Na página Evento do webhook do conector do local de trabalho, forneça os seguintes valores:
   • Token_name: Nome do parâmetro do token usado na etapa 2. O valor do nome do token é usado pelos fornecedores de crachá para compartilhar os dados de crachá (JSON) com Conectores para local de trabalho. Os dados brutos (dados de carga ou selo) são processados e carregados na tabela de eventos do conector.
   • ni.nolog.id: Copie o ID do sistema do webhook criado na etapa 2 e cole-o. Selecione o ícone do menu de ações adicionais ( ) no painel.
   • Token_value: Valor do token fornecido na etapa 2. O valor do token é a chave secreta usada pelo fornecedor do selo ao chamar o evento da API para permitir que o servidor autentique a solicitação da API.
   1. No corpo da solicitação de API, selecione Bruto E copie os dados do selo (carga) no formato JSON.
      Esses dados de crachá são coletados de sensores de crachá.
   2. Selecione "Enviar".
      Se o código de resposta for 200 OK e o resultado da resposta é Sucesso , Os dados do selo são carregados na tabela de eventos do conector.

      • A tabela Eventos do conector (sn_wsd_wc_connector_events) carrega os dados do selo compartilhados pelos fornecedores de selo. O estado dos dados do selo é Novo Quando é carregado pelo Explorador da REST API.
      • O trabalho agendado Processar registros de dados do provedor de webhook É executado a cada minuto para carregar os dados do selo da tabela Eventos do conector (dados com o estado Novo ) Para a tabela Dados de frequência do funcionário.
   O trabalho agendado usa os dados de origem do Webhook Evento para transformar os dados no formato necessário e colocá-los na tabela de dados de frequência do funcionário de destino.

   Nota:

   Para acessar o. Conectores para local de trabalho trabalhos agendados, navegue até Tudo > Definição do Sistema > Trabalhos agendados. Pesquisar Conectores do local de trabalho Na coluna Aplicação. Há dois trabalhos agendados disponíveis para Conectores para local de trabalho.

   • Registros de dados do provedor de processos : Lê dados de dados do selo do fornecedor (tabela de origem). Depois de processar os dados do selo, o registro os carrega na tabela Dados de frequência do funcionário (tabela de destino). Para obter mais informações, consulte Configure dados da tabela de crachá.
   • Processar registros de dados do provedor de webhook : Lê dados da tabela Eventos do conector. Processa os dados do evento webhook e os carrega na tabela Dados de frequência do funcionário (tabela de destino).
   • Os dados são carregados na tabela Dados de frequência do funcionário. O estado dos dados do selo na tabela Eventos do conector muda para Processado .
   • Na tabela Dados de presença do funcionário, os dados são carregados na tabela Análise de presença.
     Nota:

     Os registros de dados de crachá na tabela Eventos do conector com o estado Processado são limpos após dois dias a partir da data de criação ou da data atual pela tabela Eventos do conector [sn_wsd_wc_connector_events]. Os dados no estado Erro são limpos após sete dias a partir da data de criação. Os dados no estado Novo não são limpos.

Tópico anterior: Configure dados da tabela de crachá

Próximo tópico: Dados de presença do funcionário