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

# Actualizar

La operación **Actualizar Tarea** permite modificar una tarea existente en el sistema, garantizando que toda la información relevante se actualice según sea necesario.

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

Esta operación actualiza una tarea ya existente dentro de un workspace, posibilitando la modificación de información como:

* ✅ Nombre de la tarea
* ✅ Descripción detallada
* ✅ Tipo de tarea (llamada, reunión, correo electrónico, chat, otro)
* ✅ Usuario responsable
* ✅ Fecha de inicio y finalización
* ✅ Asociación con personas, tarjetas, organizaciones y servicios
* ✅ Checklist de tareas

### 📂 **Cómo Configurar la Operación "Actualizar"**

1️⃣ **Accede al Componente**

En Hablla Studio, abre el flujo de automatización donde deseas actualizar una tarea.

2️⃣ **Agrega el Bloque "Tareas"**

En el panel lateral derecho, selecciona la operación **Actualizar**.

3️⃣ **Elige la Forma de Especificar el Cuerpo**

Puedes especificar los datos de la tarea **Usando 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á actualizando.                                                                                                       |
| **Acerca de**                 | `string`        | ❌ No        | Información adicional sobre la tarea.                                                                                                                       |
| **Descripción**               | `string`        | ✅ Sí        | Descripción detallada de la tarea.                                                                                                                          |
| **Tipo de Tarea**             | `string (enum)` | ✅ Sí        | Especifica el tipo de tarea: llamada, reunión, correo, chat u otro.                                                                                         |
| **Fecha de Inicio**           | `datetime`      | ❌ No        | Fecha y hora de inicio de la tarea.                                                                                                                         |
| **Fecha de Finalización**     | `datetime`      | ❌ No        | 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.

### 🔹 **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`.

✅ 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:** Actualizar una tarea automáticamente tras la finalización de una etapa en el proceso de ventas.

1️⃣ **Bloque 1** → Capturar la finalización de una etapa en el pipeline de ventas.

2️⃣ **Bloque 2** → Actualizar la tarea correspondiente en el CRM con la nueva información.

3️⃣ **Bloque 3** → Notificar al usuario responsable sobre la actualización de la tarea.

🚀 **Resultado:** Siempre que una etapa del proceso de ventas se complete, la tarea correspondiente se actualizará automáticamente en el sistema, garantizando que toda la información esté sincronizada.

### 🎉 **Conclusión**

La operación **Actualizar Tarea** en Hablla Studio permite mantener las actividades organizadas y actualizadas 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
