Pular para o conteúdo principal

Asana

Disponível

Esta integração está ativa e pronta para uso no Frihet.

Conecte seu workspace do Asana ao Frihet. Consulte projetos e tarefas diretamente do seu ERP para ter visibilidade do trabalho realizado no momento de faturar.

Para que serve?​

Com Asana integrado:

  • Visualizar projetos — Consulte todos os seus projetos do Asana a partir do Frihet
  • Visualizar tarefas — Navegue pelas tarefas de cada projeto com seu status
  • Contexto ao faturar — Revise tarefas concluídas antes de criar faturas
  • Detecção automática de workspace — O Frihet detecta seu workspace principal automaticamente

Requisitos​

  • Conta Asana ativa — asana.com
  • Personal Access Token — É gerado a partir das configurações do Asana
  • Frihet Pro ou superior

Conectar Asana com Frihet​

Passo 1: Obter seu Personal Access Token​

  1. Vá para app.asana.com/0/developer-console
  2. Faça login com sua conta do Asana
  3. Na seção Personal access tokens, clique em Create new token
  4. Dê um nome a ele (ex: "Frihet ERP")
  5. Aceite os termos da API
  6. Copie o token gerado
Guarde o token

O Personal Access Token é exibido apenas uma vez. Copie-o antes de fechar a janela.

Passo 2: Configurar no Frihet​

  1. Vá para Configurações → Integrações
  2. Procure por Asana
  3. Clique em Conectar
  4. Cole seu Personal Access Token
  5. Clique em Verificar conexão
  6. O Frihet detectará automaticamente seu primeiro workspace

Passo 3: Verificar conexão​

Se a conexão estiver correta, o Frihet exibirá:

  • Nome do seu workspace no Asana
  • Número de projetos acessíveis
  • Seu nome de usuário no Asana

Como funciona​

O Frihet usa a API REST v1 do Asana com autenticação Bearer:

  1. Você fornece seu Personal Access Token
  2. O Frihet envia o token no cabeçalho Authorization: Bearer <token>
  3. Ao conectar, o Frihet consulta seus workspaces e seleciona o primeiro automaticamente
  4. Os projetos e tarefas são consultados sob demanda
  5. O token é armazenado criptografado (AES-256-GCM) no Frihet

Dados sincronizados​

DadoDireçãoFrequência
ProjetosAsana → FrihetSob demanda
TarefasAsana → FrihetSob demanda
Status das tarefasAsana → FrihetA cada consulta
AtribuídosAsana → FrihetA cada consulta

Casos de uso​

Consultor que fatura por projeto​

Você gerencia os entregáveis de cada cliente no Asana. Antes de faturar, você consulta, a partir do Frihet, as tarefas concluídas do projeto para incluir o detalhamento correto na fatura.

Agência criativa com sprints​

Sua equipe trabalha em sprints organizados em projetos do Asana. Ao final de cada sprint, você consulta as tarefas concluídas a partir do Frihet e gera as faturas correspondentes.

Verificar escopo antes de faturar​

Você tem um projeto com escopo definido no Asana. Antes de emitir a fatura final, você verifica, a partir do Frihet, que todas as tarefas do escopo estão marcadas como concluídas.

Funcionalidades​

Visualizar projetos​

  1. No Frihet, acesse a seção do Asana
  2. Você verá todos os projetos do seu workspace
  3. Cada projeto exibe nome, status e número de tarefas

Visualizar tarefas de um projeto​

  1. Selecione um projeto
  2. O Frihet exibe as tarefas com:
    • Nome da tarefa
    • Status (concluída / pendente)
    • Pessoa atribuída
    • Data de vencimento
  3. Filtre por status para ver apenas as concluídas

Detecção automática de workspace​

Ao conectar, o Frihet detecta seu primeiro workspace automaticamente. Se você tiver vários workspaces no Asana, o principal será usado. Você não precisa configurar nada adicional.

Tratamento de erros​

Todas as chamadas à API do Asana têm um timeout de 30 segundos. Se uma requisição falhar, o Frihet registra o erro automaticamente para diagnóstico. Verifique sua conexão com a internet se as consultas falharem repetidamente.

Solução de problemas​

"Erro de autenticação"​

  • Verifique se o Personal Access Token está correto
  • Verifique se ele não foi revogado no console de desenvolvedor do Asana
  • Se você regenerou o token, atualize-o no Frihet

"Não vejo meus projetos"​

  • O Frihet usa o primeiro workspace da sua conta. Se você tiver vários, o que você deseja pode estar em outro
  • Verifique se você tem acesso aos projetos a partir da sua conta do Asana
  • Os projetos privados de outros usuários não serão visíveis

"As tarefas não são atualizadas"​

  • As consultas são em tempo real (sob demanda)
  • Recarregue a visualização no Frihet para ver as mudanças recentes
  • Verifique se as tarefas estão atribuídas ao projeto correto no Asana

"Quero usar outro workspace"​

  • Atualmente, o Frihet detecta automaticamente o primeiro workspace
  • Se precisar mudar, desconecte e reconecte a integração
  • O workspace selecionado depende da ordem retornada pela API do Asana

"Quero desconectar"​

  1. Vá para Configurações → Integrações → Asana
  2. Clique em Desconectar
  3. Opcionalmente, revogue o token em app.asana.com/0/developer-console

Próximos passos​