Passar para o conteúdo principal

Como verifico e reprocesso minha integração?

Verificando resultados de envio, consultando logs de webhook e reprocessando falhas.

Escrito por Débora Sampaio
Atualizado hoje

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.


Como verificar o resultado de um envio

A Linkana disponibiliza os registros dos eventos gerados para cada fornecedor. Cada requisição realizada pelo middleware é registrada como uma "mensagem". Os últimos envios ficam disponíveis no painel da respectiva homologação que gerou o evento, em Webhooks.

Para conferir o resultado do envio, clique no último evento disponível.

Você será redirecionado para a tela de detalhes do envio:

Clicando na seta indicada acima, o campo Message Content será reduzido e você poderá consultar todas as tentativas daquela mensagem em Webhook Attempts:

Clicando na seta correspondente a cada envio, você poderá ver o resultado daquela operação:

Para cada tentativa de envio, é possível verificar a resposta do middleware em RESPONSE, que contém:

  • 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.


Como reprocessar um envio com erro

O middleware processa todas as requisições enviadas ao sistema de destino. Se ocorrer um erro de responsabilidade da Linkana, um ticket é automaticamente gerado para a equipe, que resolve o problema em até um dia útil.

Alguns erros exigem coordenação com o cliente. Essas situações serão notificadas por e-mail e terão o detalhamento registrado nos logs para o devido tratamento.

Para erros em que a correção envolve a alteração de dados no painel do fornecedor, o próprio usuário pode corrigir e reenviar. O primeiro passo é editar a informação que precisa ser alterada. Após isso, acesse a homologação do fornecedor que deseja reenviar:

Na tela seguinte, clique em Enviar webhook:

Nesse momento, uma nova mensagem será enviada ao middleware. Você pode acompanhar o andamento na seção Webhooks da homologação, conforme descrito acima.

Respondeu à sua pergunta?