# Agregar Etiquetas

La operación Agregar Etiquetas permite aplicar una o más etiquetas (tags) a un registro de persona. Las etiquetas son marcadores flexibles que ayudan a categorizar, segmentar y filtrar tus contactos en función de intereses, comportamientos, origen o cualquier otro criterio personalizado.

Esta acción es extremadamente útil para enriquecer el perfil de un contacto de forma dinámica. Por ejemplo, puedes agregar una etiqueta "Interés-Producto-X" cuando un lead visita una página específica, o "Cliente-Satisfecho" tras una evaluación positiva.

La operación agrega las nuevas etiquetas a la lista de etiquetas de la persona, manteniendo las que ya existían.

#### Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.
2. En el campo "Operación", selecciona la opción "Agregar Etiquetas".
3. En el campo "ID de la Persona" (`personId`), ingresa el identificador del contacto que recibirá las etiquetas.
4. En el campo "Etiquetas", selecciona o ingresa las etiquetas que deseas aplicar.

### Parámetros

| Campo            | Tipo               | ¿Obligatorio? | Descripción                                               |
| ---------------- | ------------------ | ------------- | --------------------------------------------------------- |
| ID de la Persona | Texto              | ✅ Sí          | El ID único de la persona (contacto) que será etiquetada. |
| Etiquetas        | Lista de Etiquetas | ✅ Sí          | Una o más etiquetas que se agregarán al contacto.         |

### Estructura (Usando JSON)

El cuerpo de la solicitud JSON debe contener un array llamado `etiquetas` con el/los ID(s) o nombre(s) de la(s) etiqueta(s) que se van a agregar.

JSON

```
{
  "etiquetas": [
    "etiqueta_id_o_nombre_1",
    "etiqueta_id_o_nombre_2"
  ]
}
```

***

### 🚀 Ejemplo de Caso de Uso

Objetivo: Cuando un lead descarga un e-book sobre "Marketing Digital", agregar la etiqueta "Interés-Marketing" a su perfil.

1. Crea un flujo que comience con un disparador de Webhook que reciba los datos del formulario de descarga del e-book (incluyendo el correo electrónico del lead).
2. Use la operación "Buscar Persona por Correo Electrónico" para encontrar el `personId` del lead.
3. Si se encuentra a la persona, añade el bloque "Personas" con la operación "Agregar Etiquetas".
4. En el campo "ID de la Persona", inserte la variable del ID encontrada en el paso anterior (`{{steps.2.result.id}}`).
5. En el campo "Etiquetas", selecciona la etiqueta "Interés-Marketing".

Con esta automatización, segmentas tus contactos en función de sus intereses de forma automática, permitiendo el envío de campañas de nutrición futuras mucho más dirigidas y eficaces.