TekHook

De Tek-System Wiki
Ir para navegação Ir para pesquisar

Tekhook logo.png

A aplicação TekHook foi desenvolvida com o propósito de facilitar a integração com outros sistemas por meio de webhooks. Ao criar um novo webhook, uma URL é gerada e deve ser utilizada para receber requisições.

Acesso

A página web para configurar os webhooks e acessar os logs está disponível no seguinte endereço: [1](https://tekhook.teksystem.com.br).

Login/Logout

As credenciais de acesso à aplicação são as mesmas utilizadas no sistema de atendimento da Tek-System. Basta inserir o usuário e senha e clicar no botão "Acessar", ou pressionar "Enter". Para sair da aplicação, clique no botão com três pontos no canto superior direito da tela e selecione a opção "Logout".

Criar Novo Token

No menu lateral da aplicação, selecione a opção "Webhooks". Na tela que se abre, é possível visualizar uma lista com todos os webhooks cadastrados e ainda um componente para realizar consultas. Para criar um novo token, clique no botão "+ NOVO TOKEN".

Preencha o formulário com as informações solicitadas:

  • Código do cliente.
  • CNPJ: da empresa que utilizará o webhook.
  • Descrição: para o propósito deste webhook.
  • Funcionalidade: selecione a funcionalidade cadastrada na TekStore para uso deste webhook. Apenas serão exibidas as funcionalidades cadastradas para o código do cliente preenchido.

Tekhook novo token.png

Para salvar as alterações, clique no botão 'SALVAR' na barra superior. É possível copiar a URL para uso deste webhook clicando no botão 'COPIAR URL' na mesma barra. A URL terá sempre o formato: https://tekhook.teksystem.com.br/hook/{TokenWebhook}.

Encaminhamentos

Um encaminhamento é uma nova requisição realizada assim que o webhook for acionado, ou seja, as informações recebidas são encaminhadas para um novo endereço.

Para adicionar um novo encaminhamento, clique no botão '+ ADICIONAR ENCAMINHAMENTO'. Preencha o verbo HTTP usado nessa requisição e a URL. A opção PADRÃO cria uma requisição com o mesmo verbo, parâmetros (query) e corpo da requisição (body) recebidos.

Tekhook encaminhamento padrao.png

Caso a opção PADRÃO não seja utilizada, é possível preencher manualmente quais dados serão enviados, incluindo query, body e headers.

Tekhook encaminhamento get.png

Para salvar as alterações, clique no botão 'SALVAR' na barra superior.

Logs

Para acessar os logs, selecione a opção "Logs" no menu lateral da aplicação. Em seguida, preencha os campos de consulta para especificar a busca ou deixe em branco para mostrar todos os registros ordenados pela data de inclusão. Para ver os detalhes de um log, clique sobre o registro e serão exibidos todos os dados recebidos por um webhook.