> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/tarefas/obter-todos.md).

# 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! 🚀


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/tarefas/obter-todos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.