> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/hablla/organisations.md).

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/hablla/organisations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.