> ## Documentation Index
> Fetch the complete documentation index at: https://api.contractia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Cómo recibir notificaciones en tiempo real desde la plataforma Contractia.

> 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.       |