Você tem um registro de horas do Toggl com horas rastreadas por projeto e tarefa e deseja trazer esses dados para um banco de dados do Notion para relatórios, faturamento ou visibilidade da equipe. O Toggl não oferece integração direta com o Notion, então você precisa exportar o registro e importá-lo usando o recurso de importação CSV do Notion. Este artigo mostra como exportar o relatório correto do Toggl, formatar os dados para o Notion e importá-los para um banco de dados novo ou existente.
Principais pontos: Importar registros de horas do Toggl para o Notion
- Toggl Reports > Detailed Report > Exportar como CSV: Gera um registro bruto de horas com data, descrição, projeto, tarefa e duração.
- Mapeamento de colunas CSV no Notion: O Notion detecta automaticamente colunas como Data, Título, Seleção e Número durante a importação; você deve renomear as colunas do Toggl para corresponder aos tipos de propriedade do Notion.
- Notion Import > CSV > Criar novo banco de dados: Cria um banco de dados novo a partir do seu CSV; bancos existentes exigem correspondência manual de propriedades usando a opção Mesclar.
Por que você não pode sincronizar o Toggl diretamente com o Notion
Toggl e Notion não compartilham um conector nativo. Ferramentas de automação de terceiros como Zapier ou Make podem conectar os dois aplicativos, mas exigem planos pagos e ainda enviam entradas uma de cada vez. Para uma importação única em massa de registros de horas históricos, o método de exportação e importação CSV é mais rápido e gratuito.
A exportação do Relatório Detalhado do Toggl produz um arquivo CSV com colunas como Data de Início, Data de Término, Descrição, Projeto, Cliente, Tarefa e Duração em segundos. O importador CSV do Notion espera colunas que mapeiem para seus tipos de propriedade: Título (texto), Data (data), Seleção (seleção única), Número (número) e assim por diante. Você deve ajustar o CSV antes de importar para que o Notion interprete cada coluna corretamente.
Passos para exportar e limpar o CSV do Toggl
- Abra os Relatórios do Toggl
Faça login na sua conta do Toggl. Na barra lateral esquerda, clique em Reports. Selecione Detailed Report entre os tipos de relatório. - Defina o intervalo de datas
Use o seletor de datas no topo para selecionar o período para o qual deseja importar as entradas. Clique em Apply. - Exporte como CSV
Clique no botão Export no canto superior direito. Escolha Download as CSV. O arquivo é salvo no seu computador. - Abra o CSV em um aplicativo de planilha
Abra o arquivo baixado no Microsoft Excel, Google Sheets ou qualquer editor CSV. Você verá colunas como Start Date, End Date, Description, Project, Client, Task, Duration (seconds) e Tags. - Renomeie e reordene as colunas para o Notion
O Notion usa a primeira linha como nomes de propriedades. Renomeie as colunas da seguinte forma:
– Start Date vira Date
– Description vira Name (isso se torna o título do banco de dados)
– Project vira Project (se tornará uma propriedade Select)
– Client vira Client (propriedade Select)
– Duration (seconds) vira Duration (h) (propriedade Number)
Exclua colunas desnecessárias: End Date, Task, Tags e quaisquer outras colunas extras. Salve o arquivo como CSV. - Converta a duração para horas
O Notion espera duração em horas, não em segundos. Na sua planilha, adicione uma nova coluna Duration (h). Use uma fórmula para dividir o valor em segundos por 3600. Por exemplo, no Excel:=celula/3600. Formate o resultado como número com duas casas decimais. Copie os valores e cole como números puros. Exclua a coluna original Duration (seconds).
Passos para importar o CSV para o Notion
- Abra o workspace do Notion
Navegue até a página onde deseja que o novo banco de dados apareça. - Inicie a importação
Clique no botão Import na barra lateral esquerda (ou digite/importem uma linha em branco). Selecione CSV na lista de tipos de arquivo. - Envie seu CSV limpo
Clique em Choose File e selecione seu CSV editado. O Notion mostrará uma prévia das colunas detectadas. - Mapeie colunas para os tipos de propriedade do Notion
Na janela de importação, cada coluna CSV aparece com um menu suspenso. Defina o tipo para cada coluna:
– Name → Title
– Date → Date
– Project → Select
– Client → Select
– Duration (h) → Number
Se uma coluna não for reconhecida, escolha o tipo correto no menu suspenso. - Escolha o destino da importação
Selecione Create new database para criar um banco de dados novo. Se quiser adicionar a um banco existente, selecione Merge with existing database e escolha o banco de dados de destino na lista. O Notion corresponderá as linhas pela propriedade Title. - Clique em Import
O Notion processa o arquivo. Uma nova página de banco de dados aparece com todos os seus registros de horas. Cada linha mostra a data, descrição, projeto, cliente e horas.
Problemas comuns na importação e como resolvê-los
Coluna de duração aparece como texto em vez de número
Se a coluna Duration (h) aparecer como texto no Notion, as células do CSV podem conter espaços extras ou caracteres não numéricos. Abra o CSV em um editor de texto e garanta que cada célula nessa coluna contenha apenas dígitos e um ponto decimal. Remova quaisquer símbolos de moeda, vírgulas ou unidades como “h”. Reimporte o arquivo.
Colunas Project e Client viram texto em vez de Select
O Notion só detecta automaticamente propriedades Select se o cabeçalho da coluna corresponder ao nome de uma propriedade Select existente no banco de dados. Ao criar um novo banco de dados, defina o tipo como Select manualmente na janela de importação. Para um banco existente, a coluna deve ter exatamente o mesmo nome da propriedade Select no banco de destino.
Entradas duplicadas aparecem após a importação
Se você usar Merge with existing database, o Notion corresponde as linhas pela propriedade Title. Se duas entradas tiverem a mesma descrição, o Notion as trata como duplicatas. Adicione um identificador único à coluna Description no Toggl antes de exportar, como um timestamp ou ID de entrada.
Coluna de data mostra fuso horário incorreto
O Toggl exporta datas em UTC. O Notion exibe datas no fuso horário do seu workspace. Para evitar confusão, adicione uma coluna separada para fuso horário no CSV ou converta a coluna Start Date para seu fuso horário local antes de importar.
Exportação CSV do Toggl vs API do Notion: Métodos comparados
| Item | Exportação CSV do Toggl + Importação no Notion | API do Toggl + API do Notion (Script personalizado) |
|---|---|---|
| Custo | Gratuito | Gratuito se você mesmo programar; pago se usar ferramentas de automação |
| Tempo de configuração | 15 minutos | Várias horas para escrever e testar um script |
| Importações recorrentes | Manual a cada vez | Automatizado via cron job ou webhook |
| Volume de dados | Ilimitado (limite de tamanho de arquivo é 5 MB no plano gratuito do Notion) | Ilimitado |
| Mapeamento de colunas | Renomeação manual na planilha | Mapeamento programático no código |
O método CSV é melhor para importações únicas de dados históricos. Se você precisar de sincronizações semanais ou diárias, considere usar a API do Toggl com uma integração da API do Notion ou uma ferramenta no-code como Zapier.
Agora você pode importar registros de horas do Toggl para um banco de dados do Notion usando o fluxo de exportação e importação CSV. Após a importação, adicione fórmulas de rollup para calcular o total de horas por projeto ou crie uma visualização de banco de dados vinculada para faturamento de clientes. Para importações recorrentes, explore a documentação da API do Notion para criar um script de sincronização personalizado que seja executado em um agendamento.