Trello
Esta integração está ativa e pronta para uso no Frihet.
Conecte seus quadros do Trello ao Frihet. Consulte quadros, listas e cartões diretamente do seu ERP para ter contexto de projeto ao faturar.
Para que serve?
Com o Trello integrado:
- Ver quadros — Consulte todos os seus quadros do Trello a partir do Frihet
- Ver listas e cartões — Navegue a estrutura dos seus projetos
- Contexto ao faturar — Consulte tarefas concluídas antes de criar uma fatura
- Visibilidade centralizada — Sem alternar entre aplicativos
Requisitos
- Conta Trello ativa — trello.com
- API Key do Trello — É obtida a partir do portal de desenvolvedores
- Token de autorização — É gerado ao autorizar seu aplicativo
- Frihet Pro ou superior
Conectar Trello ao Frihet
Passo 1: Obter sua API Key
- Vá para trello.com/power-ups/admin
- Faça login em sua conta do Trello
- Clique em New para criar um novo Power-Up ou integração
- Preencha os campos:
- Name: "Frihet ERP"
- Workspace: Selecione seu workspace
- Uma vez criado, vá para a aba API Key
- Copie sua API Key
Passo 2: Gerar um Token
- Na mesma página, ao lado da API Key, clique no link Token
- Uma página de autorização do Trello será aberta
- Revise as permissões solicitadas e clique em Allow
- Copie o Token gerado
Você precisa de ambas: a API Key e o Token. Copie-os antes de continuar.
Passo 3: Configurar no Frihet
- Vá para Ajustes → Integrações
- Procure por Trello
- Clique em Conectar
- Insira sua API Key
- Insira seu Token
- Clique em Verificar conexão
- Se estiver correto, você verá seus quadros listados
Como funciona
Frihet usa a API REST do Trello com autenticação por query params:
- Você fornece a API Key e o Token
- Frihet adiciona ambos como parâmetros de query em cada requisição:
?key=<api-key>&token=<token> - Os quadros, listas e cartões são consultados sob demanda
- Ambas credenciais são armazenadas criptografadas (AES-256-GCM) no Frihet
Dados sincronizados
| Dado | Direção | Frequência |
|---|---|---|
| Quadros | Trello → Frihet | Sob demanda |
| Listas | Trello → Frihet | Sob demanda |
| Cartões | Trello → Frihet | Sob demanda |
| Membros | Trello → Frihet | Com cada consulta |
Casos de uso
Freelancer que gerencia projetos no Trello
Você tem um quadro por cliente com colunas como "A fazer", "Em andamento" e "Concluído". Antes de faturar, consulte os cartões concluídos a partir do Frihet para verificar qual trabalho incluir.
Agência com quadros de cliente
Sua equipe trabalha com quadros compartilhados por cliente. A partir do Frihet, você pode ver o status de cada quadro para saber quando um projeto está pronto para faturar.
Verificar entregáveis antes de faturar
Antes de emitir uma fatura de um projeto, consulte a partir do Frihet os cartões do quadro correspondente no Trello. Confirme que todos os entregáveis estão concluídos.
Funcionalidades
Ver quadros
- A partir do Frihet, acesse a seção do Trello
- Você verá todos os quadros aos quais sua conta tem acesso
- Selecione um quadro para ver suas listas e cartões
Ver listas e cartões
- Selecione um quadro
- Frihet mostra as listas (colunas) com seus cartões
- Cada cartão mostra título, membros atribuídos e etiquetas
Navegar cartões
- Clique em um cartão para ver mais detalhes
- Veja a descrição, checklist, comentários e anexos
- Use esta informação como referência ao criar faturas
Limites de API
Frihet implementa throttling automático (100ms entre requisições) para respeitar os limites da API do Trello. As consultas a quadros grandes podem levar alguns segundos adicionais.
Solução de problemas
"Erro de autenticação"
- Verifique se a API Key e o Token estão corretos
- O Token deve corresponder à mesma conta que a API Key
- Se você revogou o Token, gere um novo e atualize-o no Frihet
"Não vejo todos os meus quadros"
- Verifique se sua conta tem acesso a esses quadros no Trello
- Os quadros privados de outros membros não serão visíveis
- Se você for convidado para um quadro, o acesso depende das permissões do quadro
"O Token expirou"
- Os tokens do Trello não expiram por padrão, a menos que você os configure para isso
- Se o token foi revogado manualmente, gere um novo
- Vá para trello.com/power-ups/admin para gerenciar tokens
"Quero desconectar"
- Vá para Ajustes → Integrações → Trello
- Clique em Desconectar
- Opcionalmente, revogue o Token a partir do Trello em Settings → Applications