# Criar ou Atualizar

#### 🎯 **O que essa operação faz?**

Essa operação garante que os registros de cartões sejam gerenciados de forma eficiente, evitando duplicações e mantendo os dados sempre atualizados.

✅ **Se o cartão já existir** → Atualiza as informações do cartão com os novos dados.\
✅ **Se o cartão não existir** → Cria um novo cartão no sistema com os dados fornecidos.

A operação possibilita o preenchimento e atualização de informações como:\
✅ Nome do cartão\
✅ Descrição\
✅ Lista dentro do board\
✅ Usuário responsável\
✅ Tags associadas\
✅ Data de previsão de conclusão\
✅ Campos personalizados

***

### 📂 **Como Configurar a Operação "Criar ou Atualizar"**

#### 1️⃣ **Acesse o Componente**

1. No **Hablla Studio**, abra o fluxo de automação onde deseja criar ou atualizar um cartão.
2. Adicione o bloco de **Cartões**.
3. No **painel lateral direito**, selecione a operação **"Criar ou Atualizar"**.

***

#### 2️⃣ **Defina a Regra de Identificação**

Para determinar se um cartão já existe, o sistema pode utilizar um dos seguintes métodos:

🔹 **Filtrar por ID** → Usa um identificador único para encontrar o cartão no sistema.\
🔹 **Filtrar por Query** → Busca um cartão baseado em parâmetros específicos como nome, status ou tags.

***

#### 3️⃣ **Preencha os Campos Obrigatórios**

* **Workspace ID** → Identificador do workspace onde o cartão será criado ou atualizado.
* **Nome do Cartão** → Nome do cartão a ser criado ou atualizado.

Caso esteja usando **Filtro por ID**, é necessário informar:

* **Card ID** → Identificador único do cartão.

Caso esteja usando **Filtro por Query**, você pode definir:

* **Tags associadas**
* **Status do cartão**
* **Usuário responsável**

***

#### 4️⃣ **Escolha os Campos a Serem Atualizados (Opcional)**

Caso o cartão já exista, você pode configurar quais campos devem ser **modificados**:

🔹 **Nome do Cartão**\
🔹 **Descrição**\
🔹 **Board** e **Lista**\
🔹 **Responsável (Usuário)**\
🔹 **Tags**\
🔹 **Data de Previsão**\
🔹 **Seguidores**\
🔹 **Campos Personalizados**

Além disso, você pode definir a **regra de atualização**:\
🔸 **Mais Antigo** → Mantém os dados do primeiro registro encontrado.\
🔸 **Mais Recente** → Mantém os dados do último registro atualizado.

***

#### 5️⃣ **Salvar a Configuração**

Após preencher os campos desejados, clique no botão **"Salvar"** ✅.

Agora, sempre que essa automação for acionada, o sistema **criará um novo cartão ou atualizará um existente automaticamente**.

***

### 📌 **Exemplo de Uso no Fluxo de Automação**

📊 **Cenário**: Criar um fluxo onde um novo lead é registrado e associado a um cartão no board de **oportunidades**.

1️⃣ **Bloco 1** → Capturar um novo lead via formulário.\
2️⃣ **Bloco 2** → Verificar se um cartão com o mesmo nome já existe.\
3️⃣ **Bloco 3** → Se existir, atualizar as informações do lead no cartão.\
4️⃣ **Bloco 4** → Se não existir, criar um novo cartão automaticamente.

🚀 **Resultado**: O sistema **garante que não haja duplicações** e mantém o cartão sempre atualizado com as informações mais recentes do lead.

***

### 🎉 **Conclusão**

A operação **Criar ou Atualizar Cartão** no **Hablla Studio** é uma funcionalidade poderosa para manter um fluxo de trabalho organizado e evitar registros duplicados.

Se precisar de mais suporte, entre em contato com nossa equipe! 🚀


---

# Agent Instructions: 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:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/cartoes/criar-ou-atualizar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.