Payload

Contractia envía una solicitud HTTP POST a la URL configurada. El cuerpo de la solicitud es un JSON con la siguiente estructura y campos:

🧾 Descripción de campos

Campo	Tipo	Valores	Descripción
event_type	string	TASK_STATUS_CHANGED / PARTICIPATION_STATUS_CHANGED	Tipo de evento disparado.
task_id	integer	—	ID único de la tarea en Contractia.
status	string	”En progreso”, “Concluída”…	Estado actual de la tarea.
participation	objeto	Opcional	Presente solo en PARTICIPATION_STATUS_CHANGED.
participation_id	integer	—	ID único del participante en la tarea.
participant_name	string	—	Nombre del participante.
participant_last_name	string	—	Apellido del participante.
participant_email	string	—	Email del participante.
role	string	”Firmante”	Rol del participante en la tarea.
answer	string	”Firmado”	Acción realizada por el participante.
biometrics.required	boolean	true / false	Si se requirió validación biométrica.
biometrics.completed	boolean	true / false	Si la validación biométrica fue completada.
biometrics.requires_manual_review	boolean	true / false	Si requiere revisión manual en el portal.
otp.required	boolean	true / false	Si se requirió verificación OTP.
otp.type	string	”EMAIL”	Canal utilizado para enviar el OTP.

💻 Estructura

JSON

{
  "event_type": "PARTICIPATION_STATUS_CHANGED",
  "task_id": 123,
  "status": "En progreso",
  "participation": {
    "participation_id": 456,
    "participant_name": "Juan",
    "participant_last_name": "Pérez",
    "participant_email": "[e-mail]",
    "role": "Firmante",
    "answer": "Firmado",
    "biometrics": {
      "required": true,
      "completed": true,
      "requires_manual_review": true
    },
    "otp": {
      "required": true,
      "type": "EMAIL"
    }
  }
}