Integraciones y API
En esta página
Todo lo que muestra el rastreador también está disponible para otros sistemas. Los webhooks se activan a medida que avanzan las ejecuciones, la API REST lee ejecuciones y actúa sobre tareas, y el servidor MCP expone lo mismo a los asistentes de IA.
Webhooks
Agrega un webhook y configura Enviar cuando a Un flujo de trabajo o tarea cambia en API y webhooks. Recibe cada flujo de trabajo del equipo, o solo los flujos de trabajo que usan un formulario dado cuando eliges uno. Cada llamada lleva el nombre del evento, la ejecución y, donde haya uno, la tarea y su id de envío:
| Evento | Cuándo |
|---|---|
workflow.run.started |
Se envió el formulario de inicio. |
workflow.run.restarted |
Una ejecución rechazada se inició nuevamente desde el botón Comenzar de nuevo. |
workflow.task.created |
Se asignó un paso a alguien. |
workflow.task.completed |
Se envió un paso del formulario. |
workflow.task.decided |
Se decidió una aprobación; la carga útil tiene el resultado y el comentario. |
workflow.run.completed |
Cada ruta terminó. |
workflow.run.rejected |
Un envío de vuelta terminó la ejecución. |
workflow.run.cancelled |
Alguien canceló la ejecución en el rastreador o a través de la API. |
Los webhooks a nivel de formulario en los formularios individuales siguen activándose para sus envíos como antes.
API REST
La API v4 tiene acceso de lectura y escritura a ejecuciones y tareas. Todas las rutas están bajo /api/v4/:
| Método y ruta | Qué hace |
|---|---|
GET workflow/<workflow>/definition/ |
Los pasos y conexiones de un flujo de trabajo, solo lectura. |
GET workflow/<workflow>/runs/ |
Las ejecuciones del flujo de trabajo, filtrables por estado, asignado y vencido, paginadas. |
GET workflow/run/<run>/ |
Una ejecución con sus tareas y su cronología. |
GET workflow/run/<run>/final-pdf/ |
El archivo PDF completado en sí: la copia con la página de registro de aprobación cuando hay una, de lo contrario, el propio PDF del último formulario. |
POST workflow/run/<run>/cancel/ |
Cancelar una ejecución, con una razón opcional. |
GET workflow/tasks/ |
Tareas a través de flujos de trabajo, filtrables por correo electrónico del asignado y estado, para clientes estilo bandeja de entrada. |
POST workflow/task/<task>/decide/ |
Decidir una tarea de aprobación: el resultado y un comentario. |
POST workflow/task/<task>/nudge/ |
Reenviar el correo electrónico de la tarea. |
POST workflow/task/<task>/reassign/ |
Asignar la tarea a una dirección de correo electrónico o a un miembro del equipo. |
Las rutas anteriores para enviar un paso de flujo de trabajo y listar los envíos de un flujo de trabajo por paso no han cambiado.
Quién puede leer y actuar
Las rutas REST y las herramientas MCP siguen las mismas reglas de acceso que el rastreador:
- Las ejecuciones, tareas, IDs de envío, árboles y detalles de ejecución de un flujo de trabajo se enumeran o leen solo para una cuenta que sea Visualizador de Envíos de Formularios en cada formulario del flujo de trabajo. Cualquier otra cuenta recibe una respuesta 403 que lo indica: “You need Form Submission Viewer permission on every form in this workflow.” Un flujo de trabajo o una ejecución que no existe se sigue indicando como inexistente.
- La definición también se abre para quien pueda diseñar el flujo de trabajo (Editor de Formularios en cada formulario).
GET workflows/enumera solo los flujos de trabajo que la cuenta puede diseñar o ver. - Empujar, reasignar y cancelar necesitan el mismo acceso que los botones del rastreador; reasignar una aprobación también requiere Editor de Formularios en cada formulario.
- Decidir una aprobación requiere que la cuenta sea el asignado de la aprobación.
- El enlace de una tarea abierta se incluye solo para el propio asignado de la tarea y, en tareas de formulario, para aquellos que puedan actuar en la ejecución. La respuesta a un empujón no lleva enlace.
Herramientas MCP
El servidor MCP de PlatoForms ofrece a los asistentes de IA la misma vista: list_workflow_runs (por flujo de trabajo, estado o vencido), get_workflow_run, list_my_workflow_tasks, decide_workflow_task y nudge_workflow_task. Decidir una tarea requiere que el usuario conectado sea uno de sus asignados, por lo que un asistente puede aprobar en tu nombre pero no en el de otra persona.