> 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/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/tareas/crear.md).

# Crear

La operación Crear Tarea permite agregar una nueva tarea al sistema, garantizando que toda la información necesaria esté registrada correctamente.

### 🎯 ¿Qué hace esta operación?

Esta operación crea una nueva tarea dentro de un workspace, permitiendo completar información como:&#x20;

✅ Nombre de la tarea\
✅ Descripción detallada\
✅ Tipo de tarea (llamada, reunión, correo electrónico, etc.)\
✅ Usuario responsable\
✅ Fecha de inicio y finalización\
✅ Asociación con personas, tarjetas, organizaciones y servicios\
✅ Lista de verificación de tareas

### 📂 Cómo configurar la operación "Crear"

1️⃣ **Accede al Componente**\
En **Hablla Studio**, abre el flujo de automatización donde deseas crear una tarea.

2️⃣ **Agrega el Bloque "Tareas"**\
En el panel lateral derecho, selecciona la operación **Crear**.

3️⃣ **Elige la Forma de Especificar el Cuerpo**\
Puedes especificar los datos de la tarea U**sando Campos** o **Usando JSON**.

### 🔹 **Especificar Cuerpo: Usando Campos**

Si la opción **Usando Campos** está seleccionada, los siguientes campos pueden completarse:

| Campo                         | Tipo            | Obligatorio | Descripción                                                                                                                                                 |
| ----------------------------- | --------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nombre de la Tarea**        | `string`        | ✅ Sí        | Nombre o título de la tarea que se está creando.                                                                                                            |
| **Acerca de**                 | `string`        | ✅ Sí        | Información detallada de la tarea.                                                                                                                          |
| **Descripción**               | `string`        | ✅ Sí        | Descripción detallada de la tarea.                                                                                                                          |
| **Tipo de Tarea**             | `string (enum)` | ✅ Sí        | Especifica el tipo de tarea, como llamada, reunión, correo electrónico, etc.                                                                                |
| **Fecha de Inicio**           | `datetime`      | ✅ Sí        | Fecha y hora de inicio de la tarea.                                                                                                                         |
| **Fecha de Finalización**     | `datetime`      | ✅ Sí        | Fecha y hora previstas para la finalización de la tarea.                                                                                                    |
| **Usuario Responsable**       | `string`        | ❌ No        | ID del usuario responsable de la ejecución de la tarea.                                                                                                     |
| **ID de la Persona Asociada** | `string`        | ❌ No        | ID de la persona relacionada con la tarea.                                                                                                                  |
| **ID de la Organización**     | `string`        | ❌ No        | ID de la organización relacionada con la tarea.                                                                                                             |
| **ID de la Tarjeta Asociada** | `string`        | ❌ No        | ID de la tarjeta (card) a la que la tarea está vinculada.                                                                                                   |
| **Sector**                    | `string`        | ❌ No        | Sector o departamento relacionado con la tarea.                                                                                                             |
| **Checklist**                 | `array`         | ❌ No        | Lista de elementos a verificar o completar dentro de la tarea. Cada elemento del array debe seguir la estructura: `{ "item": "Descripción del elemento" }`. |

✅ Después de completar los campos, haz clic en **Guardar** para concluir la configuración.

<figure><img src="https://4006966930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FaDIKVesTS6E7xIDO3nXd%2Fimage.png?alt=media&amp;token=252b40db-a13b-4481-b053-1c9bd9b0cc93" alt=""><figcaption><p>Tarea de llamada para dentro de 20 minutos con 20 minutos de duración</p></figcaption></figure>

### 🔹 **Especificar Cuerpo: Usando JSON**

Si la opción **Usando JSON** está seleccionada, utiliza el siguiente formato para enviar los datos de la tarea:

```json
{
  "name": "Reunión con cliente",
  "description": "Discutir propuesta comercial y alinear los próximos pasos.",
  "about": "Esta tarea forma parte del pipeline de ventas.",
  "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 presentación",
      "done": false,
      "order": 1
    },
    {
      "name": "Confirmar disponibilidad del cliente",
      "done": true,
      "order": 2
    }
  ]
}
```

#### 🔍 **Formato de los IDs**

Los campos `person`, `card`, `service`, `organization`, `sector` y `user` deben contener IDs en el siguiente formato:

```
674f6ee3debc8828cde11e3b
```

Para facilitar la lectura, en el ejemplo anterior se usaron los marcadores de posición `idPerson`, `idCard`, `idService`, `idOrganization`, `idSector` y `idUser`.

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

✅ Después de insertar el JSON correctamente, haz clic en **Guardar** para concluir la configuración.

***

### 📌 **Ejemplo de uso en el flujo de automatización**

#### 🎯 Escenario: Crear una tarea automáticamente para una nueva oportunidad de venta.

1️⃣ **Bloque 1** → Capturar un nuevo lead mediante formulario.\
2️⃣ **Bloque 2** → Crear una nueva tarea en el CRM para seguimiento.\
3️⃣ **Bloque 3** → Definir el usuario responsable de la tarea.

🚀 **Resultado:** Cada vez que se capture un nuevo lead, se creará automáticamente una tarea para el seguimiento.

### 🎉 **Conclusión**

La operación **Crear Tarea** en Hablla Studio permite organizar y automatizar la gestión de actividades dentro del sistema. Puedes elegir entre configurar los campos manualmente o utilizar un **JSON** personalizado para mayor flexibilidad.

Si necesitas más soporte, ¡contacta con nuestro equipo! 🚀


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/tareas/crear.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
