Webhooks

Os webhooks permitem-lhe receber eventos de consentimento como pedidos HTTP POST para o seu próprio endpoint. Utilize webhooks para sincronizar o estado de consentimento com o seu backend, CRM ou armazém de dados.

Configurar um webhook

1. Aceda a Painel → Propriedade → Webhooks → Adicionar Endpoint
2. Introduza o URL do seu endpoint (deve ser HTTPS)
3. Seleccione os eventos a enviar
4. Copie o seu segredo de webhook (utilizado para verificação de assinatura)
5. Guarde

Eventos

Evento	Accionador
consent.created	O utilizador dá consentimento pela primeira vez
consent.updated	O utilizador altera as suas escolhas de consentimento
consent.expired	O consentimento armazenado atinge a data de expiração
consent.reset	Reposição de consentimento ao nível da propriedade aplicada

Formato do payload

{
  "event": "consent.created",
  "delivery_id": "del_abc123",
  "timestamp": "2026-03-09T12:00:00Z",
  "property_id": "prop_xyz",
  "data": {
    "receipt_id": "rec_def456",
    "policy_id": "pol_ghi789",
    "policy_version": 3,
    "choices": {
      "necessary": true,
      "analytics": true,
      "marketing": false,
      "functional": true
    },
    "region": "DE",
    "user_agent_hash": "sha256:abc...",
    "ip_hash": "sha256:def..."
  }
}

Verificar assinaturas

Verifique sempre o cabeçalho X-ConsentForge-Signature antes de processar. Consulte Segurança de Webhooks para exemplos de código.

Testar webhooks

Utilize o botão Testar nas definições de webhook do Painel para enviar um payload de exemplo para o seu endpoint. Pode também utilizar webhook.site para testes locais.

Consultar o histórico de entregas

Painel → Propriedade → Webhooks → Registo de Entregas mostra todas as tentativas de entrega com códigos de estado e corpos de resposta.