Accès d'équipe

Vos collègues n’ont pas tous besoin de détenir la clé API de l’espace de travail. Les sièges Klozeo vous permettent d’inviter vos collègues, et votre consultant en automatisation, dans le tableau de bord avec un rôle précis. n8n, les SDKs et vos scripts continuent de fonctionner comme avant.

Invitations

Le propriétaire ou un admin invite depuis Équipe : saisissez l’e-mail, choisissez un rôle, puis envoyez. Le propriétaire peut choisir Admin, Éditeur ou Lecteur. Un admin peut choisir Éditeur ou Lecteur : seul le propriétaire peut inviter un admin. La personne invitée reçoit un e-mail avec un lien pour accepter, et l’e-mail indique qui l’a invitée.

Sans compte, l’invitation vous mène à la connexion ou à la création d’un compte quand les inscriptions sont ouvertes. Après la vérification de votre e-mail, l’invitation se rouvre d’elle-même : acceptez-la à ce moment-là. Pendant une pause des inscriptions, une invitation ne contourne pas la pause : les comptes existants peuvent toujours se connecter et accepter.

Un lien d’invitation expire au bout de 7 jours. Seule l’adresse e-mail invitée peut accepter un lien, et chaque lien ne sert qu’une fois. Retirer une invitation ou un membre révoque l’accès. Le propriétaire peut retirer n’importe quel membre. Un admin peut retirer les éditeurs et les lecteurs et annuler leurs invitations, mais pas un autre admin. Que ce soit le propriétaire ou un admin qui retire un membre, l’accès de ses assistants à cet espace de travail (Claude, ChatGPT et les autres clients MCP) est aussi coupé. Retirer un membre ou une invitation demande d’abord une confirmation. Un lien révoqué ne peut pas être réutilisé.

Le plan Free donne un seul utilisateur : inviter des membres demande Pro ou Scale. L’essai Pro de 14 jours compte comme Pro, vous pouvez donc inviter pendant l’essai. Sur Free, un admin a les droits d’un lecteur et ne gère pas l’équipe. Les limites anti-abus sont de 25 membres en Pro et 100 en Scale (membres actifs plus invitations en attente non expirées, propriétaire exclu), et de 20 envois d’invitation par espace de travail sur 24 heures, quelle que soit la personne qui envoie. Ces limites appartiennent à l’espace de travail : les invitations d’un admin comptent comme celles du propriétaire. Des limites réseau et par adresse e-mail destinataire peuvent renvoyer 429 avec Retry-After. Retirer une invitation libère un siège, sans remettre à zéro le budget d’e-mails. Dépasser une limite renvoie 403 avec un message explicite. Les sièges restent inclus dans le prix du plan.

Quand un espace de travail repasse en Free (fin de l’essai ou de son abonnement), personne n’est retiré : les membres gardent un accès en lecture seule, quel que soit leur rôle, et les invitations en attente peuvent encore être acceptées en lecture seule. Quand le propriétaire souscrit à Pro ou Scale, chaque membre retrouve son rôle.

Rôles

Les droits ci-dessous restent soumis au plan et à l’état de lecture seule de l’espace.

Rôle	Tableau de bord et API	Usage courant
Propriétaire	Accès complet, équipe, facturation et export du compte compris	Fondateur ou responsable qui possède l’espace de travail
Admin	Tout ce que fait un éditeur, plus les clés API, les webhooks, la suppression par lot, le recalcul global des scores, ainsi que l’invitation et la gestion des éditeurs et des lecteurs. Ni les admins, ni la facturation, ni l’export du compte, ni le transfert de propriété, ni la suppression de l’espace de travail. Ne voit les leads que lorsque le propriétaire donne l’accès	Consultant ou agence qui branche les automatisations de l’espace de travail
Éditeur	Peut créer, modifier et supprimer des leads individuels et les données liées ; création et mise à jour par lot autorisées	Ops, commerciaux, workflows d’enrichissement dans l’interface
Lecteur	Lecture seule : toute écriture renvoie `403`	Personnes qui ont besoin de voir les leads sans écrire

Chaque personne de l’espace de travail, quels que soient son rôle et son plan, voit l’e-mail du propriétaire et de chaque membre actif. Le tableau de bord l’affiche partout où il nomme une personne, par exemple dans le panneau Ne pas contacter. L’API, le serveur MCP et les exports renvoient l’e-mail de la personne à qui un lead est attribué et celui de l’auteur d’une note. Un assistant ou une application qu’un membre connecte reçoit ce que ce membre lit, donc ces e-mails aussi. Les webhooks ne transportent ni la personne à qui le lead est attribué ni l’auteur des notes.

Un membre retiré apparaît comme un ancien membre dans le tableau de bord. Son e-mail reste, dans l’API, le serveur MCP et les exports, sur les leads qui lui sont attribués, sur les notes qu’il a écrites et sur les entrées d’attribution de l’historique, jusqu’à la suppression de son compte ou, pour un lead supprimé, jusqu’à l’effacement des valeurs de son historique. Les autres membres ne voient pas les invitations en attente. Aucun compte extérieur à l’espace de travail ne voit ces e-mails.

Les endpoints des clés API et des webhooks (/api-keys, /webhooks), la suppression par lot (DELETE /leads/batch) et le recalcul global des scores (POST /leads/score/batch) sont réservés au propriétaire ou à un admin, dans le proxy du tableau de bord comme dans l’API. Un éditeur peut toujours créer et mettre à jour des leads par lot, et recalculer le score d’un seul lead. Un appel d’API fait par un éditeur ou un lecteur invité reçoit :

{
  "error": "forbidden",
  "message": "Only the workspace owner or an admin can perform this action",
  "code": "forbidden"
}

Un lecteur qui appelle une méthode d’écriture hors de ces endpoints (POST, PUT, DELETE, …) reçoit :

{
  "error": "forbidden",
  "message": "Viewer role cannot modify data",
  "code": "forbidden"
}

Dans un espace en lecture seule, le contrôle de lecture seule bloque les modifications des leads, des règles de scoring et de la liste des statuts avec 403 workspace_read_only, y compris depuis une clé API. Les contrôles de portée et d’accès effectués avant peuvent renvoyer une autre erreur.

Accès aux leads

Un admin ne voit aucun lead tant que le propriétaire de l’espace de travail ne lui donne pas l’accès aux leads. Dans Équipe, le propriétaire choisit Donner l’accès sur la ligne de l’admin, puis 24 heures, 7 jours ou Sans limite. L’accès s’arrête de lui-même, ou plus tôt quand le propriétaire choisit Révoquer l’accès.

Un admin sans accès peut choisir Demander l’accès. Le propriétaire reçoit un e-mail et une notification dans Équipe, puis choisit Donner l’accès ou Refuser. Une demande expire au bout de 7 jours, et l’admin peut l’annuler avec Annuler la demande.

L’accès aux leads est remis à zéro quand un admin est invité, change de rôle, est retiré ou part, et quand la propriété de l’espace de travail est transférée. Seul le propriétaire voit l’accès et les demandes des autres admins.

L’accès aux leads gouverne ce que la personne voit dans le tableau de bord et dans son propre assistant IA. Les clés API et les webhooks continuent de fonctionner, y compris ceux que l’admin a créés. Sans accès aux leads, un admin peut toujours gérer les clés API, les webhooks et les règles de scoring. Ces droits restent soumis au plan et à l’état de lecture seule de l’espace.

Attribuer des leads

Un lead est attribué à une seule personne : le propriétaire de l’espace de travail ou un membre actif. Le tableau de bord la désigne par son e-mail.

Le propriétaire, les admins et les éditeurs peuvent attribuer des leads. Les lecteurs ne le peuvent pas. Dans un espace Free modifiable, seul le propriétaire peut attribuer des leads, car tous les autres membres sont en lecture seule. Dans un espace en lecture seule, personne ne le peut. Vous pouvez attribuer un lead au propriétaire ou à n’importe quel membre actif, quels que soient son rôle et son plan. Un lecteur peut avoir des leads, et une invitation en attente ne peut pas être choisie.

Dans la liste, la colonne Attribué à affiche l’e-mail de la personne, Non attribué ou Ancien membre.
Au-dessus de la liste, Tous les leads affiche tous les leads, Mes leads ceux qui vous sont attribués et Non attribués ceux qui ne sont attribués à personne. Ce choix se combine avec vos filtres et s’applique à l’export.
Dans les filtres, choisissez le champ Attribué à, puis moi ou l’e-mail d’un membre comme valeur. moi, c’est vous. Les opérateurs sont égal à, différent de, est vide et n’est pas vide. différent de renvoie aussi les leads non attribués.
Sur un lead, la ligne Attribué à contient un bouton : Choisir une personne quand le lead n’est attribué à personne, l’e-mail sinon. Il ouvre une liste où chercher par e-mail, avec vous en premier sous la forme Moi ([email protected]). Retirer l’attribution remet le lead sur Non attribué. Les membres qui ne peuvent pas attribuer voient l’e-mail en texte.
Dans la liste, cochez des leads, choisissez Attribuer, sélectionnez une personne, puis confirmez avec Attribuer. Tous les leads cochés vont à cette personne. Le tableau de bord ne retire pas les attributions en lot : retirez l’attribution lead par lead, ou envoyez "assignee": null à PUT /leads/batch.

Quand un membre est retiré ou part, ses leads restent attribués à cette personne tant que vous n’en choisissez pas une autre. Le tableau de bord affiche Ancien membre à la place de son e-mail, et cette personne ne peut plus être choisie.

Une fusion ne change jamais l’attribution du lead qu’elle met à jour, qu’elle vienne de l’API ou d’un import.

Dans l’API, envoyez assignee sur Create Lead ou Update Lead, et filtrez les leads avec assignee (opérateurs de filtre).

Auteurs des notes et historique

Tous les membres de l’espace de travail voient qui a écrit une note. Une note porte une mention d’auteur, par {actor} · {date}. {actor} est l’e-mail du membre, ou un ancien membre pour quelqu’un qui n’est plus dans l’espace de travail. Pour vos propres notes, elle indique par vous. Une note écrite avec une clé API affiche via {key} · {date}, par exemple via la clé « Make prod ». Une clé révoquée garde son nom, suivi de (révoquée). Certaines notes anciennes, et les notes dont l’auteur a supprimé son compte, n’ont pas de mention d’auteur.

L’onglet historique d’un lead liste ses 50 changements les plus récents. Chaque ligne indique le changement, sa date et qui l’a fait : par {actor} pour un membre, via {key} pour une clé API. Les mises à jour automatiques du score n’y figurent pas : un score peut donc changer sans ligne. L’API les liste : voir la piste d’audit.

Changer le rôle d’un membre

Dans Équipe, le propriétaire de l’espace de travail choisit le rôle d’un membre dans le sélecteur voisin, entre Admin, Éditeur et Lecteur. Un admin peut seulement faire passer un membre d’Éditeur à Lecteur, ou l’inverse : donner, changer ou retirer le rôle admin reste au propriétaire. Le changement est enregistré tout de suite, sans retirer le membre ni envoyer une autre invitation. Une invitation en attente non expirée peut aussi être modifiée ; une invitation révoquée ou expirée, non. Le rôle du propriétaire ne peut pas être changé.

Changer le rôle d’un membre coupe l’accès de ses assistants à cet espace de travail. Le membre doit autoriser de nouveau chaque assistant pour cet espace, même après une promotion. L’accès de ses assistants aux autres espaces de travail n’est pas touché.

Quitter un espace de travail

Tout membre sauf le propriétaire peut quitter un espace de travail. Sélectionnez-le dans le sélecteur Espace de travail, ouvrez Équipe et choisissez Quitter l’espace. Votre accès à ses leads s’arrête tout de suite, comme lors d’un retrait, et vos assistants perdent l’accès à cet espace de travail seulement. Leur accès à vos autres espaces de travail n’est pas touché. Pour revenir, il faut une nouvelle invitation.

Les clés API et les webhooks appartiennent à l’espace de travail, pas à la personne qui les a créés : partir ne les supprime pas. Quand un admin part, la fenêtre liste les clés et les webhooks qu’il a créés, décochés : cochez ceux à révoquer (clés) ou à supprimer (webhooks) tout de suite. La même liste apparaît quand le propriétaire ou un admin retire un membre.

Le propriétaire ne peut pas partir : Klozeo refuse avec 403 et le code team_owner_leave. Transférez d’abord l’espace de travail à un membre actif, comme l’explique Confier un espace de travail à votre client. Vous restez admin et pouvez ensuite partir. Les autres issues sont Supprimer l’espace de travail, quand Réglages le propose, et Supprimer le compte dans Réglages, qui supprime toutes ses données, membres d’équipe compris.

Choisir un espace de travail

Accepter une invitation ouvre l’espace de travail que vous venez de rejoindre. Sinon, votre premier espace de travail s’ouvre par défaut, y compris quand vous en possédez plusieurs ou que vous appartenez à plusieurs équipes. La barre latérale du tableau de bord affiche toujours l’espace de travail sélectionné ; utilisez le sélecteur Espace de travail pour passer à un autre espace que vous possédez ou auquel vous avez été invité. Le choix est enregistré dans un cookie, et la propriété ou l’appartenance active est vérifiée à chaque requête. Une sélection révoquée ou indisponible retombe sur votre premier espace de travail.

Quand vous appartenez à deux espaces de travail ou plus, le sélecteur ajoute Tous les espaces. Il ouvre Vos espaces de travail : une ligne pour chaque espace de travail auquel vous appartenez, quel que soit votre rôle, avec un lien qui l’ouvre et un badge Actuel sur l’espace sélectionné. Chaque ligne indique votre rôle, le plan (avec la date de fin d’un essai Pro ou d’une période déjà payée), le nombre de leads, la date et l’heure du dernier changement dans l’historique des leads (les mises à jour automatiques du score ne comptent pas) et les livraisons de webhook en échec sur les 7 derniers jours, avec un lien vers la page Webhooks de cet espace. Dans la dernière colonne, les lignes où vous êtes propriétaire ou admin affichent le nombre ; les autres lignes affichent Propriétaire ou admin uniquement (un admin sur un espace Free compte comme un lecteur). Les espaces de travail qui ont une date de fin viennent d’abord, du plus proche au plus lointain, puis les autres par nom. La page ne fait que montrer l’état. La facturation reste au propriétaire de chaque espace de travail.

Créer et renommer des espaces de travail

Utilisez Nouvel espace dans la barre latérale pour créer un espace de travail distinct, par exemple un par client. Vous en êtes propriétaire, et il a ses propres leads, membres, clés API, webhooks et connexions d’assistants : rien n’est partagé avec vos autres espaces de travail. Un nouvel espace de travail démarre sur le plan Free, sans essai.

Chaque espace de travail a son propre plan et son propre abonnement. En tant que propriétaire, sélectionnez l’espace de travail et abonnez-le à Pro ou Scale depuis Réglages, ou à Pro depuis la barre latérale. Tous les abonnements vous sont facturés, et Gérer la facturation les liste tous. Tous vos espaces de travail, sauf le premier, paient le prix standard : le prix fondateur, tant que l’offre est ouverte, ne vaut que pour votre premier espace de travail. Les admins, les éditeurs et les lecteurs ne peuvent pas changer le plan d’un espace de travail. Vous pouvez posséder autant d’espaces de travail payants que vous voulez.

Vous pouvez créer un espace Free seulement si vous ne possédez aucun autre espace Free, votre premier espace compris. Si votre premier espace de travail est sur le plan Free, passez-le à Pro ou Scale avant d’en créer un autre.

Le propriétaire renomme un espace de travail avec Renommer dans la barre latérale. Un nom compte de 1 à 100 caractères.

Les exports CSV et XLSX utilisent l’espace de travail sélectionné, conservent le fichier téléchargé et restent disponibles pour tous les rôles.

Quand un espace Free passe en lecture seule

Un seul espace Free dont vous êtes propriétaire reste modifiable : votre premier espace s’il est en Free, sinon le plus ancien de vos espaces Free. Tous vos autres espaces Free passent en lecture seule pour tous leurs membres, propriétaire compris. Cela peut arriver à la fin de votre essai Pro, à la fin d’un abonnement, ou à la fin d’une période payée après un transfert. Rien n’est supprimé : la lecture, l’export, les membres, les clés API, les webhooks et les connexions d’assistants continuent de fonctionner, mais les modifications des leads, des règles de scoring et de la liste des statuts sont refusées, y compris depuis une clé API. Elles renvoient 403 workspace_read_only, sauf si un contrôle de portée ou d’accès effectué avant renvoie sa propre erreur. Un bandeau l’explique dans le tableau de bord. Abonner un espace en lecture seule à Pro ou Scale y rétablit l’écriture. Si vous possédez exactement deux espaces Free, abonner l’autre la rétablit aussi.

Supprimer un espace de travail

Seul le propriétaire d’un espace de travail peut le supprimer. Les admins, les éditeurs et les lecteurs ne le peuvent pas.

Sélectionnez l’espace de travail dans le sélecteur Espace de travail, ouvrez Réglages et repérez la carte Supprimer l’espace de travail, au-dessus de Supprimer le compte. Cliquez sur Supprimer cet espace, saisissez le nom de l’espace de travail pour confirmer, puis cliquez sur Supprimer définitivement. Le tableau de bord se recharge dans un autre espace de travail auquel vous avez accès.

La suppression est définitive. Elle efface l’espace de travail et tout ce qu’il contient : leads, notes, attributs et historique, règles de scoring, clés API, webhooks, membres et invitations. Les automatisations qui utilisent ses clés API cessent de fonctionner. Les assistants (Claude, ChatGPT et autres clients MCP) perdent cet espace de travail et gardent leurs autres espaces de travail. Vos autres espaces de travail ne sont pas touchés. Les sauvegardes chiffrées sont conservées 90 jours au maximum.

Klozeo refuse la suppression quand :

l’espace de travail a un abonnement non terminé. Résiliez-le avec Gérer la facturation dans Réglages, puis supprimez l’espace de travail une fois l’abonnement terminé ;
l’espace de travail est payé jusqu’à une date, après un transfert payant. Supprimez-le après cette date ;
un paiement est en cours. Réessayez quand il sera terminé ou expiré, sous 25 heures ;
une offre de transfert est en attente. Annulez-la avec Annuler l’offre dans Équipe, ou laissez-la expirer au bout de 7 jours ;
c’est le seul espace de travail auquel vous avez accès. Supprimez plutôt votre compte.

L’espace de travail créé à l’inscription d’un compte ne peut pas être supprimé seul, même après un transfert : transférez-le à nouveau à un membre actif, ou supprimez le compte qui le possède.

Ce que l’API voit du rôle

Quand un membre travaille dans le tableau de bord, Klozeo sait qui il est et quel rôle il détient : vous ne transmettez jamais un rôle vous-même. Chaque changement qu’il fait est enregistré dans la piste d’audit avec son propre identifiant d’acteur.

Ce que peut faire une clé API

n8n, les SDKs, cURL et tout client authentifié par X-API-Key agissent comme le propriétaire de l’espace de travail quand la clé donne un accès complet, ce qui est le choix par défaut à la création d’une clé dans le tableau de bord. Vos automatisations existantes ne cassent pas quand vous invitez des membres : les rôles portent sur l’accès au tableau de bord, pas sur les clés API. Un admin peut créer et révoquer les clés API de l’espace de travail. Une clé à accès complet agit comme le propriétaire, sauf qu’une clé créée par un admin ne peut pas exporter le compte. Une clé read agit comme un lecteur, et une clé write peut seulement créer et mettre à jour des leads, des notes et des valeurs d’attributs personnalisés.

Une requête ne peut pas choisir son propre rôle. Les en-têtes X-Member-Role et X-Actor-Id ne sont plus acceptés : une requête qui en envoie un est refusée avec 401 Unauthorized. Retirez-les de vos anciens scripts.

Ce qu’il faut partager avec votre équipe

Éditeurs et lecteurs : le propriétaire ou un admin les invite depuis le tableau de bord ; ils se connectent et travaillent dans l’interface.
Consultants : invitez-les comme admin ; ils créent les clés API et les webhooks dont vos automatisations ont besoin, sans votre mot de passe, et ils peuvent inviter et gérer vos éditeurs et vos lecteurs.
Automatisations : gardez la clé API du propriétaire, ou créez les clés en tant que propriétaire ou admin. Ne mettez pas les cookies de session d’un membre dans n8n.
Audit : quand un membre modifie un lead dans le tableau de bord, actor_id sur GET /leads/{id}/changes indique qui l’a fait.

→ Dédoublonnage et piste d’audit · Authentification de l’API