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.

Add webhook window with the Event list expanded and the available events highlighted

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.

Add webhook window with the Event and Receiver URL fields highlighted

Añadir un webhook

  1. 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.
  2. Elige el Evento. De forma predeterminada está seleccionado Proyecto creado.
  3. 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.
  4. Si quieres, escribe una Descripción, es decir, una nota para tu equipo, visible solo en los ajustes.
  5. 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.