P4 Software
/
activoHQ - Español
Un webhook notifica a otro sistema cuando ocurre un evento del ciclo de vida de un activo. activoHQ envía por HTTP POST, a la dirección que usted indique, el mismo contenido que usan las reglas de automatización: activo dado de baja, revaluado, retirado, devuelto, retiro vencido y varianza RFID detectada.
Es la vía para integrar activoHQ con su ERP, su mesa de ayuda, un canal de mensajería o cualquier servicio propio, sin que ese sistema tenga que consultar la API periódicamente.
Las entregas se reintentan automáticamente y su resultado queda visible en la misma pantalla.
Configuración > Webhooks
URL directa: /settings/webhooks

| Término | Definición |
|---|---|
| Suscripción | Una URL más la lista de eventos que le interesan. |
| Entrega | Cada intento de envío del contenido de un evento a la URL suscrita. |
| Secreto | Clave opcional con la que activoHQ firma el contenido, para que su sistema compruebe que el mensaje proviene realmente de activoHQ. |
| Firma | Valor HMAC-SHA256 del cuerpo del mensaje, enviado en la cabecera X-ActivoHQ-Signature en formato hexadecimal en minúsculas. |
AssetDisposed, AssetRevalued, AssetCheckedOut, AssetCheckedIn, AssetCheckoutOverdue, RfidVarianceDetected
Son los mismos eventos que usan las Reglas de automatización; la pantalla los muestra como valores válidos junto al campo Eventos.
El cuerpo del POST es un objeto JSON con los datos del evento, los mismos marcadores que usan las reglas (por ejemplo AssetId, AssetCode, Proceeds en una baja). No incluye el nombre del evento ni una marca de tiempo: si su sistema necesita distinguir los eventos, cree una suscripción con una URL distinta para cada uno. En los eventos de entrega, devolución y entrega vencida el activo y el empleado vienen solo como identificadores internos (AssetId, EmployeeId), no como código ni nombre.
https://example.com/webhooks/activohq.Si la URL está vacía o ningún evento indicado es válido, el sistema avisa que debe ingresar una URL y al menos un tipo de evento válido.
La sección Entregas recientes muestra, para cada intento:
| Columna | Descripción |
|---|---|
| Creado | Fecha y hora en que se generó la entrega. |
| Evento | Evento que la originó. |
| Estado | Enviado, Fallido o Pendiente. |
| Intentos | Cuántos intentos se han realizado. |
| Último error | Motivo del último fallo, cuando lo hubo. |
activoHQ procesa la cola de entregas cada minuto y reintenta las que no fueron aceptadas hasta un máximo de 5 intentos. Mientras quedan intentos disponibles, la entrega permanece Pendiente; agotados los intentos, pasa a Fallido y no se reintenta más (no hay un botón para reintentar manualmente). Si la suscripción se elimina o se desactiva antes de que la entrega se procese, esta pasa directamente a Fallido con el error Subscription not found or inactive (en inglés).
Cuando la suscripción tiene Secreto, cada POST incluye la cabecera X-ActivoHQ-Signature con el HMAC-SHA256 del cuerpo tal como se recibió, en hexadecimal minúsculas y sin prefijo. Su sistema debe recalcular ese HMAC con el mismo secreto sobre el cuerpo original y compararlo antes de procesar el mensaje.
| Campo | Tipo | Obligatorio | Descripción | Validación |
|---|---|---|---|---|
| URL | Texto | Sí | Dirección que recibe el POST. | Debe indicarse una URL. Solo se permiten destinos públicos en Internet: no se aceptan direcciones internas de red, locales ni de servicios internos de la nube. |
| Eventos | Texto | Sí | Lista de eventos separada por comas. | Al menos uno debe ser válido. |
| Secreto (opcional) | Texto | No | Clave para firmar el contenido con HMAC-SHA256. | Ninguna. |
| Activo | Casilla de verificación | No | Las suscripciones inactivas no reciben entregas. | Ninguna. |
| Síntoma | Causa probable | Solución |
|---|---|---|
| Todas las entregas aparecen Fallido. | La URL no responde, responde con error, o exige autenticación adicional. | Revise Último error, valide la URL desde fuera de su red y ajuste su receptor. |
| No se guarda el webhook. | La URL está vacía o los eventos escritos no son válidos. | Copie los nombres de evento exactamente como los muestra la pantalla. |
| La URL interna de la empresa es rechazada. | Solo se aceptan destinos públicos, por seguridad. | Exponga un extremo público (por ejemplo, una pasarela) que reenvíe a su red interna. |
| Mi sistema recibe el evento dos veces. | Un reintento se cruzó con una entrega que sí llegó. | Haga idempotente el procesamiento en su receptor. |
| La firma no coincide. | Se recalculó el HMAC sobre un cuerpo ya transformado. | Firme y verifique siempre sobre el cuerpo original recibido. |
¿Te resultó útil esta página?