Saltar al contenido principal

Middlewares iPaaS (Zapier, Make, n8n, Power Automate, Workato)

Las plataformas de integración sin código (iPaaS) conectan FoxPlan con sus otras herramientas (ERP, CRM, tickets, mensajería, hojas de cálculo…) sin desarrollo. FoxPlan incluye cinco conectores de serie, en todas las instancias: aparecen en Configuración → Conectores para sus administradores de espacio de trabajo o de empresa, sin solicitud de apertura previa.

ConectorEditorDesencadenador webhook a usar en la herramienta
ZapierZapierWebhooks by Zapier › Catch Hook
MakeCelonis (Make.com)módulo Webhooks › Custom webhook
n8nn8nnodo Webhook (método POST, URL de producción)
Microsoft Power AutomateMicrosoftdesencadenador Cuando se recibe una solicitud HTTP
WorkatoWorkatodesencadenador Webhooks › New event via webhook

Los cinco conectores funcionan exactamente igual, en ambos sentidos:

SentidoMecanismoDónde configurarlo
FoxPlan → middleware (saliente)FoxPlan envía un evento JSON estructurado a la URL de webhook de su escenarioPestaña Configuración de la ficha, luego pestaña Flujos
Middleware → FoxPlan (entrante)El escenario llama a la API REST de FoxPlan con una cuenta de APIPestaña API de la ficha

Configuración, conector por conector​

El procedimiento es siempre el mismo: crear el desencadenador webhook en la herramienta, pegar su URL en FoxPlan, probar y activar los flujos.

Zapier​

  1. Cree un Zap y elija el desencadenador Webhooks by Zapier › Catch Hook. Zapier muestra una URL del tipo https://hooks.zapier.com/hooks/catch/….
  2. En FoxPlan, abra Configuración → Conectores → Zapier, pegue la URL en URL de webhook Zapier, indique opcionalmente un token compartido y guarde.
  3. Haga clic en Probar: Zapier recibe un evento connection.test y lo propone como ejemplo («Find new records»).
  4. Pestaña Flujos: active Eventos de tareas y/o Comentarios de tareas.
  5. Continúe su Zap con las acciones que desee; para actuar sobre FoxPlan, use Webhooks by Zapier › Custom Request hacia la API REST (véase más abajo).

Make​

  1. En un escenario, añada el módulo Webhooks › Custom webhook, cree un webhook y copie su dirección (https://hook.eu1.make.com/…).
  2. En FoxPlan, abra la ficha Make, pegue la URL, guarde y Probar: Make determina automáticamente la estructura de los datos.
  3. Active los flujos deseados en la pestaña Flujos.
  4. Para escribir en FoxPlan, añada un módulo HTTP › Make a request con la cabecera Authorization: Bearer … (véase la sección API).

n8n​

  1. En un flujo de trabajo, añada un nodo Webhook, método POST, y copie la URL de producción.
  2. En FoxPlan, ficha n8n: pegue la URL, guarde y Probar con el nodo a la escucha («Listen for test event») para capturar un ejemplo.
  3. Active los flujos en la pestaña Flujos.
  4. Para llamar a FoxPlan, use un nodo HTTP Request con una credencial Header Auth (Authorization / Bearer …).

Microsoft Power Automate​

  1. Cree un flujo con el desencadenador Cuando se recibe una solicitud HTTP. La URL solo aparece después de guardar el flujo por primera vez.
  2. Pegue el ejemplo JSON siguiente en «Usar una carga de ejemplo para generar el esquema» para disponer de los campos en los pasos siguientes.
  3. En FoxPlan, ficha Microsoft Power Automate: pegue la URL, guarde, Probar y active los flujos.
  4. Para actuar sobre FoxPlan, añada una acción HTTP con la cabecera Authorization.
Licencia Power Automate

El desencadenador HTTP y la acción HTTP son conectores Premium en Microsoft.

Workato​

  1. En una receta, elija el desencadenador Webhooks › New event via webhook y copie la URL del webhook.
  2. En FoxPlan, ficha Workato: pegue la URL, guarde, Probar y active los flujos.
  3. Para escribir en FoxPlan, use el conector HTTP de Workato con autenticación Header (Authorization: Bearer …).

Sentido saliente: el evento JSON​

El botón Probar envía inmediatamente un evento connection.test. Los flujos Eventos de tareas (task.status-changed, task.owner-changed, task.planning-assignment-changed) y Comentarios de tareas (task.comment-added) envían después, en cada evento, un JSON de la forma:

{
  "schemaVersion": "1",
  "source": "foxplan",
  "event": "task.status-changed",
  "occurredAt": "2026-09-08T16:05:12.345Z",
  "environmentId": "…",
  "actor": { "id": "…", "name": "Jane Doe", "email": "jane@ejemplo.com" },
  "project": { "id": "…", "name": "Proyecto Alfa", "code": "ALP" },
  "task": { "id": "…", "projectId": "…", "name": "…", "status": "…", "owner": "…", "priority": 1, "startDate": "…", "endDate": "…", "percentComplete": 40, "description": "…", "lastModifiedDate": "…" },
  "previous": { "…": "estado de la tarea antes del cambio" },
  "comment": { "author": "…", "text": "…" }
}

Dos cabeceras HTTP acompañan cada llamada: X-Foxplan-Event (tipo de evento) y, si se ha definido un token compartido en la configuración, X-Foxplan-Token. Compruebe ese token en su escenario para aceptar solo las llamadas procedentes de FoxPlan.

Acoplamiento con las notificaciones del proyecto

Como con los conectores de chat, estos flujos solo se activan si las opciones de notificación del proyecto correspondientes están activadas en Definición del proyecto.

Sentido entrante: llamar a la API de FoxPlan desde el escenario​

La pestaña API de cada ficha enumera las operaciones de la API REST recomendadas para un escenario de automatización, agrupadas por dominio (autenticación, proyectos, tareas, comentarios, recursos, carteras): listar o crear tareas, cambiar un estado, comentar, leer un proyecto, crear una asignación… Recuerda la URL base a utilizar y da acceso a la documentación Swagger completa.

Autenticación en tres pasos:

  1. Cree una cuenta de API en Configuración → Espacio de trabajo → pestaña API y asígnele un rol (por ejemplo Gestor del espacio de trabajo).
  2. Llame a POST /api/auth con autenticación Basic (Auth ID:Auth Token codificados en base64): la respuesta contiene un id_token.
  3. Envíe la cabecera Authorization: Bearer <id_token> en cada llamada.

El procedimiento detallado se describe en la guía de uso de la API.

Importar la especificación OpenAPI en la herramienta​

La pestaña API también ofrece el documento OpenAPI (3.x) para descargar: reproduce exactamente el alcance de la lista mostrada, usa la dirección de su instancia como servidor y excluye los servicios internos de FoxPlan. Make (Custom apps › Import OpenAPI), Zapier (Platform UI › Import an OpenAPI spec) y Workato (Connector SDK › Import OpenAPI) lo convierten en un conector personalizado en pocos clics. n8n no importa OpenAPI: el archivo sirve de referencia para los nodos HTTP Request. Power Automate solo acepta hoy la versión 2.0: el archivo se entrega en 3.x, a convertir hasta que lo admitan.

Aislamiento por instancia​

Un middleware solo puede actuar sobre la instancia (el tenant) a la que está vinculado, en ambos sentidos:

  • Saliente: el conector se instala en un espacio de trabajo; solo recibe los eventos de ese espacio, y el contexto de la instancia emisora se conserva hasta el envío del webhook.
  • Entrante: la cuenta de API pertenece a una empresa; el token que obtiene lleva esa empresa y es ella, y solo ella, la que determina los datos accesibles. Una cabecera forjada en el escenario no permite cambiarla, y los derechos de la cuenta (roles en los proyectos) se aplican como para cualquier usuario.