Como conectar a Aegro aos KPIs do projeto

Serve pra os KPIs do projeto se atualizarem sozinhos com os dados da fazenda: caixa, contas vencidas, colheita, custo por área e produtividade.

Conferido em 06/11/2026

1
Em Configurações Gerais, seção Funcionalidades beta, ligue Sistemas conectados (beta). Só o dono ou um administrador do workspace vê essa opção.
2
Peça ao Proprietário ou Gerente da fazenda que gere uma chave de integração no Aegro, em somente consulta, com permissão de leitura de movimentações bancárias, safras, registros de colheita e custos. Cada chave vale pra uma fazenda.
3
Combine como a chave vai chegar até você. Não peça por WhatsApp nem por e-mail: o melhor é o próprio cliente colar, com você numa reunião.
4
Abra o projeto do cliente, aba KPIs, e clique em Sistemas conectados. O projeto precisa ter uma empresa ou um cliente vinculado. Se a aba não aparecer, ligue KPIs em Configurações do projeto, seção Abas.
5
Em Aegro, clique em Conectar, cole a chave e, se quiser o aviso antes de vencer, informe a validade. O sistema confere a chave e mostra o nome da fazenda.
6
Na prévia, escolha a safra e confira os números com a tela do Aegro. A integração está em Beta, então essa conferência é o que garante que o número está certo.
7
Clique em Ligar em cada métrica que quiser, criando um KPI novo ou usando um que já existe. O histórico de até 12 meses chega em instantes, e a atualização passa a ser diária.

Erros comuns

A chave foi recusada: ela venceu, foi revogada ou foi copiada pela metade. A Aegro só mostra a chave na criação, então gere outra e cole em Trocar chave.
Falta permissão na chave: a métrica diz qual leitura faltou. Crie uma cópia da chave no Aegro com essa permissão e troque aqui.
Corrigi um mês e o número não voltou: correção manual vale no lugar do automático. No histórico do KPI, use Voltar ao automático.
Custo por área e produtividade têm só o valor de hoje: são acumulados da safra, por isso não trazem histórico mês a mês.
O cliente não vê os KPIs no portal: no link do portal, em Permissões → Abas visíveis, ligue KPIs. A opção só aparece com a aba ligada no projeto.
Desconectei e os números continuam: as medições já gravadas ficam. Lembre de revogar a chave no Aegro, ao encerrar o trabalho com o cliente.