Tarefas

O componente Tarefas permite criar, gerenciar e acompanhar tarefas dentro do sistema, possibilitando a organização eficiente de atividades e automação de fluxos de trabalho.

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!