Introducción - Contractia API

Los webhooks (también llamados callbacks web) son un mecanismo que permite que Contractia notifique a tu sistema en tiempo real cada vez que ocurre un evento relevante dentro de una tarea de firma. En lugar de realizar consultas periódicas a la API (polling), tu servidor recibe una solicitud HTTP POST automáticamente cuando el evento sucede.

Esto permite:

Reaccionar de forma inmediata a cambios de estado en tareas o participantes.
Reducir la carga sobre los servidores de ambas partes.
Evitar la pérdida de eventos en flujos de trabajo críticos.

📖 Conceptos clave

TérminoTérmino	Definición
Tarea	Proceso de firma creado en Contractia. Cada tarea puede tener su propio webhook.
Evento	Acción que dispara la notificación (ej.: cambio de estado de tarea o de participante).
Payload	Cuerpo JSON enviado en la solicitud HTTP POST a tu URL cuando ocurre el evento.
Participante	Firmante u otro rol dentro de una tarea.
Tarea	Proceso de firma creado en Contractia. Cada tarea puede tener su propio webhook.
Evento	Acción que dispara la notificación (ej.: cambio de estado de tarea o de participante).
Payload	Cuerpo JSON enviado en la solicitud HTTP POST a tu URL cuando ocurre el evento.
Participante	Firmante u otro rol dentro de una tarea.

📊 Posibles estados de un webhook

Estado / Evento	Descripción del estado
Concluída	Tarea concluida exitosamente.
Rechazada	Tarea rechazada por algún participante.
Borrador	Tarea creada, pero no iniciada.
Eliminada	Tarea eliminada por el remitente.
Cancelada	Tarea cancelada por el remitente.
Vencida	Tarea vencida, que tenía configurada fecha de caducidad.
Carga de datos	Tarea en espero de carga de información de un formulario.
Fallida	Tarea la cual fallo por mal carga en un formulario.