---
title: Importação por planilha
slug: agility/importacao-por-planilha
docTags: 
createdAt: 2026-03-20T13:24:48.166Z
---

## 🚀 Importação por planilha no Agility

Agora você pode **criar Workspaces, Projetos e Tarefas de uma vez só**, usando uma planilha (Excel ou CSV).

👉 Ou seja: em vez de cadastrar tudo manualmente, você sobe um arquivo e o sistema faz o resto.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/CZmM3J6lKc8FvXrrewUVN-20260319-143429.gif)

***

## 📥 Como funciona (sem complicação)

### 📄 Baixar o modelo

- O sistema disponibiliza um **modelo de planilha pronto** 
- Pode ser em **Excel (.xlsx)** ou **CSV** 

👉 Esse modelo já vem com as colunas obrigatórias.

Para baixar, clique nos três pontinhos (...) ao lado do botão adicionar workspace e em seguida clique em **Exportar modelo de workspace**.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/cJpMKkqo38FJKV1seFhy-_image.png)

Modelo da Planilha disponível

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/z8KsxcHBrrEap4RTAlsm1_image.png)

### 📤 Enviar a planilha

- Você faz o upload do arquivo 
- O sistema lê tudo automaticamente 
- No final, ele mostra: 
  - ✔️ O que foi criado 
  - ⚠️ O que deu erro 

Para enviar, clique nos três pontinhos (...) ao lado do botão adicionar workspace e em seguida clique em **Importar workspace**.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/rILPi1w7wYQ1Kv9_NJVMM_image.png)

Mensagem de erro quando já existe workspace, tarefa e projeto já criados com o mesmo nome:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/BHPP6sYr-K66sAdhuxoiX_image.png)

***

## ⚠️ Regras importantes 

### 📌 Sobre a planilha

- Precisa ter **cabeçalho (nomes das colunas)** 
- Arquivo vazio ou formato errado → ❌ erro 
- Linhas vazias → ignoradas 

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ioihERU9WeAsxa2qgfg7W_image.png)

### 🏢 Sobre Workspaces

Se o workspace **já existir**:

- 👤 Usuário comum: 
  - ❌ Não cria de novo 
  - ❌ Não cria projetos/tarefas dentro dele 
  - ⚠️ Mostra erro 
- 👑 Usuário admin: 
  - ❌ Não cria de novo 
  - ✅ Pode criar projetos e tarefas dentro dele 

👉 Exemplo:
 Se já existe "workspaceA", ele não duplica, mas pode usar o existente.

### 📋 Sobre Projetos (Boards)

- São **obrigatórios** se tiver tarefa ou datas 
- Se faltar → ❌ erro e linha ignorada 

📅 Datas:

- Se não informar → sistema preenche automático 
- Se só uma data for informada → completa sozinho 
- Se a data final for menor que a inicial → ❌ erro 

### 📝 Sobre Tarefas

- São **opcionais** 
- Não deixa criar tarefas duplicadas (mesmo nome) 
- Toda tarefa nova começa como: 
  - ▶️ **“Não iniciada” (Em espera)** 

Se essa etapa não existir → ❌ erro

### 📊 Sobre o processamento

- O sistema entende automaticamente: 
  - CSV com ; ou , 
  - Excel (primeira aba)