Webhooks

Os webhooks permitem-lhe receber eventos de consentimento como pedidos HTTP POST para o seu próprio endpoint. Use webhooks para sincronizar o estado de consentimento com o seu backend, CRM ou data warehouse.

Configurar um webhook

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

Eventos

Evento	Acionador
consent.created	Utilizador dá consentimento pela primeira vez
consent.updated	Utilizador altera as suas escolhas de consentimento
consent.expired	Consentimento armazenado atinge a data de expiração
consent.reset	Reset de consentimento ao nível da propriedade aplicado

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. Veja Segurança de Webhook para exemplos de código.

Testar webhooks

Use o botão Testar nas definições de webhook do Painel para enviar um payload de exemplo para o seu endpoint. Também pode usar webhook.site para testes locais.

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