Conectar Power Automate y Power Apps

Gantlog tiene un conector personalizado para Power Automate y Power Apps: tus flujos y apps crean tareas, registran horas y reaccionan a lo que pasa en Gantlog sin programar contra la API. Está incluido desde el plan Empresa.

El conector se descarga desde Gantlog ya armado con la dirección de tu región. Lo importa una persona que crea flujos (maker) en el entorno de Power Platform de tu empresa. Los textos del conector están en inglés.

1. Descarga el conector y crea la clave

En Gantlog, como administrador, abre Integraciones → Power Automate y Power Apps → Descargar el conector. El .zip trae apiDefinition.swagger.json, apiProperties.json, el icono y una guía corta.
En Integraciones → Nueva clave de API, crea una clave con solo los alcances que usarán tus flujos: projects:read, projects:write, time:write, users:read y, para los disparadores, webhooks:manage. Si los flujos son de algunos proyectos, elígelos. Copia la clave (glk_…).

2. Importa el conector

En make.powerautomate.com abre Datos → Conectores personalizados → Nuevo conector personalizado → Importar un archivo OpenAPI.
Nombre Gantlog y el archivo apiDefinition.swagger.json. En General sube icon.png; el host ya es el de tu región.
En Seguridad queda Clave de API en la cabecera Authorization. Pulsa Crear conector.

3. Crea la conexión y prueba

En Prueba → Nueva conexión, pega la clave. Vale sola (glk_…) o con Bearer delante.
Prueba List projects: responde 200 con tus proyectos. Es también la prueba de conexión del conector.
Crea un flujo con Gantlog → When a task is created, guárdalo y crea una tarea en Gantlog: el flujo corre en segundos. La suscripción que creó el flujo aparece en Integraciones → Webhooks.

Acciones

Acción	Operación	Alcance
Create a task	`taskCreate`	`projects:write`
Update a task	`taskUpdate`	`projects:write`
Log time	`workLogCreate`	`time:write`
Report progress	`progressCreate`	`time:write`
Get a project / List projects	`projectGet, projectList`	`projects:read`
List tasks of a project	`taskPlan`	`projects:read`
List people	`userList`	`users:read`

Los desplegables de proyecto y persona se llenan solos con List projects y List people. Power Apps usa las mismas acciones; para leer muchos datos (informes), usa Power BI con OData.

Disparadores

Disparador	Ruta	Evento
When a task is created	`POST /api/v1/webhooks/triggers/task-created`	`task.created`
When a task changes status	`POST /api/v1/webhooks/triggers/task-status-changed`	`task.status_changed`
When time is logged	`POST /api/v1/webhooks/triggers/work-log-created`	`work_log.created`
When time is approved	`POST /api/v1/webhooks/triggers/time-approved`	`time.approved`
When a delay alert is raised	`POST /api/v1/webhooks/triggers/alert-raised`	`alert.raised`

Al guardar o encender el flujo, Power Automate llama a la ruta del disparador con la URL de vuelta del flujo. Gantlog crea una suscripción de webhooks con ese único evento y responde 201 con la Location absoluta, sin el secreto. Al apagar o borrar el flujo, Power Automate llama a DELETE sobre esa Location. El cuerpo de cada evento es el de los webhooks (id, type, occurredAt, tenantId, data), y el conector describe sus campos para que los elijas en el flujo.

Límites y licencias

Licencias: los conectores personalizados son premium. Cada persona que usa el flujo o la app necesita Power Automate Premium o Power Apps Premium; Microsoft 365 no los incluye.
Suscripciones: hasta 100 por empresa en el plan Empresa y 500 en Corporativo (cada disparador de un flujo encendido es una). Al pasarse, 409.
Las acciones cuentan en los límites de uso de la API, por minuto por clave y por mes por empresa.
Si una suscripción falla durante 3 días (por ejemplo, porque se borró la conexión sin apagar el flujo), se pausa y se avisa en Integraciones.