Configuración - Contractia API

El webhook se configura exclusivamente en el momento de creación de la tarea mediante la API REST de Contractia.

No es posible agregar, editar ni eliminar el webhook de una tarea ya existente.

Cada tarea admite una URL de webhook independiente, lo que permite enrutar notificaciones a distintos endpoints según el flujo de negocio.

Campo webhook en la creación de tarea

💻 Ejemplo de implementación

"webhook": {
  "enabled": true,
  "url": "https://tu-dominio.com/webhook-handler"
}

"webhook": null

{
  "referencia": "string",
  "secuencial": true,
  "submission_id": "string",
  "notificacion_tarea": {
    "asunto": "string",
    "body": "string"
  },
  "remitente": {
    "remitente_nombre": "string",
    "remitente_email": "string"
  },
  "expiration_date": "2025-01-01T00:00:00.000Z",
  "webhook": {
    "enabled": true,
    "url": "https://tu-dominio.com/webhook-handler"
  },
  "reminder": {
    "frequency": 0,
    "unit": "string"
  },
  "merge_documents": true
}

Tipos de Eventos

Contractia emite dos tipos de eventos a través del webhook:

`event_type`	Descripción
`TASK_STATUS_CHANGED`	El estado general de la tarea cambió (ej.: pasó a “Concluída” o “En progreso”).
`PARTICIPATION_STATUS_CHANGED`	El estado de un participante cambió. Actualmente solo se emite cuando una participación requiere validación manual en el portal.