Testando webhooks - Ferramentas do painel e monitoramento
O painel do finlight oferece ferramentas completas de teste e monitoramento para garantir que sua integração de webhooks funcione de forma confiável. Use esses recursos integrados para validar, testar e depurar seus endpoints de webhook.
Resumo dos recursos do painel
Principais ferramentas do painel
Lista de webhooks:
- Veja todos os seus webhooks configurados
- Veja o status (habilitado/desabilitado) de relance
- Acesso rápido aos detalhes do webhook
Página de detalhes do webhook:
- Aba de configuração - Ver/editar as configurações do webhook
- Aba de histórico de chamadas - Ver todas as tentativas de entrega
- Botão de teste - Funcionalidade de teste manual
Recursos do histórico de chamadas:
- Filtragem por status - Mostrar apenas sucessos ou falhas
- Registros detalhados - Clique nas entradas para ver os dados completos de requisição/resposta
Painel de detalhes do webhook
Acesse sua interface de gerenciamento de webhooks em app.finlight.me/news-webhooks para ver e gerenciar todos os seus webhooks.
Acessar os detalhes do webhook
- Navegue até sua lista de webhooks no painel
- Clique no botão "Show" do webhook para ver sua página de detalhes
- Veja informações completas sobre a configuração e o desempenho do seu webhook
A página de detalhes do webhook oferece:
- Visão geral da configuração - Configurações atuais e critérios de filtragem
- Histórico de chamadas - Registro completo de todas as tentativas de webhook
- Controles de teste - Funcionalidade de teste manual
- Controles de edição - Edição manual após a criação
Teste manual
Recurso de teste de webhook
O painel inclui um botão "Test" que envia uma carga de amostra ao seu endpoint:
Como usar:
- Abra a página de detalhes do seu webhook
- Clique no botão "Test" no painel superior
- Aguarde alguns segundos até que a requisição de teste seja concluída
- Revise os resultados do teste no histórico de chamadas (talvez seja necessário atualizar a página)
O que acontece:
- Envia uma carga de amostra realista ao seu endpoint configurado
- Usa suas configurações reais de autenticação
- Inclui os cabeçalhos de validação de assinatura adequados
- Registra a tentativa de teste no seu histórico de chamadas
Carga de teste: O teste envia um evento de artigo simulado que segue a mesma estrutura das entregas reais de webhook, permitindo que você valide:
- A acessibilidade e a resposta do endpoint
- A configuração de autenticação
- A lógica de processamento da carga
- As capacidades de tratamento de erros
Histórico de chamadas e monitoramento
Ver o histórico de chamadas
A página de detalhes do webhook exibe um histórico de chamadas completo com todas as tentativas de entrega:
Informações exibidas:
- Marca de tempo - Quando o webhook foi enviado
- Status - Sucesso (2xx) ou Falha (4xx/5xx)
- Código de resposta - Código de status HTTP retornado pelo seu endpoint
- Tempo de resposta - Quanto tempo seu endpoint levou para responder
- Resposta - A resposta completa (cabeçalho e corpo) dentro do conteúdo suspenso ao clicar em "Show"
Requisições bem-sucedidas vs. falhas
Requisições bem-sucedidas (✅):
- Códigos de status HTTP 200-299
- Resposta recebida dentro do tempo limite
- Confirmação adequada do seu endpoint
Requisições falhas (❌):
- Códigos de status HTTP 400-599
- Tempos limite de rede ou erros de conexão
- Falhas de autenticação
- URLs de endpoint inválidas
Depuração com o painel
Usar o histórico de chamadas para depurar
O histórico de chamadas é sua principal ferramenta para diagnosticar problemas de webhook:
Identificar padrões:
- Filtrar por status - Ver apenas as requisições falhas para identificar problemas
- Verificar marcas de tempo - Procurar padrões temporais nas falhas
- Revisar os códigos de resposta - Entender o que seu endpoint está retornando
- Examinar as tentativas de reenvio - Ver quantas vezes a entrega foi tentada
Indicadores comuns de falha:
- HTTP 401/403 - Problemas de autenticação ou autorização
- HTTP 404 - URL de endpoint incorreta
- HTTP 500 - Erros internos do servidor na sua aplicação
- Tempos limite - Seu endpoint está demorando demais para responder
- Erros de conexão - Problemas de conectividade de rede
Informações detalhadas do erro
Clique em qualquer entrada do histórico de chamadas para ver:
- Os cabeçalhos de requisição completos enviados ao seu endpoint
- Os cabeçalhos de resposta recebidos do seu endpoint
- O conteúdo do corpo da resposta (se houver)
- As informações de tempo exato
- O histórico de reenvios das tentativas falhas
Requisitos do endpoint
Requisitos de resposta
Seu endpoint de webhook deve:
Resposta HTTP:
- Retornar códigos de status 200-299 para processamento bem-sucedido
- Responder em menos de 30 segundos para evitar tempos limite
- Aceitar requisições POST com cargas JSON
Cabeçalhos:
- Processar
X-Webhook-Signaturepara a validação de assinatura - Tratar
X-Webhook-Timestamppara a prevenção de ataques de repetição - Suportar os cabeçalhos do método de autenticação escolhido
Para orientação sobre a configuração de webhooks, consulte a documentação principal de webhooks. Para detalhes de autenticação, consulte o guia de autenticação.