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

# Crear o actualizar

La operación Crear o Actualizar Tarjeta (create\_or\_update) permite verificar si una tarjeta ya existe en el sistema. Si se encuentra la tarjeta, sus datos se actualizan. Si no existe, se

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

Esta operación garantiza que los registros de tarjetas se gestionen de forma eficiente, evitando duplicados y manteniendo los datos siempre actualizados.

✅ **Si la tarjeta ya existe** → Actualiza la información de la tarjeta con los nuevos datos.\
✅ **Si la tarjeta no existe** → Crea una nueva tarjeta en el sistema con los datos proporcionados.

La operación posibilita el llenado y la actualización de información como:\
✅ Nombre de la tarjeta\
✅ Descripción\
✅ Lista dentro del tablero\
✅ Usuario responsable\
✅ Etiquetas asociadas\
✅ Fecha prevista de finalización\
✅ Campos personalizados

***

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

#### 1️⃣ **Accede al Componente**

1. En **Hablla Studio**, abra el flujo de automatización donde desea crear o actualizar una tarjeta.
2. Agrega el bloque de **Tarjetas**.
3. En **panel lateral derecho**, selecciona la operación **"Crear o Actualizar"**.

***

#### 2️⃣ **Defina la Regla de Identificación**

Para determinar si una tarjeta ya existe, el sistema puede utilizar uno de los siguientes métodos:

🔹 **Filtrar por ID** → Usa un identificador único para encontrar la tarjeta en el sistema.\
🔹 **Filtrar por Query** → Busca una tarjeta basada en parámetros específicos como nombre, estado o etiquetas.

***

#### 3️⃣ **Completa los campos obligatorios**

* **Workspace ID** → Identificador del espacio de trabajo donde la tarjeta será creada o actualizada.
* **Nombre de la Tarjeta** → Nombre de la tarjeta que se creará o actualizará.

En caso de estar usando **Filtro por ID**, es necesario informar:

* **Card ID** → Identificador único de la tarjeta.

En caso de estar usando **Filtro por Query**, usted puede definir:

* **Etiquetas asociadas**
* **Estado de la tarjeta**
* **Usuario responsable**

***

#### 4️⃣ **Elija los Campos a Actualizar (Opcional)**

Si la tarjeta ya existe, puede configurar qué campos deben ser **modificados**:

🔹 **Nombre de la Tarjeta**\
🔹 **Descripción**\
🔹 **Tablero** y **Lista**\
🔹 **Responsable (Usuario)**\
🔹 **Etiquetas**\
🔹 **Fecha Prevista**\
🔹 **Seguidores**\
🔹 **Campos Personalizados**

Además, puede definir la **regla de actualización**:\
🔸 **Más Antiguo** → Mantiene los datos del primer registro encontrado.\
🔸 **Más Reciente** → Mantiene los datos del último registro actualizado.

***

#### 5️⃣ **Guardar la configuración**

Después de completar los campos deseados, haga clic en el botón **"Guardar"** ✅.

Ahora, cada vez que se active esta automatización, el sistema **creará una nueva tarjeta o actualizará una existente automáticamente**.

***

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

📊 **Escenario**: Crear un flujo donde se registre un nuevo lead y se asocie a una tarjeta en el tablero de **oportunidades**.

1️⃣ **Bloque 1** → Capturar un nuevo lead mediante formulario.\
2️⃣ **Bloque 2** → Verificar si ya existe una tarjeta con el mismo nombre.\
3️⃣ **Bloque 3** → Si existe, actualizar la información del lead en la tarjeta.\
4️⃣ **Bloque 4** → Si no existe, crear una nueva tarjeta automáticamente.

🚀 **Resultado**: El sistema **garantiza que no haya duplicaciones** y mantiene la tarjeta siempre actualizada con la información más reciente del lead.

***

### 🎉 **Conclusión**

La operación **Crear o Actualizar Tarjeta** en el **Hablla Studio** es una funcionalidad poderosa para mantener un flujo de trabajo organizado y evitar registros duplicados.

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/tarjetas/crear-o-actualizar.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.