Como reenviar webhooks

Em alguns casos, pode ser necessário reenviar um webhook manualmente — por exemplo, quando o servidor de destino estava indisponível no momento do envio original, ou quando você deseja reprocessar um evento. A plataforma oferece diferentes formas de reenvio: diretamente pelo histórico da venda, pela tela de configurações de webhooks (individual ou em massa).

Reenvio pelo histórico da venda

A forma mais rápida de reenviar o webhook de um evento específico de uma venda é diretamente pelo histórico da venda:

1. Acesse a aba E-commerce da Layers
2. Abra os detalhes da venda desejada
3. Na seção "Histórico", localize o evento para o qual deseja reenviar o webhook (por exemplo, sale.approved, sale.paid)
4. Abaixo do evento, clique no botão "Reenviar webhook"

O botão "Reenviar webhook" aparece apenas para eventos que possuem um webhook ativo configurado para o tipo de evento correspondente. Caso não exista nenhum webhook ativo escutando aquele evento, o botão não será exibido.

Ao clicar no botão, o webhook será reenviado para todos os webhooks ativos que estão inscritos naquele tipo de evento, criando novas tentativas de envio.

Reenvio pela tela de configurações de webhooks

Também é possível reenviar webhooks pela tela de configurações:

1. Acesse a aba E-commerce da Layers
2. Clique em "Configurações" no menu lateral esquerdo
3. Clique na aba "Webhooks"
4. Na tela de webhooks, selecione a aba "Histórico"

Na aba de histórico, você verá uma tabela com todos os envios de webhooks, incluindo informações como data, evento, Entity ID, URL, status e código HTTP.

Reenvio individual

Existem duas formas de reenviar um único webhook pela tela de configurações:

Pela tabela de histórico

Na tabela de histórico, localize o envio que deseja reenviar. Na coluna "Ações", clique no botão de reenvio (ícone de atualização). O webhook será reenviado imediatamente.

Pelo painel de detalhes

1. Na tabela de histórico, clique no botão de detalhes (ícone de olho) na coluna "Ações" do envio desejado
2. Um painel lateral será aberto com informações detalhadas sobre o envio
3. No topo do painel, clique no botão "Reenviar"

O painel de detalhes também permite visualizar o conteúdo da requisição (request) e da resposta (response) do envio original, o que pode ajudar a diagnosticar problemas antes de reenviar.

Reenvio em massa (bulk)

Se você precisa reenviar vários webhooks ao mesmo tempo, pode usar o reenvio em massa:

1. Na aba "Histórico", marque as caixas de seleção dos envios que deseja reenviar
2. Ao selecionar um ou mais itens, uma barra de ação aparecerá acima da tabela, indicando quantos itens estão selecionados
3. Clique no botão "Reenviar selecionados (X)", onde X é a quantidade de itens selecionados

O limite máximo de reenvio em massa é de 100 webhooks por vez. Após o reenvio, você receberá uma notificação indicando quantos foram reenviados com sucesso e quantos falharam, se houver.

Observações importantes

• Se o webhook de destino estiver inativo, o reenvio não será processado.
• O reenvio pelo histórico da venda dispara o webhook para todos os webhooks ativos inscritos no evento. Já o reenvio pela tela de configurações reenvia uma tentativa específica para uma URL específica.
• Para entender melhor a política de retentativas automáticas, veja a referência sobre política de retentativas.