# Organizaciones

El componente **Organizaciones** permite gestionar los registros de empresas en el sistema, posibilitando **creación, actualización, eliminación y asociación de contactos** a una organización.

### 📂 **Operaciones Disponibles**

Aquí están las operaciones que se pueden realizar con este componente:

| Operación                                           | Descripción                                                                 |
| --------------------------------------------------- | --------------------------------------------------------------------------- |
| **Crear** (`crear`)                                 | Crea una nueva organización.                                                |
| **Actualizar** (`actualizar`)                       | Actualiza los datos de una organización existente.                          |
| **Crear o Actualizar** (`crear_o_actualizar`)       | Si la organización existe, actualiza; si no existe, crea un nuevo registro. |
| **Eliminar** (`eliminar`)                           | Elimina una organización del sistema.                                       |
| **Buscar todas** (`obtener_todas`)                  | Obtiene una lista de todas las organizaciones registradas.                  |
| **Buscar personas vinculadas** (`obtener_personas`) | Devuelve todas las personas asociadas a una organización.                   |
| **Agregar personas** (`agregar_personas`)           | Agrega una o más personas a una organización.                               |
| **Eliminar personas** (`eliminar_personas`)         | Elimina una o más personas de una organización.                             |

***

### 🎯 **Cómo Configurar una Operación**

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

* En **Hablla Studio**, abra el flujo de automatización donde desea incluir la acción.
* Agregue el bloque **"Organizaciones"**.
* En **panel lateral derecho**, configure la operación deseada.

***

### 📝 **Detalle de las Operaciones**

#### **1. Crear Organización**

💡 **¿Qué hace?**\
Esta operación permite crear un nuevo registro de organización en el sistema.

🔹 **Campos obligatorios:**

* **Nombre de la organización**
* **CNPJ (si aplica)**

🔹 **Campos opcionales:**

* **Acerca de** (Descripción de la organización)
* **Dirección**
* **Teléfonos**
* **Correos**
* **Propietario de la organización**
* **Etiquetas personalizadas**

✅ **Paso a paso:**

1. Elija la operación **"Crear"**.
2. Complete los campos obligatorios y opcionales.
3. Haga clic en **Guardar** ✅.

***

#### **2. Actualizar Organización**

💡 **¿Qué hace?**\
Actualiza la información de una organización existente.

🔹 **Campos obligatorios:**

* **ID de la organización** (puede recuperarse de otro paso de la automatización).

✅ **Paso a paso:**

1. Elija la operación **"Actualizar"**.
2. Ingrese el ID de la organización y los campos a modificar.
3. Haga clic en **Guardar** ✅.

***

#### **3. Crear o Actualizar Organización**

💡 **¿Qué hace?**\
Verifica si la organización ya existe:

* Si **existe**, **actualiza los datos**.
* Si **no existe**, **crea un nuevo registro**.

✅ **Paso a paso:**

1. Elija la operación **"Crear o Actualizar"**.
2. Complete los datos de la organización.
3. Defina la **regla de identificación**:
   * **Más antigua** (mantiene el primer registro).
   * **Más reciente** (mantiene el más actualizado).
4. Haga clic en **Guardar** ✅.

***

#### **4. Eliminar Organización**

💡 **¿Qué hace?**\
Elimina permanentemente una organización del sistema.

🔹 **Campos obligatorios:**

* **ID de la organización**

✅ **Paso a paso:**

1. Elija la operación **"Eliminar"**.
2. Indique el ID de la organización.
3. Confirme la acción y haga clic en **Guardar** ✅.

***

#### **5. Buscar Todas las Organizaciones**

💡 **¿Qué hace?**\
Recupera una lista de todas las organizaciones registradas.

🔹 **Filtros opcionales:**

* **Buscar por nombre**
* **CNPJ**
* **Estado (activo, inactivo, etc.)**
* **Etiquetas**
* **Usuario vinculado**

✅ **Paso a paso:**

1. Elija la operación **"Buscar Todas"**.
2. Aplique filtros, si es necesario.
3. Haga clic en **Guardar** ✅.

***

#### **6. Buscar Personas Vinculadas a una Organización**

💡 **¿Qué hace?**\
Obtiene la lista de personas asociadas a una organización.

🔹 **Campos obligatorios:**

* **ID de la organización**

✅ **Paso a paso:**

1. Elija la operación **"Buscar Personas"**.
2. Ingrese el ID de la organización.
3. Haga clic en **Guardar** ✅.

***

#### **7. Agregar Personas a una Organización**

💡 **¿Qué hace?**\
Vincula una o más personas a una organización.

🔹 **Campos obligatorios:**

* **ID de la organización**
* **IDs de las personas a agregar**

✅ **Paso a paso:**

1. Elija la operación **"Agregar Personas"**.
2. Ingrese el ID de la organización y los IDs de las personas.
3. Haga clic en **Guardar** ✅.

***

#### **8. Eliminar Personas de una Organización**

💡 **¿Qué hace?**\
Elimina una o más personas de una organización.

🔹 **Campos obligatorios:**

* **ID de la organización**
* **IDs de las personas a eliminar**

✅ **Paso a paso:**

1. Elija la operación **"Eliminar Personas"**.
2. Ingrese el ID de la organización y los IDs de las personas.
3. Haga clic en **Guardar** ✅.

***

### ⚙️ **Filtros y Personalizaciones**

Además de las operaciones básicas, puede aplicar **filtros** y **agregar campos personalizados**:

✅ **Filtros disponibles para búsqueda:**

* **Nombre**
* **CNPJ**
* **Estado**
* **Etiquetas**
* **Propietario de la organización**
* **Campos personalizados**

✅ **Campos personalizables:**

* **Correos**
* **Direcciones**
* **Teléfonos**
* **Etiquetas**
* **Usuarios responsables**

***

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

📌 **Escenario:** ¿Desea crear un flujo donde se registra un nuevo lead y se vincula automáticamente a una organización?

1. **Bloque 1** → Crear un nuevo **Lead**.
2. **Bloque 2** → Buscar la organización por **CNPJ**.
3. **Bloque 3** → Si la organización existe, **agregar a la persona**.
4. **Bloque 4** → Si la organización no existe, **crear automáticamente**.

Resultado: 📊 **¡La organización estará siempre actualizada y asociada a los leads correctos!**

***

### 📌 **Conclusión**

El componente **Organizaciones** permite **crear, gestionar y asociar contactos a empresas** dentro de Hablla Studio. Con las automatizaciones correctas, puede **optimizar la segmentación y garantizar un flujo de ventas eficiente**.

Si necesitas más soporte, ¡contacta con nuestro equipo! 🚀


---

# 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/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/organizaciones.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.