Pular para o conteúdo principal

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

As plataformas de integração sem código (iPaaS) ligam o FoxPlan às suas outras ferramentas (ERP, CRM, tickets, mensagens, folhas de cálculo…) sem desenvolvimento. O FoxPlan fornece cinco conectores de série, em todas as instâncias: aparecem em Definições → Conectores para os seus administradores de espaço de trabalho ou de empresa, sem pedido de abertura prévio.

ConectorEditorGatilho webhook a usar na ferramenta
ZapierZapierWebhooks by Zapier › Catch Hook
MakeCelonis (Make.com)módulo Webhooks › Custom webhook
n8nn8nnó Webhook (método POST, URL de produção)
Microsoft Power AutomateMicrosoftgatilho Quando um pedido HTTP é recebido
WorkatoWorkatogatilho Webhooks › New event via webhook

Os cinco conectores funcionam exatamente da mesma forma, nos dois sentidos:

SentidoMecanismoOnde configurar
FoxPlan → middleware (saída)O FoxPlan envia um evento JSON estruturado para o URL de webhook do seu cenárioSeparador Configuração da ficha, depois separador Fluxos
Middleware → FoxPlan (entrada)O cenário chama a API REST do FoxPlan com uma conta de APISeparador API da ficha

Configuração, conector a conector​

O procedimento é sempre o mesmo: criar o gatilho webhook na ferramenta, colar o seu URL no FoxPlan, testar e ativar os fluxos.

Zapier​

  1. Crie um Zap e escolha o gatilho Webhooks by Zapier › Catch Hook. O Zapier mostra um URL do tipo https://hooks.zapier.com/hooks/catch/….
  2. No FoxPlan, abra Definições → Conectores → Zapier, cole o URL em URL de webhook Zapier, indique opcionalmente um token partilhado e guarde.
  3. Clique em Testar: o Zapier recebe um evento connection.test e propõe-o como exemplo («Find new records»).
  4. Separador Fluxos: ative Eventos de tarefas e/ou Comentários de tarefas.
  5. Continue o seu Zap com as ações que desejar; para agir no FoxPlan, use Webhooks by Zapier › Custom Request para a API REST (ver abaixo).

Make​

  1. Num cenário, adicione o módulo Webhooks › Custom webhook, crie um webhook e copie o seu endereço (https://hook.eu1.make.com/…).
  2. No FoxPlan, abra a ficha Make, cole o URL, guarde e Testar: o Make determina automaticamente a estrutura dos dados.
  3. Ative os fluxos pretendidos no separador Fluxos.
  4. Para escrever no FoxPlan, adicione um módulo HTTP › Make a request com o cabeçalho Authorization: Bearer … (ver a secção API).

n8n​

  1. Num workflow, adicione um nó Webhook, método POST, e copie o URL de produção.
  2. No FoxPlan, ficha n8n: cole o URL, guarde e Testar com o nó à escuta («Listen for test event») para capturar um exemplo.
  3. Ative os fluxos no separador Fluxos.
  4. Para chamar o FoxPlan, use um nó HTTP Request com uma credencial Header Auth (Authorization / Bearer …).

Microsoft Power Automate​

  1. Crie um fluxo com o gatilho Quando um pedido HTTP é recebido. O URL só aparece depois de guardar o fluxo pela primeira vez.
  2. Cole o exemplo JSON abaixo em «Utilizar payload de exemplo para gerar o esquema» para dispor dos campos nos passos seguintes.
  3. No FoxPlan, ficha Microsoft Power Automate: cole o URL, guarde, Testar e ative os fluxos.
  4. Para agir no FoxPlan, adicione uma ação HTTP com o cabeçalho Authorization.
Licença Power Automate

O gatilho HTTP e a ação HTTP são conectores Premium na Microsoft.

Workato​

  1. Numa receita, escolha o gatilho Webhooks › New event via webhook e copie o URL do webhook.
  2. No FoxPlan, ficha Workato: cole o URL, guarde, Testar e ative os fluxos.
  3. Para escrever no FoxPlan, use o conector HTTP do Workato com autenticação Header (Authorization: Bearer …).

Sentido de saída: o evento JSON​

O botão Testar envia imediatamente um evento connection.test. Os fluxos Eventos de tarefas (task.status-changed, task.owner-changed, task.planning-assignment-changed) e Comentários de tarefas (task.comment-added) enviam depois, a cada evento, um JSON da forma:

{
  "schemaVersion": "1",
  "source": "foxplan",
  "event": "task.status-changed",
  "occurredAt": "2026-09-08T16:05:12.345Z",
  "environmentId": "…",
  "actor": { "id": "…", "name": "Jane Doe", "email": "jane@exemplo.com" },
  "project": { "id": "…", "name": "Projeto Alfa", "code": "ALP" },
  "task": { "id": "…", "projectId": "…", "name": "…", "status": "…", "owner": "…", "priority": 1, "startDate": "…", "endDate": "…", "percentComplete": 40, "description": "…", "lastModifiedDate": "…" },
  "previous": { "…": "estado da tarefa antes da alteração" },
  "comment": { "author": "…", "text": "…" }
}

Dois cabeçalhos HTTP acompanham cada chamada: X-Foxplan-Event (tipo de evento) e, se um token partilhado estiver definido na configuração, X-Foxplan-Token. Verifique esse token no seu cenário para aceitar apenas as chamadas provenientes do FoxPlan.

Acoplamento com as notificações do projeto

Tal como para os conectores de chat, estes fluxos só disparam se as opções de notificação do projeto correspondentes estiverem ativadas em Definição do projeto.

Sentido de entrada: chamar a API do FoxPlan a partir do cenário​

O separador API de cada ficha lista as operações da API REST recomendadas para um cenário de automação, agrupadas por domínio (autenticação, projetos, tarefas, comentários, recursos, carteiras): listar ou criar tarefas, alterar um estado, comentar, ler um projeto, criar uma afetação… Recorda o URL base a utilizar e dá acesso à documentação Swagger completa.

Autenticação em três passos:

  1. Crie uma conta de API em Definições → Espaço de trabalho → separador API e atribua-lhe um papel (por exemplo Gestor do espaço de trabalho).
  2. Chame POST /api/auth com autenticação Basic (Auth ID:Auth Token codificados em base64): a resposta contém um id_token.
  3. Envie o cabeçalho Authorization: Bearer <id_token> em cada chamada.

O procedimento detalhado está descrito no guia de utilização da API.

Importar a especificação OpenAPI na ferramenta​

O separador API também disponibiliza o documento OpenAPI (3.x) para transferência: reproduz exatamente o âmbito da lista apresentada, usa o endereço da sua instância como servidor e exclui os serviços internos do FoxPlan. Make (Custom apps › Import OpenAPI), Zapier (Platform UI › Import an OpenAPI spec) e Workato (Connector SDK › Import OpenAPI) transformam-no num conector personalizado em poucos cliques. O n8n não importa OpenAPI: o ficheiro serve de referência para os nós HTTP Request. O Power Automate aceita hoje apenas a versão 2.0: o ficheiro é fornecido em 3.x, a converter até ser suportado.

Isolamento por instância​

Um middleware só pode agir sobre a instância (o tenant) à qual está ligado, nos dois sentidos:

  • Saída: o conector é instalado num espaço de trabalho; recebe apenas os eventos desse espaço, e o contexto da instância emissora é conservado até ao envio do webhook.
  • Entrada: a conta de API pertence a uma empresa; o token que obtém transporta essa empresa e é ela, e só ela, que determina os dados acessíveis. Um cabeçalho forjado no cenário não permite mudá-la, e os direitos da conta (papéis nos projetos) aplicam-se como para qualquer utilizador.