Como migrar do Clockify para o Nimbos sem perder o histórico de horas
Atualizado em 18 de outubro de 2026
A migração se faz pela API do Clockify, um mês por vez: quem administra o Nimbos cola a chave da API, escolhe o mês e sincroniza. Vêm as horas — pessoa, projeto, atividade, descrição, início e fim; ficam de fora tarifas, valores e a marca de faturável, porque o preço de cada projeto é definido no Nimbos. Sincronizar o mesmo mês de novo não duplica: o Nimbos espelha o Clockify, com as exceções da tabela abaixo.
Antes de começar
- Quem faz: uma pessoa com a permissão Importar horas (planilha e Clockify) no Nimbos. O perfil ADM já nasce com ela.
- De onde vêm as horas: do relatório detalhado do workspace que estiver ativo na conta dona da chave. O que essa conta não enxerga no Clockify, o Nimbos também não recebe — confira o workspace antes de conectar.
- Cronômetros parados: lançamento sem hora de fim não entra. O resultado da sincronização diz qual foi, para você corrigir no Clockify.
Passo a passo
- No Clockify, gere a chave da API em Profile settings → API.
- No Nimbos, abra a administração, seção Importação, e cole a chave em Sincronizar pela API do Clockify. O Nimbos confere a chave antes de guardá-la, guarda cifrada e nunca a mostra de volta.
- Escolha o mês a sincronizar e clique em Sincronizar mês. O resultado diz quantos lançamentos entraram, quantos já existiam e o que ficou de fora, com o motivo.
- Repita para cada mês do histórico que você quer trazer.
- Confira as pessoas e os projetos criados. Quem não existia no Nimbos é criado pelo e-mail, e cada pessoa nova ocupa uma licença.
O que vem do Clockify — e o que não vem
| No Clockify | No Nimbos |
|---|---|
| Usuário | Pessoa, reconhecida pelo e-mail — criada se ainda não existir |
| Projeto e cliente | Projeto, criado pelo nome, com o nome do cliente |
| Tarefa | Atividade do projeto |
| Descrição, início e fim | Os mesmos, no lançamento |
| Etiqueta ou tarefa com HORA EXTRA no nome | Lançamento marcado como hora extra |
Não vem: a marcação de faturável e os valores — tarifa e preço são definidos no Nimbos, por projeto e por perfil —, as outras etiquetas, o cronômetro que ainda está rodando e o lançamento de duração zero.
Sincronizar de novo: o que acontece em cada caso
O Nimbos reconhece um lançamento importado por três dados: a pessoa, o início e o fim. Dentro do mês sincronizado, ele espelha o Clockify — e é esse critério que decide cada caso:
| O que aconteceu no Clockify | O que acontece no Nimbos |
|---|---|
| Lançamento novo | Entra |
| Lançamento já sincronizado, sem mudança | Fica como está — nada duplica |
| Horário alterado (início ou fim) | A versão antiga sai e a nova entra |
| Só o projeto, a atividade, a descrição ou a etiqueta mudou, com o mesmo horário | Não é atualizado: pela pessoa e pelo horário é o mesmo lançamento, e a versão anterior fica. Corrija também no Nimbos |
| Lançamento apagado | Sai do Nimbos |
| Lançamento já faturado, de mês aprovado, de apuração fechada ou de pessoa desativada | Fica no Nimbos mesmo apagado ou alterado lá; o resultado mostra o conflito e o motivo. Se foi alterado, a versão nova pode entrar ao lado — trate o conflito para não contar a hora em dobro |
| Lançamento novo num mês já aprovado, ou de pessoa desativada | Não entra; o resultado mostra o conflito e o motivo |
Atenção: mudar no Clockify só o projeto, a atividade, a descrição ou a etiqueta de um lançamento, sem mexer no horário, não chega ao Nimbos — a sincronização o reconhece pela pessoa e pelo horário. Faça a mesma correção no Nimbos.
O que foi lançado direto no Nimbos nunca é tocado pela sincronização, e toda remoção fica registrada na auditoria. Dois lançamentos da mesma pessoa com exatamente o mesmo início e fim contam como um só: o segundo não entra.
Isso deixa os dois rodarem juntos durante a transição: a equipe continua no Clockify, e você sincroniza o mês quantas vezes quiser até virar a chave. Se alguém já lança direto no Nimbos, o resultado avisa — confira para não contar a mesma hora duas vezes.
Limites que vale conhecer
- Até 20.000 lançamentos por sincronização, um mês por vez.
- No plano gratuito do Clockify, a API aceita 30 requisições por hora por workspace, segundo a documentação deles. Se o Clockify recusar por limite, espere e sincronize o mês de novo — não duplica.
- A sincronização depende do relatório detalhado do Clockify. Se ele não vier, o Nimbos avisa em vez de importar pela metade.
Sem acesso à API: o caminho por arquivo
Quem não pode usar a chave traz as horas por arquivo — CSV, TXT ou XLSX —, ligando as colunas uma vez e guardando o mapeamento como modelo. O Nimbos oferece uma planilha-modelo com Colaborador, E-mail, Data, Início, Término, Horas, Projeto, Atividade, Descrição e Hora extra.
Por arquivo, os projetos já precisam existir no Nimbos, e reimportar o mesmo período substitui as horas daquela pessoa naquele projeto — não soma.
Depois da migração, a saída continua igual
Planilhas e scripts que liam o relatório detalhado do Clockify em português continuam funcionando: o Nimbos exporta as horas num CSV com os mesmos nomes de coluna e a mesma ordem — sem a coluna Grupo. Os nomes das colunas do CSV são sempre esses, em português: é um formato fixo, para não quebrar quem já o lê.
Para abrir no Excel, há também a versão em planilha (.xlsx): nela os rótulos seguem o idioma da tela, a coluna Tarefa se chama Atividade, e data, hora e duração saem como número, prontas para somar e ordenar.
Com as horas no Nimbos, a margem de cada projeto sai do mesmo registro — veja como calcular a margem por projeto.
Perguntas frequentes
Preciso parar de usar o Clockify no dia da migração?
Não. Sincronizar de novo espelha o Clockify, então os dois convivem enquanto a equipe se adapta. O corte é quando você decidir.
As tarifas e os valores do Clockify vêm junto?
Não. O Nimbos não lê valores do Clockify: o preço é definido por projeto e por perfil dentro do Nimbos, e o custo de cada pessoa também.
O que acontece com quem não tem cadastro no Nimbos?
A pessoa é criada pelo e-mail na primeira sincronização e passa a ocupar uma licença.
Como o Nimbos faz isso
Para continuar
Fontes
- Clockify API — documentação oficial (chave da API, relatório detalhado e limites de requisição) — consultado em 18 de outubro de 2026