Quando os dados são enviados ao meu sistema?
Após a ocorrência do evento definido para disparo da integração (exemplo: aprovação do fornecedor), um webhook é enviado ao middleware construído para a sua integração. Nesse momento, os dados serão tratados de acordo com o definido no projeto de desenvolvimento, para então serem enviados no formato adequado ao sistema de destino.
Registro de eventos
A Linkana disponibiliza os registros dos eventos gerados para cada fornecedor. Cada requisição realizada pelo middleware é registrada como uma “mensagem”, e por meio da identificação dessa mensagem é possível verificar o resultado da sua integração.
O id da última mensagem enviada fica disponível no painel do fornecedor, no menu superior direito, em “Ver retorno da integração".
Por exemplo, o id do último evento supplier.approved para o fornecedor abaixo está destacado na imagem:
💡 Na tela acima, também é possível reenviar o webhook, nos casos em que isso se fizer necessário, clicando-se em “enviar informações manualmente”.
Para acessar o registro de todas as execuções, basta ir em “Configurações > Webhooks > Logs".
Então, para visualizar a requisição de um fornecedor específico, deve-se utilizar o id da última mensagem enviada, que foi coletado no painel do fornecedor, e inseri-lo em “Jump to Message" e clicar em “Go":
Na tela seguinte, será possível visualizar o payload enviado ao middleware (Message content) antes do tratamento e todas as tentativas de envio dessa mensagem em Webhook Attempts.
Para cada uma das tentativas de envio, é possível verificar a resposta do middleware em “RESPONSE”, que contém os campos:
destination_response: resposta completa do sistema de destino, indicando o resultado da ação. Erros indicados pelo sistema de destino serão apontados nesse campo;
linkana_payload: payload já tratado enviado pela Linkana ao sistema de destino.
Em caso de dúvidas, há um vídeo de demonstração do processo.
Identifiquei um erro, e agora?
Para correções de erro, seguir o procedimento descrito em Reprocessamento de integrações.