# Organisations

Le composant **Organisations** permet de gérer les enregistrements d'entreprises dans le système, en permettant **la création, la mise à jour, la suppression et l'association de contacts** à une organisation.

### 📂 **Opérations disponibles**

Voici les opérations qui peuvent être effectuées avec ce composant :

| Opération                                                | Description                                                                  |
| -------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Créer** (`créer`)                                      | Crée une nouvelle organisation.                                              |
| **Mettre à jour** (`mettre à jour`)                      | Met à jour les données d'une organisation existante.                         |
| **Créer ou Mettre à jour** (`créer_ou_mettre_à_jour`)    | Si l'organisation existe, met à jour ; sinon, crée un nouvel enregistrement. |
| **Supprimer** (`supprimer`)                              | Retire une organisation du système.                                          |
| **Rechercher toutes** (`obtenir_toutes`)                 | Obtient une liste de toutes les organisations enregistrées.                  |
| **Rechercher les personnes liées** (`obtenir_personnes`) | Retourne toutes les personnes associées à une organisation.                  |
| **Ajouter des personnes** (`ajouter_personnes`)          | Ajoute une ou plusieurs personnes à une organisation.                        |
| **Retirer des personnes** (`retirer_personnes`)          | Retire une ou plusieurs personnes d'une organisation.                        |

***

### 🎯 **Comment configurer une opération**

#### 1️⃣ **Accédez au composant**

* Dans **Hablla Studio**, ouvrez le flux d'automatisation où vous souhaitez inclure l'action.
* Ajoutez le bloc **"Organisations"**.
* Dans **panneau latéral droit**, configurez l'opération souhaitée.

***

### 📝 **Détail des opérations**

#### **1. Créer une Organisation**

💡 **Que fait-elle ?**\
Cette opération permet de créer un nouvel enregistrement d'organisation dans le système.

🔹 **Champs obligatoires :**

* **Nom de l'organisation**
* **CNPJ (si applicable)**

🔹 **Champs optionnels :**

* **À propos** (Description de l'organisation)
* **Adresse**
* **Téléphones**
* **E-mails**
* **Propriétaire de l'organisation**
* **Tags personnalisés**

✅ **Étape par étape :**

1. Choisissez l'opération **"Créer"**.
2. Remplissez les champs obligatoires et optionnels.
3. Cliquez sur **Enregistrer** ✅.

***

#### **2. Mettre à jour l'Organisation**

💡 **Que fait-elle ?**\
Met à jour les informations d'une organisation existante.

🔹 **Champs obligatoires :**

* **ID de l'organisation** (peut être récupéré d'une autre étape de l'automatisation).

✅ **Étape par étape :**

1. Choisissez l'opération **"Mettre à jour"**.
2. Saisissez l'ID de l'organisation et les champs à modifier.
3. Cliquez sur **Enregistrer** ✅.

***

#### **3. Créer ou Mettre à jour l'Organisation**

💡 **Que fait-elle ?**\
Vérifie si l'organisation existe déjà :

* Si **existe**, **met à jour les données**.
* Si **n'existe pas**, **crée un nouvel enregistrement**.

✅ **Étape par étape :**

1. Choisissez l'opération **"Créer ou Mettre à Jour"**.
2. Remplissez les données de l'organisation.
3. Définissez la **règle d'identification**:
   * **Le plus ancien** (conserve le premier enregistrement).
   * **Le plus récent** (conserve le plus récent).
4. Cliquez sur **Enregistrer** ✅.

***

#### **4. Supprimer l'Organisation**

💡 **Que fait-elle ?**\
Supprime définitivement une organisation du système.

🔹 **Champs obligatoires :**

* **ID de l'organisation**

✅ **Étape par étape :**

1. Choisissez l'opération **"Supprimer"**.
2. Indiquez l'ID de l'organisation.
3. Confirmez l'action et cliquez sur **Enregistrer** ✅.

***

#### **5. Rechercher Toutes les Organisations**

💡 **Que fait-elle ?**\
Récupère une liste de toutes les organisations enregistrées.

🔹 **Filtres optionnels :**

* **Recherche par nom**
* **CNPJ**
* **Statut (actif, inactif, etc.)**
* **Tags**
* **Utilisateur lié**

✅ **Étape par étape :**

1. Choisissez l'opération **« Rechercher toutes »**.
2. Appliquez des filtres, si nécessaire.
3. Cliquez sur **Enregistrer** ✅.

***

#### **6. Rechercher les Personnes Liées à une Organisation**

💡 **Que fait-elle ?**\
Obtient la liste des personnes associées à une organisation.

🔹 **Champs obligatoires :**

* **ID de l'organisation**

✅ **Étape par étape :**

1. Choisissez l'opération **"Rechercher des Personnes"**.
2. Saisissez l'ID de l'organisation.
3. Cliquez sur **Enregistrer** ✅.

***

#### **7. Ajouter des Personnes à une Organisation**

💡 **Que fait-elle ?**\
Lie une ou plusieurs personnes à une organisation.

🔹 **Champs obligatoires :**

* **ID de l'organisation**
* **IDs des personnes à ajouter**

✅ **Étape par étape :**

1. Choisissez l'opération **"Ajouter des Personnes"**.
2. Saisissez l'ID de l'organisation et les IDs des personnes.
3. Cliquez sur **Enregistrer** ✅.

***

#### **8. Retirer des Personnes d'une Organisation**

💡 **Que fait-elle ?**\
Retire une ou plusieurs personnes d'une organisation.

🔹 **Champs obligatoires :**

* **ID de l'organisation**
* **IDs des personnes à retirer**

✅ **Étape par étape :**

1. Choisissez l'opération **"Supprimer des personnes"**.
2. Saisissez l'ID de l'organisation et les IDs des personnes.
3. Cliquez sur **Enregistrer** ✅.

***

### ⚙️ **Filtres et Personnalisations**

En plus des opérations de base, vous pouvez appliquer **filtres** et **ajouter des champs personnalisés**:

✅ **Filtres disponibles pour la recherche :**

* **Nom**
* **CNPJ**
* **Statut**
* **Tags**
* **Propriétaire de l'organisation**
* **Champs personnalisés**

✅ **Champs personnalisables :**

* **E-mails**
* **Adresses**
* **Téléphones**
* **Tags**
* **Utilisateurs responsables**

***

### 🚀 **Exemple d'utilisation dans le flux d'automatisation**

📌 **Scénario :** Voulez-vous créer un flux où un nouveau lead est enregistré et automatiquement lié à une organisation ?

1. **Bloc 1** → Créer un nouveau **Lead**.
2. **Bloc 2** → Rechercher l'organisation par **CNPJ**.
3. **Bloc 3** → Si l'organisation existe, **ajouter la personne**.
4. **Bloc 4** → Si l'organisation n'existe pas, **la créer automatiquement**.

Résultat : 📊 **L'organisation sera toujours à jour et associée aux bons leads !**

***

### 📌 **Conclusion**

Le composant **Organisations** permet de **créer, gérer et associer des contacts aux entreprises** dans Hablla Studio. Avec les automatisations appropriées, vous pouvez **optimiser la segmentation et garantir un flux de vente efficace**.

Si vous avez besoin de plus d'assistance, contactez notre équipe ! 🚀