> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synkrony.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Importação de Tarefas

> Migre seus projetos de outras ferramentas como Asana, ClickUp, Jira e Linear

A **Importação de Tarefas** permite que você migre facilmente seus projetos de outras ferramentas de gerenciamento para o Synkrony. Com suporte para planilhas CSV e XLSX exportadas de Asana, ClickUp, Jira, Linear e outros, você pode trazer suas tarefas, projetos, tags e responsáveis em poucos minutos.

Acesse a importação através do menu lateral: **Configurações → Importação**.

***

## 🔄 Como Funciona

O processo de importação é realizado em 3 etapas simples:

1. **Upload do Arquivo:** Envie sua planilha (.CSV ou .XLSX) exportada da ferramenta de origem
2. **Mapeamento de Campos:** Associe as colunas da planilha aos campos do sistema
3. **Preview e Confirmação:** Revise os dados, mapeie os status e confirme a importação

### Softwares Suportados

| Software                | Formatos | Observações                                |
| ----------------------- | -------- | ------------------------------------------ |
| **ClickUp**             | CSV/XLSX | Suporte completo a campos customizados     |
| **Asana**               | CSV/XLSX | Mapeamento automático de projetos e seções |
| **Jira**                | CSV/XLSX | Suporte a data/hora específico do Jira     |
| **Linear**              | CSV/XLSX | Mapeamento de labels e assignees           |
| **Planilhas Genéricas** | CSV/XLSX | Qualquer planilha com estrutura compatível |

***

## 📤 Etapa 1: Upload do Arquivo

### Formatos Aceitos

* **CSV:** Separado por vírgulas, com BOM UTF-8 ou sem
* **XLSX/XLS:** Excel nativo

### Instruções por Software

#### ClickUp

1. Acesse o ClickUp
2. Vá em **List View** da sua lista/tarefas
3. Clique no menu de 3 pontos
4. Selecione **Export**
5. Escolha formato **CSV** ou **Excel**
6. Faça upload no Synkrony

#### Asana

1. Abra o projeto no Asana
2. Clique na seta ao lado do nome do projeto
3. Selecione **Export → CSV**
4. Faça upload no Synkrony

#### Jira

1. Execute a busca das tarefas que deseja exportar
2. Clique no botão **Export** no topo
3. Selecione **Excel** (current fields)
4. Faça upload no Synkrony

#### Linear

1. Abra o projeto no Linear
2. Clique em **... → Export**
3. Selecione **CSV**
4. Faça upload no Synkrony

***

## 🔗 Etapa 2: Mapeamento de Campos

Após fazer o upload, você verá uma tabela onde deve associar cada coluna da sua planilha aos campos do sistema.

### Campos do Sistema Disponíveis

| Campo               | Descrição                                 | Obrigatório |
| ------------------- | ----------------------------------------- | ----------- |
| **Nome da Tarefa**  | Título da tarefa                          | Sim         |
| **Status**          | Status da tarefa (ex: TODO, Em Progresso) | Recomendado |
| **Projeto**         | Projeto ao qual a tarefa pertence         | Recomendado |
| **Descrição**       | Detalhes da tarefa                        | Não         |
| **Estimativa**      | Tempo estimado em horas                   | Não         |
| **Prioridade**      | Nível de prioridade                       | Não         |
| **Responsável**     | Usuário atribuído                         | Não         |
| **Etiquetas**       | Tags da tarefa                            | Não         |
| **Data de Criação** | Quando a tarefa foi criada                | Não         |

### Mapeamento Automático

Clique em **"Mapear automaticamente"** para que o sistema identifique as colunas baseado em padrões conhecidos:

* **ClickUp:** Task Name, Status, List Name, Time Estimated, Tags
* **Asana:** Name, Projects, Section/Column, Created At
* **Jira:** Nome do Projeto, Estimativa Original, Resumo, Criado
* **Linear:** Title, Project, Labels, Assignee, Created

***

## 👁️ Etapa 3: Preview e Confirmação

Nesta etapa final, você pode revisar todos os dados antes de confirmar a importação.

### Abas Disponíveis

#### Tarefas

Visualize as primeiras 20 tarefas que serão importadas com seus campos mapeados.

#### Projetos

* Revise todos os projetos detectados na importação
* **Remova** projetos que não deseja importar clicando no ícone **X**
* **Restaure** projetos clicando no ícone de desfazer
* Tarefas sem projeto identificado serão atribuídas ao **"Projeto Padrão"**

#### Etiquetas

Visualize todas as tags que serão criadas automaticamente.

#### Usuários

Visualize os responsáveis detectados. Usuários serão criados com emails temporários caso não existam.

#### Status

**Importante:** Associe os status do software original aos status do seu Kanban no Synkrony.

1. Clique em **"Mapear automaticamente"** para tentar mapear status comuns
2. Para cada status da planilha, selecione o status correspondente do sistema
3. Status não mapeados resultarão em tarefas sem status definido

| Status Original | Status do Sistema |
| --------------- | ----------------- |
| Todo            | TODO              |
| In Progress     | IN PROGRESS       |
| Complete        | DONE              |

***

## ⚙️ Comportamentos Especiais

### Cores Automáticas

* **Projetos** recebem cores automáticas de uma paleta pré-definida
* **Tags** recebem cores em ordem inversa para variedade visual
* Você pode editar cores posteriormente em **Configurações → Projetos**

### Tratamento de Estimativas

* Estimativas em **milissegundos** (ClickUp) são convertidas para horas
* Estimativas em **segundos** são convertidas para horas
* Valores menores que 1 hora são arredondados para 1 hora
* Valores maiores são arredondados para cima

### Formatos de Data

O sistema reconhece automaticamente formatos de diferentes softwares:

* **Jira:** `06/May/24 02:30 PM`
* **Asana:** `2024-05-06`
* **ClickUp:** `05/06/2024, 14:30:00 PM`
* **Linear e outros:** Formato ISO ou padrão do sistema

### Múltiplos Valores

* **Tags:** Múltiplas tags separadas por vírgula: `[bug, frontend, urgente]`
* **Responsáveis:** Múltiplos assignees separados por vírgula

***

## 🔙 Reversão de Importação

Caso precise desfazer uma importação:

1. Acesse **Configurações → Importação**
2. Vá para a aba **Histórico de Importação**
3. Clique no menu de 3 pontos da importação desejada
4. Selecione **"Reverter importação"**
5. Confirme a operação

> A reversão é assíncrona. Todos os projetos, tarefas, tags e usuários criados pela importação serão removidos, incluindo dados relacionados como time logs e comentários.

***

## 🎯 Dicas e Boas Práticas

1. **Revise o preview cuidadosamente:** Verifique especialmente status e projetos antes de confirmar
2. **Mapeie todos os status:** Tarefas sem status podem ficar perdidas no kanban
3. **Use projetos existentes:** Se você já tem projetos criados, mantenha os nomes idênticos para reutilizar
4. **Limpe os dados:** Antes de exportar, remova tarefas que não deseja migrar
5. **Teste com pequenos volumes:** Faça uma importação de teste com poucas tarefas primeiro
6. **Verifique estimativas:** Confirme se as horas estimadas foram convertidas corretamente
7. **Configure usuários:** Após importar, atualize os emails temporários dos usuários

***

## ❓ FAQ

**Posso importar do Trello?**
Sim! Exporte seu Trello para CSV e faça a importação seguindo os mesmos passos.

**O que acontece com tarefas duplicadas?**
O sistema não detecta duplicatas automaticamente. Se você fizer a importação duas vezes, terá tarefas duplicadas. Use a reversão para remover a segunda importação.

**Posso editar tarefas após a importação?**
Sim, todas as tarefas importadas podem ser editadas normalmente no kanban.

**Os usuários importados recebem notificação?**
Não. Usuários criados automaticamente recebem emails temporários e não são notificados. Você deve editar e convidar os membros da equipe posteriormente.

**Posso fazer múltiplas importações?**
Sim! Você pode importar de múltiplas fontes. Cada importação fica salva no histórico e pode ser revertida independentemente.

**O limite de tarefas por importação?**
O preview mostra as primeiras 20 tarefas, mas a importação processa todo o arquivo. Arquivos muito grandes podem demorar mais para serem processados.

***

## 📚 Documentação Relacionada

* [Status do Kanban](/status) - Configure os status disponíveis no seu fluxo
* [Projetos](/projects) - Gerencie os projetos da sua empresa
* [Sprints](/sprints) - Organize o trabalho em ciclos produtivos
