> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gérer les rôles

> Contrôlez les accès et les permissions des utilisateurs grâce aux rôles système et personnalisés.

Les rôles définissent ce que les utilisateurs peuvent faire dans Qwoty — quels objets ils peuvent lire, modifier ou supprimer, quels paramètres ils peuvent gérer, et quelles actions au niveau de l'application ils peuvent effectuer. Vous attribuez un rôle à chaque utilisateur pour contrôler ses permissions sur l'ensemble de la plateforme.

<Note>
  Vous devez disposer du rôle **Admin** pour afficher, créer ou modifier des rôles.
</Note>

## Rôles système

Qwoty propose quatre rôles système prédéfinis couvrant les niveaux de permission les plus courants. Vous ne pouvez pas modifier ni supprimer les rôles système.

* **Admin** — Accès complet à tous les espaces de travail, paramètres et configurations. Peut gérer les utilisateurs, les rôles, les modèles, les catalogues et toutes les fonctionnalités système.
* **Manager** — Accès à l'intégralité de l'espace de travail. Peut approuver les devis, consulter les rapports et gérer les activités de l'équipe.
* **Sales Rep** — Peut créer et gérer les devis, les clients et les Dealrooms. Aucun accès aux paramètres système ni aux rapports à l'échelle de l'équipe.
* **Viewer** — Accès en lecture seule. Peut consulter les devis et les données, mais ne peut rien créer ni modifier.

<Info>
  Le nom API de **Sales Rep** est `Sale` pour des raisons de compatibilité ascendante avec les versions antérieures.
</Info>

## Rôles personnalisés

Vous pouvez créer des rôles personnalisés pour définir des permissions granulaires adaptées aux besoins de votre organisation. Les rôles personnalisés apparaissent avec un badge **Custom** dans la liste des rôles et peuvent être modifiés ou supprimés à tout moment.

Utilisez les rôles personnalisés pour :

* Accorder un accès partiel à des modules spécifiques (par exemple, catalogues uniquement, ou rapports uniquement)
* Restreindre les actions sur une famille d'objets (par exemple, lire les clients mais ne jamais les supprimer)
* Délimiter la visibilité des projets par équipe, unité commerciale ou espace de travail
* Activer ou désactiver des actions transversales telles que les imports et exports CSV

## Le modèle de permissions

Un rôle Qwoty configure les permissions selon trois domaines distincts.

### Objets — CRUD par famille d'objets

La section **Objets** contrôle ce que les utilisateurs peuvent lire, modifier ou supprimer, réparti par famille d'objets. Vous cochez une case par action et par famille.

| Famille d'objets            | Objets concernés                       | Actions                     |
| --------------------------- | -------------------------------------- | --------------------------- |
| **Projet**                  | Devis, contrat, commande               | Lire / Modifier / Supprimer |
| **Produits & Tarification** | Catalogues, Produits, grille tarifaire | Lire / Modifier / Supprimer |
| **Clients**                 | Clients                                | Lire / Modifier / Supprimer |
| **Workflow**                | Approbation, workflow, configurateur   | Lire / Modifier / Supprimer |
| **Contenu**                 | Modèle de contrat, médias, contenu     | Lire / Modifier / Supprimer |
| **Modèles**                 | Modèles de projet                      | Lire / Modifier / Supprimer |

<Tip>
  Accordez **Lire** sans **Modifier** pour donner aux utilisateurs une visibilité sans leur permettre de modifier les enregistrements — utile pour les rôles Finance ou Direction.
</Tip>

### Niveau d'accès au projet

En haut de la section **Objets**, le menu déroulant **Niveau d'accès au projet** contrôle le périmètre des projets qu'un utilisateur peut voir, indépendamment de ses droits Lire/Modifier/Supprimer.

* **Workspace** — L'utilisateur peut accéder aux projets de l'ensemble de l'espace de travail
* **Team** — L'utilisateur n'accède qu'aux projets créés par son équipe
* **Personal** — L'utilisateur n'accède qu'aux projets qu'il a créés lui-même

<Warning>
  Le Niveau d'accès au projet agit comme un filtre qui s'applique par-dessus les droits CRUD. Un utilisateur avec `Projet : Lire` activé mais un niveau d'accès `Personal` ne verra que ses propres devis, même si l'espace de travail en contient des milliers.
</Warning>

### Paramètres — bascule par zone d'administration

La section **Paramètres** contrôle l'accès aux zones d'administration. Chaque zone dispose d'une seule bascule **Autoriser**.

| Paramètre        | Ce qu'il déverrouille                                        |
| ---------------- | ------------------------------------------------------------ |
| **Workspace**    | Définir les préférences globales de l'espace de travail      |
| **User & Teams** | Ajouter ou supprimer des utilisateurs et définir des équipes |
| **Roles**        | Définir les rôles utilisateurs et les niveaux d'accès        |
| **Data**         | Modifier la structure des données CPQ et les champs          |
| **Developers**   | Gérer les intégrations, les clés API et les webhooks         |
| **Organization** | Gérer l'organisation multi-tenant et la facturation          |

<Note>
  L'accès aux paramètres est binaire — un utilisateur a soit un accès complet à une zone, soit aucun accès. Si vous avez besoin d'un contrôle plus fin, désactivez la zone et déléguez la configuration à un Admin.
</Note>

### Applications — actions transversales au niveau de l'application

La section **Applications** contrôle les fonctionnalités transversales qui s'appliquent à l'ensemble des modules.

| Action                         | Description                                                                                                                 |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Import CSV**                 | Autoriser l'import de données depuis des fichiers CSV                                                                       |
| **Export CSV**                 | Autoriser l'export de données vers des fichiers CSV                                                                         |
| **Overpass sales restriction** | Autoriser le contournement de restrictions telles que les approbations, les plafonds de remise et les garde-fous tarifaires |

<Warning>
  **Overpass sales restriction** donne aux utilisateurs la possibilité de contourner les workflows d'approbation et les limites de remise. N'accordez cette permission qu'aux rôles seniors — généralement VP Sales, DRV ou équivalent.
</Warning>

## Fonctionnement des rôles avec les équipes

Les rôles définissent **ce que** les utilisateurs peuvent faire. Les équipes définissent **les ressources** auxquelles ils peuvent accéder. Le Niveau d'accès au projet d'un rôle établit le lien entre les deux.

| Élément                      | Contrôle                             | Exemple                                                         |
| ---------------------------- | ------------------------------------ | --------------------------------------------------------------- |
| **Rôle**                     | Accès aux fonctionnalités et actions | Un Sales Rep peut modifier des devis ; un Viewer ne le peut pas |
| **Équipe**                   | Groupe d'utilisateurs                | Un Sales Rep appartient à l'équipe France                       |
| **Niveau d'accès au projet** | Périmètre des projets visibles       | `Team` limite le Sales Rep aux devis de l'équipe France         |

Lorsque vous affectez un utilisateur à une équipe et définissez le Niveau d'accès au projet de son rôle sur `Team`, il ne voit que les ressources rattachées à cette équipe. Passez-le sur `Workspace` et il voit tout.

<Warning>
  Si vous retirez un utilisateur de toutes les équipes, il perd l'accès aux modèles, aux catalogues et aux projets à portée d'équipe, même s'il conserve son rôle.
</Warning>

## Accéder à l'écran des rôles

<Steps>
  <Step title="Ouvrir les Paramètres">
    Dans la barre latérale gauche, cliquez sur **Paramètres**.
  </Step>

  <Step title="Accéder à Rôle">
    Dans la section **Users & Team**, cliquez sur **Role** pour afficher la liste de tous les rôles disponibles.
  </Step>
</Steps>

## Consulter la liste des rôles

Le tableau des rôles affiche :

* **Rôle** — Le nom du rôle
* **Nom API** — Identifiant technique utilisé pour les intégrations et les appels API
* **Type** — **System** (badge vert) ou **Custom** (badge gris)

Utilisez la barre de recherche pour filtrer les rôles par nom ou par nom API. Vous pouvez ajuster le nombre de lignes affichées par page et naviguer entre les pages grâce aux contrôles de pagination en bas de page.

## Créer un nouveau rôle

<Steps>
  <Step title="Cliquer sur Nouveau rôle">
    Cliquez sur le bouton **+ New role** en haut à droite de l'écran.
  </Step>

  <Step title="Définir l'identité du rôle">
    Saisissez le **nom** et le **nom API** du rôle. Le nom API ne peut pas contenir d'espaces ni de caractères spéciaux.
  </Step>

  <Step title="Configurer les permissions sur les objets">
    Sélectionnez le **Niveau d'accès au projet** (Workspace, Team ou Personal), puis cochez les cases **Lire**, **Modifier** et **Supprimer** pour chaque famille d'objets.
  </Step>

  <Step title="Configurer l'accès aux paramètres">
    Activez la bascule **Autoriser** pour chaque zone de paramètres que le rôle doit gérer (Workspace, Users & Teams, Roles, Data, Developers, Organization).
  </Step>

  <Step title="Configurer les actions au niveau de l'application">
    Activez la bascule **Autoriser** pour chaque action au niveau de l'application que le rôle doit pouvoir effectuer (Import CSV, Export CSV, Overpass sales restriction).
  </Step>

  <Step title="Enregistrer">
    Cliquez sur **Save**. Le rôle apparaît dans la liste avec un badge **Custom**.
  </Step>
</Steps>

## Consulter un rôle système

<Steps>
  <Step title="Localiser le rôle">
    Trouvez le rôle système dans la liste des rôles.
  </Step>

  <Step title="Ouvrir le menu">
    Cliquez sur le menu **⋮** à droite de la ligne.
  </Step>

  <Step title="Sélectionner Afficher">
    Cliquez sur **View** pour ouvrir les détails du rôle en mode lecture seule.
  </Step>
</Steps>

## Modifier un rôle personnalisé

<Steps>
  <Step title="Localiser le rôle">
    Trouvez le rôle personnalisé dans la liste des rôles.
  </Step>

  <Step title="Ouvrir le menu">
    Cliquez sur le menu **⋮** à droite de la ligne.
  </Step>

  <Step title="Sélectionner Modifier">
    Cliquez sur **Edit**, mettez à jour les sections Objets, Paramètres ou Applications, puis cliquez sur **Save**.
  </Step>
</Steps>

## Supprimer un rôle personnalisé

<Steps>
  <Step title="Localiser le rôle">
    Trouvez le rôle personnalisé dans la liste des rôles.
  </Step>

  <Step title="Ouvrir le menu">
    Cliquez sur le menu **⋮** à droite de la ligne.
  </Step>

  <Step title="Sélectionner Supprimer">
    Cliquez sur **Delete** et confirmez la suppression.
  </Step>
</Steps>

<Warning>
  Avant de supprimer un rôle personnalisé, réaffectez tous les utilisateurs qui le détiennent. Les utilisateurs dont le rôle a été supprimé perdent leur accès jusqu'à ce qu'un nouveau rôle leur soit attribué.
</Warning>

## Attribuer un rôle à un utilisateur

Vous attribuez un rôle lors de l'invitation d'un nouvel utilisateur ou de la modification d'un utilisateur existant.

<Steps>
  <Step title="Accéder à la gestion des utilisateurs">
    Cliquez sur **Paramètres** dans la barre latérale gauche, puis cliquez sur **User** dans la section **Users & Team**.
  </Step>

  <Step title="Sélectionner l'utilisateur">
    Pour inviter un nouvel utilisateur, cliquez sur **+ Invite user**. Pour modifier un utilisateur existant, cliquez sur le menu **⋮** à côté de son nom et sélectionnez **Edit**.
  </Step>

  <Step title="Choisir le rôle">
    Dans le formulaire utilisateur, sélectionnez le rôle approprié dans le menu déroulant **Role**.
  </Step>

  <Step title="Enregistrer les modifications">
    Cliquez sur **Save** ou **Send invitation** pour appliquer le rôle.
  </Step>
</Steps>

<Tip>
  Attribuez le rôle **Manager** aux utilisateurs qui doivent approuver des devis sans nécessiter les privilèges complets d'un Admin.
</Tip>

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Puis-je modifier un rôle système ?">
    Non. Les rôles système sont verrouillés pour garantir le bon fonctionnement de Qwoty. Créez plutôt un rôle personnalisé et configurez les permissions selon vos besoins.
  </Accordion>

  <Accordion title="Que se passe-t-il si je supprime un rôle personnalisé attribué à des utilisateurs ?">
    Le rôle est supprimé, mais les utilisateurs qui lui étaient affectés restent dans le système. Vous devez réaffecter manuellement chaque utilisateur à un nouveau rôle avant qu'il puisse de nouveau accéder à Qwoty.
  </Accordion>

  <Accordion title="Un utilisateur peut-il avoir plusieurs rôles ?">
    Non. Chaque utilisateur se voit attribuer exactement un rôle. Si vous avez besoin d'une combinaison de permissions, créez un rôle personnalisé qui les regroupe.
  </Accordion>

  <Accordion title="À quoi sert le nom API ?">
    Le nom API est un identifiant technique utilisé dans les intégrations, les appels API et les scripts d'automatisation. Il ne peut pas contenir d'espaces ni de caractères spéciaux.
  </Accordion>

  <Accordion title="Les rôles affectent-ils l'accès à l'API ?">
    Oui. Les requêtes API s'authentifient via les identifiants utilisateur ou les clés API associées à un compte utilisateur, de sorte que les permissions du rôle s'appliquent également aux appels API.
  </Accordion>

  <Accordion title="Que se passe-t-il lorsque je change le rôle d'un utilisateur ?">
    Le changement prend effet immédiatement. Les permissions de l'utilisateur sont mises à jour la prochaine fois qu'il actualise sa session ou se reconnecte.
  </Accordion>

  <Accordion title="Quelle est la différence entre le Niveau d'accès au projet et la permission Lire ?">
    La permission Lire détermine **si** un utilisateur peut consulter des devis, contrats et commandes. Le Niveau d'accès au projet détermine **lesquels** — tous les projets de l'espace de travail, uniquement ceux de son équipe, ou uniquement ceux qu'il a créés lui-même. Les deux doivent être alignés pour qu'un utilisateur puisse voir un projet.
  </Accordion>

  <Accordion title="Pourquoi accorder Overpass sales restriction ?">
    N'accordez cette permission qu'aux rôles seniors qui ont légitimement besoin de contourner les workflows d'approbation, les plafonds de remise ou les garde-fous tarifaires — généralement VP Sales, DRV ou les responsables Finance gérant des cas exceptionnels.
  </Accordion>
</AccordionGroup>

## Voir aussi

<CardGroup cols={2}>
  <Card title="Gérer les utilisateurs" icon="users" href="/user-guide/settings/users/manage-users">
    Consulter, inviter et modifier les utilisateurs de votre espace de travail.
  </Card>

  <Card title="Gérer les équipes" icon="user-group" href="/user-guide/settings/users/manage-teams">
    Organiser les utilisateurs en équipes pour contrôler l'accès aux modèles et aux catalogues.
  </Card>

  <Card title="Paramètres de l'espace de travail" icon="building" href="/user-guide/settings/workspace/general">
    Configurer les paramètres au niveau de l'espace de travail et les unités commerciales.
  </Card>

  <Card title="Approbations & workflows" icon="circle-check" href="/user-guide/workflows/introduction">
    Mettre en place des règles d'approbation dépendant des rôles et du périmètre d'équipe.
  </Card>
</CardGroup>