Webhooks
Los Webhooks (/settings/webhooks) permiten a Unimast notificar a otros sistemas en tiempo real cuando ocurren eventos importantes. A diferencia de las API Keys (donde “preguntas” por datos), los webhooks “envían” datos automáticamente (push).
Configuración
Para registrar un nuevo endpoint de notificación:
- URL de Destino: La dirección HTTPS de su servidor que recibirá la petición POST con los datos del evento.
- Eventos: Seleccione los disparadores específicos que desea escuchar (ej:
invoice.created,payment.received). Solo recibirá tráfico para los eventos marcados. - Secret (Opcional): Una cadena de texto utilizada para firmar las peticiones. Esto permite a su servidor verificar que la notificación realmente proviene de Unimast y no de un atacante.
Eventos Soportados
El sistema puede notificar sobre cambios en:
- Facturas (Creación, pago, anulación).
- Clientes (Registros nuevos).
- Inventario (Movimientos, ajustes).
Las notificaciones fallidas pueden reintentarse automáticamente dependiendo de
la configuración interna, pero es responsabilidad del sistema receptor
devolver un código de estado 200 OK rápidamente para confirmar la recepción.