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 aba Conectores só é visível para os colaboradores FoxPlan (conta cujo e-mail ou login termina em @fox-plan.com). Trata-se de uma funcionalidade em fase de implantação, conduzida pelas equipes FoxPlan em nome dos clientes.
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 |
- 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 fluxos de notificação reagem aos seguintes eventos de tarefa:
- Mudança de status de uma tarefa
- Mudança de responsável (alocação)
- Mudança de alocação de planejamento
- Adição de um comentário
Os fluxos 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 enquanto essas opções não forem marcadas nos projetos em questão.
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.
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.