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

# Équipe et collaborateurs

> Invitez des personnes sur votre boutique avec un rôle précis, sans jamais leur donner l'argent ni la sécurité du compte.

Ajoutez des collaborateurs (associé, community manager, support, développeur) à votre boutique. Chacun se connecte avec **son propre compte** et travaille sur votre boutique dans la limite de son rôle. Vous pouvez retirer l'accès à tout moment, avec effet immédiat.

## Les rôles

| Rôle | Ce qu'il peut faire |
| - | - |
| **Administrateur** | Gère la boutique au quotidien : produits, ventes, clients, marketing, intégrations |
| **Marketing** | Produits, pages de vente, tunnels, promotions, e-mails, affiliation, statistiques |
| **Support client** | Commandes, clients, retours, réponses automatiques, messagerie ; statistiques en lecture seule |
| **Développeur** | Clés d'API, Pulses, intégrations ; produits et commandes en lecture seule |

> [!WARNING]
>
> **Réservé au propriétaire, quel que soit le rôle** : retraits, moyens de paiement, portefeuille, profil et sécurité du compte, abonnement, certification, dépôt COD, devise, cartes virtuelles, et la gestion de l'équipe elle-même.

## Inviter quelqu'un

**1. Ouvrir l'équipe**

**Paramètres**, puis **Équipe & collaborateurs**, puis **Inviter**.

**2. Saisir l'e-mail et le rôle**

La personne n'a pas besoin d'avoir déjà un compte.

**3. La personne accepte**

Elle reçoit un lien valable **7 jours**, crée son compte ou se connecte, puis accepte. Elle bascule ensuite entre son compte et votre boutique avec le sélecteur de l'en-tête.

L'invitation est **nominative** : seul le compte dont l'e-mail correspond peut l'accepter, un lien transféré ne donne rien. Le lien est à usage unique ; réinviter la même adresse envoie un nouveau lien et invalide l'ancien.

## Limites

* 10 collaborateurs au maximum par équipe, 50 invitations en attente.
* Une équipe par compte vendeur : elle sert toutes vos boutiques.

## Sécurité

* **Refus par défaut** : tout ce qui n'est pas explicitement permis à un rôle est refusé (`403`).
* **Vérifié à chaque requête** : l'appartenance est relue en base à chaque appel ; une révocation prend effet immédiatement.
* **Lien protégé** : 32 octets aléatoires, seule l'empreinte SHA-256 est conservée.
* **Menu adapté** : un collaborateur ne voit que les pages que son rôle permet ; une page ouverte par lien direct affiche « Page non accessible avec votre rôle ».
* **Journal complet** : invitations, arrivées, changements de rôle, révocations et **chaque modification** faite par un collaborateur, avec son rôle, son adresse IP, son **pays** et son appareil. Le pays vient du réseau de diffusion devant l'API ; il sert d'information d'audit, jamais à autoriser ou refuser un accès.

## API

Routes de la session connectée (`/api/team`) :

| Méthode | Chemin | Rôle |
| - | - | - |
| `GET` | `/team/meta` | Rôles et limites |
| `GET` | `/team/members` | Membres |
| `PATCH` / `DELETE` | `/team/members/:id` | Changer le rôle / retirer l'accès |
| `GET` / `POST` | `/team/invitations` | Lister / inviter |
| `POST` | `/team/invitations/:id/resend` | Renvoyer |
| `DELETE` | `/team/invitations/:id` | Annuler |
| `GET` | `/team/activity` | Journal (`items`, `next_before`) |
| `GET` | `/team/memberships` | Boutiques où l'on est collaborateur, avec les pages ouvertes |
| `DELETE` | `/team/memberships/:sellerId` | Quitter une équipe |
| `GET` | `/team/invitations/preview/:token` | Aperçu public d'une invitation |
| `POST` | `/team/invitations/accept/:token` | Accepter |

Pour agir sur la boutique d'un autre, envoyez l'en-tête `X-Team-Seller: <identifiant de la boutique>` : le serveur vérifie votre appartenance et votre rôle avant toute action.

## Limites connues

* Le [MCP](https://docs.pulse-sell.com/guides/mcp.md) agit sur la boutique de la personne qui crée la connexion : le propriétaire crée les siennes.
* Les e-mails d'équipe sont envoyés en texte simple.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.