Webhooks

Webhooks avisam a sua aplicação no momento em que um evento acontece, em vez de você consultar a API à espera de novidade. Hoje o caso de uso é o SMS bidirecional: as respostas dos seus destinatários chegam por aqui — e só por aqui, não há polling equivalente.

  • Visão geral

    Receba eventos da FonteData em tempo real: quando usar webhooks, como registrar e o que a sua aplicação precisa responder.

  • Assinatura e verificação

    Verifique o header X-FonteData-Signature (HMAC-SHA256) antes de confiar no conteúdo, com exemplos em Python e Node.

  • Catálogo de eventos

    Os tipos de evento disponíveis para assinatura, o envelope da entrega e os campos de cada um.

  • Reentrega e confiabilidade

    Retentativas com backoff por 24 horas, deduplicação por event_id e como responder rápido sem perder evento.

Antes de começar

Os webhooks são cadastrados no painel, não pela API: acesse app.fontedata.comWebhooks. O segredo de assinatura aparece uma única vez, na criação.