# Criar

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

Essa operação cria uma nova tarefa dentro de um workspace, possibilitando o preenchimento de informações como: 

✅ Nome da tarefa\
✅ Descrição detalhada\
✅ Tipo de tarefa (chamada, reunião, e-mail, etc.)\
✅ Usuário responsável\
✅ Data de início e conclusão\
✅ Associação com pessoas, cartões, organizações e serviços\
✅ Checklist de tarefas

### 📂 Como Configurar a Operação "Criar"

1️⃣ **Acesse o Componente**\
No **Hablla Studio**, abra o fluxo de automação onde deseja criar uma tarefa.

2️⃣ **Adicione o Bloco "Tarefas"**\
No painel lateral direito, selecione a operação **Criar**.

3️⃣ **Escolha a Forma de Especificar o Corpo**\
Você pode especificar os dados da tarefa U**sando Campos** ou **Usando JSON**.

### 🔹 **Especificar Corpo: Usando Campos**

Se a opção **Usando Campos** estiver selecionada, os seguintes campos podem ser preenchidos:

| Campo                      | Tipo            | Obrigatório | Descrição                                                                                                                                         |
| -------------------------- | --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome da Tarefa**         | `string`        | ✅ Sim       | Nome ou título da tarefa que está sendo criada.                                                                                                   |
| **Sobre**                  | `string`        | ✅ Sim       | Informações detalhadas da tarefa.                                                                                                                 |
| **Descrição**              | `string`        | ✅ Sim       | Descrição detalhada da tarefa.                                                                                                                    |
| **Tipo de Tarefa**         | `string (enum)` | ✅ Sim       | Especifica o tipo de tarefa, como chamada, reunião, e-mail, etc.                                                                                  |
| **Data de Início**         | `datetime`      | ✅ Sim       | Data e hora de início da tarefa.                                                                                                                  |
| **Data de Conclusão**      | `datetime`      | ✅ Sim       | Data e hora previstas para a conclusão da tarefa.                                                                                                 |
| **Usuário Responsável**    | `string`        | ❌ Não       | ID do usuário responsável pela execução da tarefa.                                                                                                |
| **ID da Pessoa Associada** | `string`        | ❌ Não       | ID da pessoa relacionada à tarefa.                                                                                                                |
| **ID da Organização**      | `string`        | ❌ Não       | ID da organização relacionada à tarefa.                                                                                                           |
| **ID do Cartão Associado** | `string`        | ❌ Não       | ID do cartão (card) ao qual a tarefa está vinculada.                                                                                              |
| **Setor**                  | `string`        | ❌ Não       | Setor ou departamento relacionado à tarefa.                                                                                                       |
| **Checklist**              | `array`         | ❌ Não       | Lista de itens a serem verificados ou concluídos dentro da tarefa. Cada item do array deve seguir a estrutura: `{ "item": "Descrição do item" }`. |

✅ Após preencher os campos, clique em **Salvar** para concluir a configuração.

<figure><img src="https://1879311494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FaDIKVesTS6E7xIDO3nXd%2Fimage.png?alt=media&#x26;token=252b40db-a13b-4481-b053-1c9bd9b0cc93" alt=""><figcaption><p>Tarefa de ligação para daqui 20 minutos com 20 minutos de duração</p></figcaption></figure>

### 🔹 **Especificar Corpo: Usando JSON**

Se a opção **Usando JSON** estiver selecionada, utilize o seguinte formato para enviar os dados da tarefa:

```json
{
  "name": "Reunião com cliente",
  "description": "Discutir proposta comercial e alinhar próximos passos.",
  "about": "Essa tarefa faz parte do pipeline de vendas.",
  "type": "meet",
  "color": "blue",
  "user": "idUser",
  "start_date": "2025-03-04T10:00:00Z",
  "finish_date": "2025-03-04T11:00:00Z",
  "person": "idPerson",
  "card": "idCard",
  "service": "idService",
  "organization": "idOrganization",
  "sector": "idSector",
  "checklist": [
    {
      "name": "Preparar apresentação",
      "done": false,
      "order": 1
    },
    {
      "name": "Confirmar disponibilidade do cliente",
      "done": true,
      "order": 2
    }
  ]
}
```

#### 🔍 **Formato dos IDs**

Os campos `person`, `card`, `service`, `organization`, `sector` e `user` devem conter IDs no seguinte formato:

```
674f6ee3debc8828cde11e3b
```

Para facilitar a leitura, no exemplo acima foram usados os placeholders `idPerson`, `idCard`, `idService`, `idOrganization`, `idSector` e `idUser`.

<figure><img src="https://1879311494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FECmgvOVqdfBdcZGxBZuP%2Fimage.png?alt=media&#x26;token=b739828b-d01a-4efc-933f-32410c3afde1" alt=""><figcaption></figcaption></figure>

✅ Após inserir o JSON corretamente, clique em **Salvar** para concluir a configuração.

***

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

#### 🎯 Cenário: Criar uma tarefa automaticamente para uma nova oportunidade de venda.

1️⃣ **Bloco 1** → Capturar um novo lead via formulário.\
2️⃣ **Bloco 2** → Criar uma nova tarefa no CRM para acompanhamento.\
3️⃣ **Bloco 3** → Definir o usuário responsável pela tarefa.

🚀 **Resultado:** Sempre que um novo lead for capturado, uma tarefa será criada automaticamente para acompanhamento.

### 🎉 **Conclusão**

A operação **Criar Tarefa** no Hablla Studio permite organizar e automatizar a gestão de atividades dentro do sistema. Você pode escolher entre configurar os campos manualmente ou utilizar um **JSON** personalizado para maior flexibilidade.

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