Webhooks personalizados
Construa o que quiser em cima do Analyse: cada evento de blog pode ser entregue no seu próprio endpoint HTTP como payload JSON, assinado com HMAC-SHA256 para que possa verificar a origem.
Todos os eventos de blog
Subscreva blog_post.published, updated, unpublished e deleted — cada um entregue como HTTP POST com corpo JSON.
Pedidos assinados com HMAC
Com um segredo de assinatura definido, cada pedido inclui um cabeçalho X-Analyse-Signature — o HMAC-SHA256 do corpo bruto — para que o seu endpoint possa verificar a autenticidade.
Vários endpoints
Adicione quantos endpoints webhook precisar, cada um com o seu URL, segredo e subscrições de eventos.
Como funciona
Aponte o Analyse para o seu endpoint, escolha os eventos e verifique a assinatura.
- 1
Adicionar o seu endpoint
No Analyse, abra Integrações → Webhook e introduza o URL que deve receber eventos, mais um segredo de assinatura opcional.
- 2
Escolha os seus eventos
Selecione que eventos de blog são entregues — publicado, atualizado, retirado da publicação ou eliminado.
- 3
Verificar a assinatura
Calcule o HMAC-SHA256 do corpo bruto do pedido com o seu segredo e compare-o com o cabeçalho X-Analyse-Signature.
- 4
Enviar um evento de teste
Entregue um payload de exemplo para confirmar que o seu endpoint o processa corretamente.
Perguntas frequentes
Como é o payload?
Um HTTP POST com Content-Type: application/json contendo o nome do evento, um timestamp e os dados do artigo: id, título, slug, excerto, corpo em markdown, URL da imagem em destaque, data de publicação, URL e categorias. Eventos de retirada da publicação e eliminação trazem corpo nulo.
Que eventos estão disponíveis?
blog_post.published, blog_post.updated, blog_post.unpublished e blog_post.deleted. Escolhe quais cada endpoint recebe.
Como verifico que um pedido veio do Analyse?
Defina um segredo de assinatura; cada entrega inclui então X-Analyse-Signature: sha256=<hex>, o HMAC-SHA256 do corpo bruto com o seu segredo. Rejeite tudo o que não corresponda.
Construa em cima dos eventos Analyse
Webhooks JSON assinados para cada evento de blog — ligue o que quiser.