Webhooks
Un webhook permite que FlexiProject avise a un sistema externo en el mismo momento en que ocurre algo en la organización. El sistema receptor recibe una petición HTTP con los datos del evento justo después de que este se produzca, por lo que no tiene que consultar la API una y otra vez para ver si algo ha cambiado.
Un webhook vincula un evento con una dirección de receptor. Para enviar dos eventos distintos a la misma dirección, o el mismo evento a dos sistemas, crea dos webhooks.
Los webhooks se configuran en el menú Configuración del sistema, en la pestaña Webhooks. La pestaña está disponible para los administradores del sistema (consulta Usuarios y permisos). Para leer datos por otro canal, usa la API.
Eventos
FlexiProject informa de cuatro eventos. Cada webhook se refiere exactamente a uno de ellos, que se elige en la lista Evento.

| Evento | Cuándo envía FlexiProject la petición | Datos específicos del evento |
|---|---|---|
| Proyecto creado | Ha surgido un nuevo proyecto, de cualquier forma: desde cero, a partir de una plantilla, por clonación, importando un archivo de MS Project o Excel, o con ayuda de la IA. | ProjectId, ProjectName, CreatedAt |
| Proyecto eliminado | Se ha eliminado un proyecto. | ProjectId, ProjectName |
| Aceptación iniciada | Se ha enviado un cambio de plan a aprobación y se ha iniciado su ruta de aprobación. | ChangeRequestId, ChangeRequestName, ProjectId, ProjectName, Date |
| Aceptación completada | La ruta de aprobación ha terminado con un resultado: aprobación, rechazo, devolución para mejorar o cancelación. En un proyecto archivado, la petición no se envía. | ChangeRequestId, ChangeRequestName, ProjectId, ProjectName, DecisionDate, Status |
El campo Status toma el valor Approved (aprobación), Rejected (rechazo), NeedsRevision (devolución para mejorar) o Pending (cancelación).
Toda petición contiene además:
- el nombre del evento (
Event) - el momento en que se generó (
Timestamp) - el identificador (
UserId) y la dirección de correo electrónico (UserEmail) del usuario cuya acción la desencadenó
El formato de la petición completa se describe en Formato de la petición HTTP. Las aprobaciones se describen en Aceptaciones.
Configuración del webhook
Lista de webhooks
La pestaña Webhooks muestra todos los webhooks de la organización en tres columnas: Evento, URL del receptor y Descripción. Cuando no hay nada definido, se muestra el mensaje No hay webhooks.

Añadir un webhook
- En el menú principal, elige Configuración del sistema, ve a la pestaña Webhooks y haz clic en Añadir. Se abre la ventana Añadir webhook.
- Elige el Evento. De forma predeterminada está seleccionado Proyecto creado.
- Escribe la URL del receptor, es decir, la dirección a la que FlexiProject envía la petición. El campo es obligatorio y necesita la dirección completa, incluido el protocolo, por ejemplo
https://example.com/hooks/flexiproject. - Si quieres, escribe una Descripción, es decir, una nota para tu equipo, visible solo en los ajustes.
- Haz clic en Guardar. El webhook aparece en la lista y justo después se abre la ventana Secreto.
Secreto
La ventana Secreto contiene el mensaje: El webhook ha sido creado. A continuación se muestra el secreto, que se mostrará solo una vez. Cópielo y guárdelo en un lugar seguro.
Haz clic en Copiar. El valor pasa al portapapeles (el sistema muestra el mensaje: Copiado en el portapapeles) y desde allí lo guardas en el sistema receptor.
El secreto firma cada petición, de modo que el receptor puede comprobar que la petición viene de FlexiProject (consulta Formato de la petición HTTP).
Importante: después de cerrar la ventana, el valor completo ya no está disponible en ningún lugar de la aplicación.
En un webhook abierto más tarde, el campo Secreto muestra solo los cuatro primeros y los cuatro últimos caracteres, con asteriscos en medio. El campo no se puede editar.
Editar un webhook
Para cambiar un webhook, haz clic en el nombre del evento en la lista. En la ventana Editar webhook puedes cambiar el evento, la dirección del receptor y la descripción, y después hacer clic en Guardar.
Editar no cambia el secreto ni genera uno nuevo.
Probar un webhook
Para comprobar un webhook, haz clic en Probar en la ventana de edición de un webhook guardado. Se envía a la dirección configurada una petición con el formato del evento elegido, rellenada con datos de ejemplo (por ejemplo, un proyecto llamado Test Project). El sistema lo confirma con el mensaje: Solicitud de prueba enviada correctamente
Importante: el mensaje confirma que la petición se envió, no que el receptor la aceptara. Comprueba el resultado en el lado del receptor.
Eliminar un webhook
Para eliminar un webhook, haz clic en Borrar en la ventana del webhook y confirma. A partir de ese momento el evento ya no se envía a esa dirección.
Atención: la eliminación no se puede deshacer. Para reanudar la entrega hay que crear un webhook nuevo, que tiene un secreto nuevo.
Formato de la petición HTTP
FlexiProject envía a la dirección configurada una petición POST con un cuerpo JSON.
Cabeceras
| Cabecera | Contenido |
|---|---|
X-FlexiProject-Event |
El nombre del evento: ProjectCreated, ProjectDeleted, AcceptanceStarted o AcceptanceCompleted. |
X-FlexiProject-Delivery |
El identificador de la entrega. Se mantiene igual en todos los reintentos del mismo evento, así que puedes reconocer los duplicados por él. |
X-FlexiProject-Timestamp |
El momento en que se envió la petición. |
X-FlexiProject-Signature |
La firma del cuerpo de la petición con la forma sha256=<value>. |
Verificar la firma
La firma es un HMAC-SHA256 del cuerpo de la petición sin modificar, calculado con el secreto del webhook como clave y escrito en hexadecimal en minúsculas.
El receptor calcula el mismo valor a partir del cuerpo recibido y lo compara con la parte de la cabecera X-FlexiProject-Signature posterior a sha256=. Si los valores difieren, hay que rechazar la petición, porque no procede de esta organización en FlexiProject.
Cuerpo de ejemplo
{
"ProjectId": "6712f0a1c3d4e5f601234567",
"ProjectName": "Warehouse modernization",
"CreatedAt": "2026-09-21T08:14:02Z",
"UserId": "a3f1c7de-1b20-4f9e-9a55-0c2d8e7b41aa",
"UserEmail": "anna.kowalska@example.com",
"Event": "ProjectCreated",
"Timestamp": "2026-09-21T08:14:02Z"
}
Respuesta y reintentos
El receptor responde con un estado de éxito (2xx) en cuanto acepta la petición. Cualquier otra respuesta, o ninguna, cuenta como una entrega fallida.
Una entrega fallida se reintenta automáticamente con un intervalo creciente: tras 1, 2, 4, 8, 16, 32, 64, 128, 256 y 512 minutos. Todos los intentos duran en total unas diecisiete horas, de modo que un receptor que no esté disponible durante un rato no pierde el evento.
Importante: cada intento repite el mismo valor de X-FlexiProject-Delivery, por lo que el receptor debe estar preparado para recibir el mismo evento más de una vez.