Saltar al contenido principal

Webhooks

Conecta Frihet a tu stack en tiempo real: eventos de facturas, presupuestos, gastos, clientes y productos, firma HMAC y reintentos automáticos.

Visión general​

Los webhooks de Frihet envían notificaciones HTTP a tu servidor cuando ocurren eventos en la cuenta: facturas creadas o pagadas, gastos nuevos, clientes actualizados, etc. Si defines un secreto al crear el webhook, cada entrega incluye una firma HMAC-SHA256 en la cabecera X-Frihet-Signature para verificar su autenticidad. Si tu servidor devuelve un error, Frihet reintenta automáticamente con espera exponencial, hasta 3 intentos en total.

Inicio rápido​

  1. Ve a Integraciones, abre la pestaña Webhooks y pulsa Crear Webhook.
  2. Escribe un nombre, pega la URL de tu servidor, elige los eventos que quieres recibir y, si quieres firmar las entregas, define un secreto.
  3. Guarda el secreto de firma al crearlo: no se vuelve a mostrar. Verifica la firma en tu servidor antes de procesar los eventos.

Desde la lista puedes editar un webhook, probarlo con Probar o eliminarlo.

Referencia​

  • API: GET /v1/webhooks (listar), POST /v1/webhooks (crear), DELETE /v1/webhooks/{webhookId} (eliminar)

Relacionado​