analysis.completed
Cuando el análisis alcanza estado de éxito terminal.
Desarrolladores
Webhooks
Recibe callbacks HTTP firmados cuando terminan análisis, cambian obligaciones o avanza el ciclo contractual (aceptación, firma, activación).
Desarrolladores
Eventos suscritos
Registra los tipos de evento al crear la suscripción con POST /v1/webhooks.
Desarrolladores
Cabeceras X-Inkspectra-*
Cada entrega incluye X-Inkspectra-Event, X-Inkspectra-Delivery, X-Inkspectra-Timestamp y X-Inkspectra-Signature para verificación e idempotencia.
Desarrolladores
Verificar firmas
Calcula HMAC-SHA256 sobre timestamp + "." + cuerpo raw con tu secreto. Compara con X-Inkspectra-Signature (sha256=…).
import crypto from "node:crypto";
function verifyInkspectraWebhook(payload: string, signature: string, timestamp: string, secret: string) {
const expected = crypto
.createHmac("sha256", secret)
.update(timestamp)
.update(".")
.update(payload)
.digest("hex");
return signature === `sha256=${expected}`;
}Desarrolladores
Reintentos
Las entregas fallidas se reintentan con backoff. Consulta logs en la consola admin durante la beta.
Desarrolladores
Payload de ejemplo
El JSON incluye tipo de evento, contractId, analysisId, status y contexto de organización.
{
"event": "analysis.completed",
"contractId": "ctr_…",
"analysisId": "ana_…",
"status": "completed",
"organizationId": "…"
}Eventos habituales
Notificaciones de ciclo de vida
Análisis, ciclo contractual y obligaciones — según tu plan y suscripción a eventos.
analysis.failed
Cuando el pipeline no puede completar el análisis.
contract.accepted
Cuando una parte registra aceptación en un contrato invitado.
contract.signed
Cuando una parte completa firma tipada según los requisitos del contrato.
contract.activated
Cuando el contrato pasa a activo tras finalizar el ciclo de firma.
obligation.updated
Cuando cambia el estado o la fecha de una obligación rastreada.
Ver ejemplos end-to-end
Combina webhooks con analyze y poll desde la guía de ejemplos.