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