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