Conectores (Marketplace)
O marketplace de conectores centraliza as integrações entre o FoxPlan e suas ferramentas externas (mensageria, CRM, ERP, ITSM, RH). Cada conector é instalado em um espaço de trabalho, configurado uma única vez, e depois reage automaticamente aos eventos de negócio do FoxPlan (mudança de status, alocação, comentário…).
Configurações → Conectores
A tela Conectores é reservada aos administradores de espaço de trabalho ou de empresa, como o resto do menu Configurações. Tem duas abas: a Loja de conectores (conectores de saída) e API (contas de API, documentação Swagger, registro de chamadas). A loja é uma funcionalidade em fase de implantação: a FoxPlan abre todo o catálogo ou apenas alguns conectores para a sua instância, e você só vê os que lhe foram abertos — enquanto nenhum estiver aberto, a aba o indica. Para solicitar o acesso, contacte o seu interlocutor FoxPlan.
Catálogo
| Conector | Editor | Categorias | Maturidade |
|---|---|---|---|
| Slack | Slack | Comunicação, Notificações | Estável |
| Microsoft Teams | Microsoft | Comunicação, Notificações | Estável |
| Google Chat | Comunicação, Notificações | Estável | |
| Jira Cloud | Atlassian | ITSM, Gerenciamento de projeto | Beta |
| HubSpot | HubSpot, Inc. | CRM, Marketing | Alfa |
| Odoo | Odoo S.A. | ERP, Open Source | Alfa |
| Pennylane | Pennylane | Finanças, Contabilidade | Alfa |
| Sage Business Cloud Accounting | Sage Group plc | Finanças, Contabilidade | Alfa |
| Cegid | Cegid | ERP, Finanças, RH | Alfa |
| HiBob | Hibob | RH, People | Alfa |
| Infor M3 | Infor | ERP, Indústria | Alfa |
| SAP S/4HANA Cloud (Public) | SAP SE | ERP, Finanças | Alfa |
| Zapier | Zapier | Middleware, iPaaS, Automação | Beta — padrão |
| Make | Celonis (Make.com) | Middleware, iPaaS, Automação | Beta — padrão |
| n8n | n8n | Middleware, iPaaS, Automação | Beta — padrão |
| Microsoft Power Automate | Microsoft | Middleware, iPaaS, Automação | Beta — padrão |
| Workato | Workato | Middleware, iPaaS, Automação | Beta — padrão |
- Estável: pronto para produção.
- Beta: funcional, escopo ainda sujeito a evoluir.
- Alfa: conector inicial (teste de conexão + um fluxo). Reservar para avaliação.
Instalar um conector
- Abra Configurações → Conectores.
- Clique no cartão do conector desejado para abrir sua ficha.
- Aba Configuração: preencha os campos exigidos (URL, tokens, credenciais…).
- Clique em Salvar. O conector fica então instalado no espaço de trabalho.
- Use Testar para verificar a conexão antes de ativar os fluxos.
O interruptor no topo da ficha permite ativar / desativar globalmente a instalação sem perder sua configuração.
Campos de configuração
As fichas usam campos tipados: texto, URL, número, booleano, lista, área de texto, senha e segredo. Os campos marcados como segredos (tokens de API, URLs de webhook assinadas…) são criptografados em repouso e nunca são reexibidos em claro — uma máscara (••••) indica que um valor já está registrado.
A autenticação depende do conector: URL de webhook de entrada (chat), token de API, Bearer, Basic ou OAuth conforme a ferramenta alvo.
Fluxos e gatilhos
Um conector expõe um ou vários fluxos. Cada fluxo é ativado de forma independente na aba Fluxos da ficha.
Os conectores de mensagens (Slack, Teams, Google Chat) e os middlewares iPaaS oferecem seis fluxos, que reagem aos seguintes eventos:
| Fluxo | Eventos |
|---|---|
| Notificações de tarefas | mudança de status, de responsável (alocação) ou de alocação de planejamento |
| Notificações de comentários | comentário adicionado a uma tarefa |
| Avanço das tarefas | mudança da porcentagem de avanço de uma tarefa |
| Objetos de projeto | criação, alteração ou exclusão de um risco, uma decisão, um requisito, uma mudança, um arquivo ou uma meteorologia de projeto |
| Tickets de Suporte | criação de um ticket de Suporte e mudança de status |
| Comentários nos objetos | comentário adicionado a um objeto de projeto ou a um ticket de Suporte |
Os dois primeiros fluxos (tarefas e comentários de tarefas) só disparam se as opções de notificação do projeto correspondentes estiverem ativadas (Notificar na mudança de status, Notificar na alocação, Notificar em comentário…), definidas na Definição do projeto. Um conector recém-instalado permanece portanto silencioso nesses dois fluxos enquanto essas opções não forem marcadas nos projetos em questão.
Os outros quatro fluxos (avanço, objetos de projeto, tickets de Suporte, comentários nos objetos) não dependem de nenhuma opção do projeto: basta ativar o fluxo no conector.
Disparo manual
Os fluxos «sob demanda» (por exemplo uma sincronização) podem ser lançados manualmente pelo botão Executar da aba Fluxos. O resultado (sucesso / falha, código HTTP) é retornado imediatamente.
Middlewares iPaaS (Zapier, Make, n8n, Power Automate, Workato)
Cinco conectores para plataformas de automação sem código são fornecidos de série em todas as instâncias: aparecem em Definições → Conectores para os seus administradores, sem pedido de abertura. Funcionam nos dois sentidos — eventos JSON de saída por webhook, ações de entrada através da API REST (separador API da ficha) — e só podem agir sobre a instância à qual estão ligados.
A configuração ferramenta a ferramenta, o formato do evento enviado e o catálogo de API estão descritos na página dedicada: Middlewares iPaaS.
Acompanhamento e registros
A aba Registros de cada conector lista as últimas execuções: data, fluxo, tipo de evento, status, código HTTP, duração e mensagem.
- O envio para as ferramentas externas é assíncrono: ele nunca impacta o salvamento da tarefa no FoxPlan. Em caso de falha de um conector, a ação FoxPlan é concluída normalmente e o erro é registrado.
- Os registros são expurgados automaticamente após um período de retenção (60 dias por padrão), gerenciado por um índice TTL do MongoDB.
As URLs de webhook Slack / Teams / Google Chat informadas diretamente na ficha do projeto continuam funcionando como antes, em paralelo aos conectores. Os conectores do marketplace não as substituem: eles oferecem uma configuração centralizada na escala do espaço de trabalho.
Segurança
- Todos os segredos de conectores são criptografados (AES-GCM) com uma chave dedicada (
CONNECTOR_SECRETS_ENCRYPTION_KEY). - Os dados de conectores (instalações, configuração de fluxos, registros) são isolados por espaço de trabalho (tenant).
- O acesso à tela é restrito às contas FoxPlan, e as chamadas de API correspondentes são protegidas no lado do servidor.