Recibir eventos con un webhook

Antes, emití una key para el sistema que va a recibir los avisos, con permiso de lectura sobre lo que tiene que leer: Entregas de EPP para las firmas y devoluciones, Constancias de capacitación para los vencimientos e Incidentes para los incidentes.

1. En el panel administrativo, andá a Configuración → API → Webhooks.
2. Tocá Nuevo webhook.
3. En Destino, poné la dirección https:// de tu sistema que va a recibir los avisos.
4. En Key, elegí la key de ese sistema. El webhook recibe solo los eventos de lo que esa key puede leer.
5. En Eventos, marcá los que querés recibir (ver Eventos).
6. Tocá Crear webhook.
7. Arriba de la lista aparece el secreto de firma. Tocá Copiar secreto y guardalo en tu sistema: con él se verifica que cada aviso viene de Safety Panel.

El secreto se muestra una sola vez

Si se pierde, tocá Rotar secreto en la fila del webhook: se genera otro y el anterior deja de firmar. Actualizalo en tu sistema enseguida, porque los avisos siguientes llegan firmados con el nuevo.

La lista de webhooks

Columna	Qué muestra
Destino	La dirección y la key del webhook.
Estado	Activo; Desactivado, si dejó de recibir después de cinco avisos perdidos seguidos; Key revocada, si se revocó su key; o API apagada, si la API está apagada en la cuenta (solo se puede eliminar).
Eventos	Los eventos que recibe.
Último envío	Cuándo fue el último aviso y qué respondió tu sistema.

Reactivar, rotar y eliminar

• Reactivar vuelve a poner a recibir un webhook desactivado. Hacelo cuando tu sistema ya responda.
• Rotar secreto genera un secreto nuevo, como cuando se pierde el anterior.
• Eliminar borra el webhook y su registro de envíos. Los registros de la cuenta no se tocan.

Un webhook de una key revocada no recibe más: creá otro con la key nueva.