Integraciones y API
Pestañas
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 con el evento Workflow 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/ |
Un enlace de tiempo limitado al PDF completado, con la página de registro de aprobación cuando hay una. |
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.
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 o un propietario del equipo, por lo que un asistente puede aprobar en tu nombre pero no en el de otra persona.