# Applications Intégrées dans Agency Handy

La fonctionnalité **Applications Intégrées** permet aux **Superadmins** et **Admins** d’intégrer des outils externes (Google Docs, Figma, Notion, YouTube, etc.) **directement dans l’interface de Agency Handy**. Cela favorise un meilleur flux de travail, une collaboration fluide et un contrôle d'accès efficace — sans quitter la plateforme.

***

#### 🎯 Objectifs

✅ Éviter les allers-retours entre plusieurs plateformes.\
✅ Collaborer en temps réel sur des outils tiers.\
✅ Contrôler l’accès aux outils selon le rôle de l’utilisateur.\
✅ Centraliser tous les outils importants (documents, designs, plannings, etc.) pour l’équipe et les clients au sein d’Agency Handy.

***

#### 🧾 Fonctionnalités

Les utilisateurs peuvent :

* Intégrer des applications via **iframe** ou **lien URL**.
* Partager des apps avec les membres de l’équipe ou des clients.
* Définir **qui peut voir quoi** avec des autorisations de visibilité précises.
* **Personnaliser l’accès depuis la barre latérale** pour un lancement rapide.
* Modifier ou supprimer les applications à tout moment.

***

#### 🧑‍💼 Conditions préalables

* **Seuls les Superadmins et Admins** peuvent créer, éditer ou supprimer des applications intégrées.
* Tous les utilisateurs doivent avoir un rôle actif (Admin, PM, Assigné, Client).
* L’URL intégrée doit être compatible avec un **iframe** ou un lien externe.
* Les icônes doivent être dans un format pris en charge (SVG, PNG, JPG).
* Les **clients** peuvent uniquement voir les apps partagées dans leur barre latérale (vue canvas).
* Les barres latérales sont **personnalisées par utilisateur**.

***

#### 🗺️ Parcours Utilisateur

1. Le Superadmin/Admin ajoute une application.
2. Choisit une icône.
3. Ajoute une URL ou un iframe.
4. Définit la visibilité.
5. Active le raccourci dans la barre latérale.
6. Sauvegarde.

👉 Les autres Admins et membres de l’équipe voient les apps partagées selon les permissions.\
👉 Les clients ne voient que les apps qui leur sont attribuées.

***

#### 📚 Guide Étape par Étape

**Étape 1 : Ajouter une nouvelle application**

1. **Aller dans Applications Intégrées**\
   Depuis l’interface principale, cliquez sur **"Applications intégrées"**.
2. **Ajouter une nouvelle app**\
   Cliquez sur **"Ajouter"**.
3. **Renseigner les détails**

* **Titre** : Donnez un nom clair à l’application (ex. : "Tableau de bord projet").
* **Type d’affichage** :
  * **URL** : Affiche l’app dans une nouvelle fenêtre intégrée si l’URL est partageable.
  * **Iframe** : Affiche l’app directement dans l’interface.
* **URL de contenu** : Collez l’URL de l’outil à intégrer.

📌 **Google Drive** (iframe uniquement) :

* Le dossier doit être visible par "Toute personne disposant du lien".
* Convertir l’URL :
  * De : `https://drive.google.com/drive/folders/ID?usp=sharing`
  * Vers : `https://drive.google.com/embeddedfolderview?id=ID`

📌 **YouTube** (URL uniquement) :

* Convertir l’URL :
  * De : `https://www.youtube.com/watch?v=VIDEO_ID`
  * Vers : `https://www.youtube.com/embed/VIDEO_ID`

***

**Étape 2 : Définir la visibilité**

* **Équipe** : Sélectionnez "Tous les membres" ou des utilisateurs spécifiques.\
  Les rôles apparaissent (PM, Assigné, etc.).
* **Clients** : Sélectionnez "Tous les clients" ou des clients spécifiques.\
  ⚠️ Les apps client apparaissent uniquement dans **leur barre latérale**.

***

**Étape 3 : Activer dans votre barre latérale (optionnel)**

* Activez **"Afficher dans ma barre latérale"** pour un accès rapide.\
  ⚠️ Cette option est **personnelle** et ne s’applique qu’à votre compte.

***

**Étape 4 : Sauvegarder**

* Cliquez sur **"Sauvegarder"**.
* L’application s’affichera dans son onglet correspondant (ex. : tous les Google Docs ensemble).

***

#### 👥 Vue par rôle utilisateur

**👑 Superadmin/Admin**

* Voit **toutes les apps intégrées** (les siennes et celles des autres).
* Onglets groupés par type (Figma, Airtable, etc.).
* Peut :
  * Afficher les apps.
  * Les épingler à la barre latérale.
  * Voir les utilisateurs avec qui elles sont partagées.
  * **Modifier ou supprimer** via le menu (⋮).

**🧑‍💼 Membres de l’équipe (PMs, Assignés)**

* Voient uniquement les apps partagées avec eux.
* Peuvent épingler ou retirer de leur propre barre latérale.
* Lecture seule — **aucune option de modification**.

**👤 Clients**

* Voient **uniquement les apps partagées avec eux**.
* Accès via leur **barre latérale (canvas)**.
* Lecture seule — **aucune option de modification ou d’épinglement**.

***

#### 🔍 Filtres & Tri

* **Recherche par Titre**
* **Filtrer par Visibilité** :
  * Partagé avec tous les membres
  * Partagé avec des membres spécifiques
  * Partagé avec tous les clients
  * Partagé avec des clients spécifiques
* **Trier par** :
  * Plus ancien en premier (**par défaut**)

***

#### ⚠️ Remarques Importantes

* ✅ Aucun **limite** sur le nombre d'apps intégrées.
* ✅ Clients et membres de l’équipe ne peuvent **pas gérer** les apps, uniquement les consulter.
* ✅ Les apps sont accessibles par tous les utilisateurs concernés, même si elles ont été ajoutées par un seul Admin.
* ✅ Les icônes apparaissent uniquement dans la **vue secondaire** et dans la **barre latérale**.
* ✅ Une URL ou iframe invalide affichera une **erreur**.
* ✅ Une app supprimée est **supprimée pour tous**.
* ✅ Les raccourcis de barre latérale sont **personnels** à chaque utilisateur.
* ✅ Les **logs d’audit** enregistrent qui a ajouté, modifié ou supprimé une application et à quel moment.


---

# 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.agencyhandy.com/french/guide-dutilisation-dagencyhandy-pour-les-agences/applications-integrees-dans-agency-handy.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.