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