# Organizações

O componente **Organizações** permite gerenciar os registros de empresas no sistema, possibilitando **criação, atualização, remoção e associação de contatos** a uma organização.

### 📂 **Operações Disponíveis**

Aqui estão as operações que podem ser realizadas com este componente:

| Operação                                      | Descrição                                                                  |
| --------------------------------------------- | -------------------------------------------------------------------------- |
| **Criar** (`create`)                          | Cria uma nova organização.                                                 |
| **Atualizar** (`update`)                      | Atualiza os dados de uma organização existente.                            |
| **Criar ou Atualizar** (`create_or_update`)   | Se a organização existir, atualiza; se não existir, cria um novo registro. |
| **Deletar** (`delete`)                        | Remove uma organização do sistema.                                         |
| **Buscar todas** (`get_all`)                  | Obtém uma lista de todas as organizações cadastradas.                      |
| **Buscar pessoas vinculadas** (`get_persons`) | Retorna todas as pessoas associadas a uma organização.                     |
| **Adicionar pessoas** (`add_persons`)         | Adiciona uma ou mais pessoas a uma organização.                            |
| **Remover pessoas** (`remove_persons`)        | Remove uma ou mais pessoas de uma organização.                             |

***

### 🎯 **Como Configurar uma Operação**

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

* No **Hablla Studio**, abra o fluxo de automação onde deseja incluir a ação.
* Adicione o bloco **"Organizações"**.
* No **painel lateral direito**, configure a operação desejada.

***

### 📝 **Detalhamento das Operações**

#### **1. Criar Organização**

💡 **O que faz?**\
Essa operação permite criar um novo registro de organização no sistema.

🔹 **Campos obrigatórios:**

* **Nome da organização**
* **CNPJ (se aplicável)**

🔹 **Campos opcionais:**

* **Sobre** (Descrição da organização)
* **Endereço**
* **Telefones**
* **E-mails**
* **Dono da organização**
* **Tags personalizadas**

✅ **Passo a passo:**

1. Escolha a operação **"Criar"**.
2. Preencha os campos obrigatórios e opcionais.
3. Clique em **Salvar** ✅.

***

#### **2. Atualizar Organização**

💡 **O que faz?**\
Atualiza as informações de uma organização existente.

🔹 **Campos obrigatórios:**

* **ID da organização** (pode ser recuperado de outra etapa da automação).

✅ **Passo a passo:**

1. Escolha a operação **"Atualizar"**.
2. Insira o ID da organização e os campos a serem alterados.
3. Clique em **Salvar** ✅.

***

#### **3. Criar ou Atualizar Organização**

💡 **O que faz?**\
Verifica se a organização já existe:

* Se **existir**, **atualiza os dados**.
* Se **não existir**, **cria um novo registro**.

✅ **Passo a passo:**

1. Escolha a operação **"Criar ou Atualizar"**.
2. Preencha os dados da organização.
3. Defina a **regra de identificação**:
   * **Mais antiga** (mantém o primeiro registro).
   * **Mais recente** (mantém o mais atualizado).
4. Clique em **Salvar** ✅.

***

#### **4. Deletar Organização**

💡 **O que faz?**\
Remove permanentemente uma organização do sistema.

🔹 **Campos obrigatórios:**

* **ID da organização**

✅ **Passo a passo:**

1. Escolha a operação **"Deletar"**.
2. Informe o ID da organização.
3. Confirme a ação e clique em **Salvar** ✅.

***

#### **5. Buscar Todas as Organizações**

💡 **O que faz?**\
Recupera uma lista de todas as organizações cadastradas.

🔹 **Filtros opcionais:**

* **Busca por nome**
* **CNPJ**
* **Status (ativo, inativo, etc.)**
* **Tags**
* **Usuário vinculado**

✅ **Passo a passo:**

1. Escolha a operação **"Buscar Todas"**.
2. Aplique filtros, se necessário.
3. Clique em **Salvar** ✅.

***

#### **6. Buscar Pessoas Vinculadas a uma Organização**

💡 **O que faz?**\
Obtém a lista de pessoas associadas a uma organização.

🔹 **Campos obrigatórios:**

* **ID da organização**

✅ **Passo a passo:**

1. Escolha a operação **"Buscar Pessoas"**.
2. Insira o ID da organização.
3. Clique em **Salvar** ✅.

***

#### **7. Adicionar Pessoas a uma Organização**

💡 **O que faz?**\
Vincula uma ou mais pessoas a uma organização.

🔹 **Campos obrigatórios:**

* **ID da organização**
* **IDs das pessoas a serem adicionadas**

✅ **Passo a passo:**

1. Escolha a operação **"Adicionar Pessoas"**.
2. Insira o ID da organização e os IDs das pessoas.
3. Clique em **Salvar** ✅.

***

#### **8. Remover Pessoas de uma Organização**

💡 **O que faz?**\
Remove uma ou mais pessoas de uma organização.

🔹 **Campos obrigatórios:**

* **ID da organização**
* **IDs das pessoas a serem removidas**

✅ **Passo a passo:**

1. Escolha a operação **"Remover Pessoas"**.
2. Insira o ID da organização e os IDs das pessoas.
3. Clique em **Salvar** ✅.

***

### ⚙️ **Filtros e Personalizações**

Além das operações básicas, você pode aplicar **filtros** e **adicionar campos personalizados**:

✅ **Filtros disponíveis para busca:**

* **Nome**
* **CNPJ**
* **Status**
* **Tags**
* **Dono da organização**
* **Campos personalizados**

✅ **Campos personalizáveis:**

* **E-mails**
* **Endereços**
* **Telefones**
* **Tags**
* **Usuários responsáveis**

***

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

📌 **Cenário:** Você deseja criar um fluxo onde um novo lead é cadastrado e automaticamente vinculado a uma organização.

1. **Bloco 1** → Criar um novo **Lead**.
2. **Bloco 2** → Buscar a organização pelo **CNPJ**.
3. **Bloco 3** → Se a organização existir, **adicionar a pessoa**.
4. **Bloco 4** → Se a organização não existir, **criá-la automaticamente**.

Resultado: 📊 **A organização estará sempre atualizada e associada aos leads certos!**

***

### 📌 **Conclusão**

O componente **Organizações** permite **criar, gerenciar e associar contatos a empresas** dentro do Hablla Studio. Com as automações corretas, você pode **otimizar a segmentação e garantir um fluxo de vendas eficiente**.

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