> 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.md).

# Tarefas

Com ele, é possível criar novas tarefas, atualizar informações, remover registros, buscar tarefas existentes e adicionar itens de checklist para melhor gerenciamento.

### 📂 **Operações Disponíveis**

Aqui estão as operações que podem ser realizadas com este componente:

| **Operação**                                              | **Descrição**                                    |
| --------------------------------------------------------- | ------------------------------------------------ |
| **Criar (create)**                                        | Cria uma nova tarefa no sistema.                 |
| **Atualizar (update)**                                    | Atualiza os dados de uma tarefa existente.       |
| **Deletar (delete)**                                      | Remove uma tarefa do sistema.                    |
| **Buscar por ID (get\_by\_id)**                           | Obtém os detalhes de uma tarefa específica.      |
| **Buscar todas (get\_all)**                               | Obtém uma lista de todas as tarefas cadastradas. |
| **Adicionar item de checklist (add\_checklist\_item)**    | Adiciona um item à checklist da tarefa.          |
| **Atualizar item de checklist (update\_checklist\_item)** | Atualiza um item da checklist da tarefa.         |
| **Remover item de checklist (delete\_checklist\_item)**   | Remove um item da checklist da tarefa.           |

### 📑 **Variáveis Utilizadas no Componente**

Abaixo estão as variáveis utilizadas no componente **Tarefas**, incluindo seus tipos de dados e obrigatoriedade.

| **Campo**               | **Tipo de Dado** | **Obrigatório?** | **Descrição**                                                        |
| ----------------------- | ---------------- | ---------------- | -------------------------------------------------------------------- |
| **Workspace ID**        | `string`         | ✅ Sim            | ID do workspace onde a tarefa está localizada.                       |
| **ID da Tarefa**        | `string`         | ✅ Sim            | Identificador único da tarefa no sistema.                            |
| **Nome**                | `string`         | ✅ Sim            | Nome da tarefa.                                                      |
| **Descrição**           | `string`         | ✅ Sim            | Descrição detalhada da tarefa.                                       |
| **Usuário Responsável** | `string`         | ✅ Sim            | Identificador do usuário atribuído à tarefa.                         |
| **Tipo**                | `string`         | ✅ Sim            | Define o tipo de tarefa (ex: chamada, e-mail, reunião, etc.).        |
| **Cor**                 | `string`         | ✅ Sim            | Define a cor da tarefa para organização visual.                      |
| **Setor**               | `string`         | ❌ Não            | Setor ao qual a tarefa está vinculada.                               |
| **Pessoa**              | `string`         | ❌ Não            | Pessoa associada à tarefa (se aplicável).                            |
| **Organização**         | `string`         | ❌ Não            | Organização vinculada à tarefa.                                      |
| **Serviço**             | `string`         | ❌ Não            | Serviço relacionado à tarefa (se aplicável).                         |
| **Cartão Vinculado**    | `string`         | ❌ Não            | ID do cartão associado à tarefa.                                     |
| **Data de Início**      | `datetime`       | ✅ Sim            | Data e hora de início da tarefa.                                     |
| **Data de Conclusão**   | `datetime`       | ✅ Sim            | Data e hora esperada de conclusão da tarefa.                         |
| **Status**              | `string`         | ✅ Sim            | Define o status da tarefa (pendente, em andamento, concluída, etc.). |
| **Checklist**           | `array`          | ❌ Não            | Lista de itens que compõem a checklist da tarefa.                    |

### 🎯 **Como Configurar uma Operação**

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

1. No **Hablla Studio**, abra o fluxo de automação onde deseja incluir a ação.
2. Adicione o bloco **"Tarefas"**.
3. No **painel lateral direito**, selecione a operação desejada.

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

Dependendo da operação escolhida, alguns campos são obrigatórios. Consulte a tabela de variáveis acima para entender quais dados devem ser preenchidos para cada operação.

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

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

Agora, sempre que essa automação for acionada, a tarefa será gerenciada conforme a configuração definida.

### 📝 **Detalhamento das Operações**

Cada operação possui campos obrigatórios e opcionais que devem ser preenchidos conforme o caso. Abaixo, detalharemos cada uma delas:

1️⃣ **Criar Tarefa**\
2️⃣ **Atualizar Tarefa**\
3️⃣ **Excluir Tarefa**\
4️⃣ **Buscar Tarefa por ID**\
5️⃣ **Buscar Todas as Tarefas**\
6️⃣ **Gerenciar Checklist da Tarefa**

🚀 **Continue para os próximos tópicos para configurar cada operação corretamente!**


---

# 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:

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

The question should be specific, self-contained, and written in natural language.
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.