# Obter todos

### 🎯 **O que essa operação faz?**

Essa operação busca todas as tarefas dentro de um workspace, permitindo:

✅ Obter uma lista completa de tarefas cadastradas.\
✅ Aplicar filtros para buscar tarefas específicas.\
✅ Utilizar a lista de tarefas em fluxos automatizados.

***

### 📂 **Campos e Tipos de Dados**

| **Campo**               | **Tipo de Dado** | **Obrigatório?** | **Descrição**                                                                                                    |
| ----------------------- | ---------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Workspace ID**        | `string`         | ✅ Sim            | ID do workspace onde as tarefas estão armazenadas.                                                               |
| **Página**              | `number`         | ❌ Não            | Define a página dos resultados para paginação.                                                                   |
| **Limite**              | `number`         | ❌ Não            | Número máximo de tarefas retornadas por página.                                                                  |
| **Ordenação**           | `string`         | ❌ Não            | Campo pelo qual os resultados serão ordenados (`created_at`, `updated_at`, `finished_at`, `start_date`, `name`). |
| **Direção da Ordem**    | `string`         | ❌ Não            | Define a ordem (`asc` para crescente, `desc` para decrescente).                                                  |
| **Status**              | `string`         | ❌ Não            | Filtra tarefas por status (`pending`, `in_progress`, `done`, `failed`).                                          |
| **Usuário Responsável** | `string`         | ❌ Não            | Filtra tarefas atribuídas a um usuário específico.                                                               |
| **Organização**         | `string`         | ❌ Não            | Filtra tarefas vinculadas a uma organização.                                                                     |
| **Pessoa**              | `string`         | ❌ Não            | Filtra tarefas vinculadas a uma pessoa.                                                                          |
| **Cartão Vinculado**    | `string`         | ❌ Não            | Filtra tarefas associadas a um cartão.                                                                           |
| **Sem Data**            | `boolean`        | ❌ Não            | Define se deseja buscar apenas tarefas sem data definida.                                                        |
| **Nome da Tarefa**      | `string`         | ❌ Não            | Filtra por nome da tarefa.                                                                                       |
| **Descrição**           | `string`         | ❌ Não            | Filtra por palavras-chave na descrição da tarefa.                                                                |
| **Data de Início**      | `datetime`       | ❌ Não            | Filtra tarefas a partir de uma data de início específica.                                                        |
| **Data de Conclusão**   | `datetime`       | ❌ Não            | Filtra tarefas até uma data de conclusão específica.                                                             |

***

### ✅ **Passo a passo para Configurar a Operação "Buscar Todas"**

#### 1️⃣ **Acesse o Componente**

1. No **Hablla Studio**, abra o fluxo de automação onde deseja buscar todas as tarefas.
2. Adicione o bloco **Tarefas**.
3. No **painel lateral direito**, selecione a operação **"Buscar Todas"**.

#### 2️⃣ **Preencha os Campos Obrigatórios**

🔹 **Workspace ID** → Defina o workspace ao qual as tarefas pertencem.

#### 3️⃣ **Defina os Filtros Opcionais**

🔹 **Ordenação** → Escolha um campo de ordenação e direção (`asc` ou `desc`).\
🔹 **Status** → Filtre por status específico (`pending`, `done`, etc.).\
🔹 **Usuário Responsável** → Filtre por tarefas atribuídas a um usuário.\
🔹 **Datas** → Defina um período para buscar tarefas dentro de um intervalo.

#### 4️⃣ **Salvar a Configuração**

Após preencher os campos, clique no botão **"Salvar"** ✅.

Agora, sempre que essa automação for acionada, todas as tarefas que atendem aos filtros configurados serão listadas automaticamente.

***

### 📌 **Exemplo de Uso no Fluxo de Automação**

📊 **Cenário:** Buscar todas as tarefas pendentes e notificá-las via WhatsApp.

1️⃣ **Bloco 1** → Buscar todas as tarefas com status **pendente**.\
2️⃣ **Bloco 2** → Filtrar as tarefas atrasadas.\
3️⃣ **Bloco 3** → Enviar uma notificação para os responsáveis via WhatsApp.

🚀 **Resultado:** O sistema alerta automaticamente os responsáveis sobre tarefas pendentes, evitando atrasos.

***

### 🎉 **Conclusão**

A operação **Buscar Todas as Tarefas (get\_all)** no **Hablla Studio** facilita a gestão e monitoramento de tarefas, permitindo segmentação por status, responsáveis e prazos. Essa funcionalidade é essencial para manter fluxos de trabalho organizados e automatizados.

Se precisar de mais suporte, entre em contato com nossa equipe! 🚀
