Membres de l'équipe

Un membre de l’équipe, c’est une personne qui a accès à ton espace de travail WhatSetter. L’API les liste pour que tes outils puissent mettre un nom sur un propriétaire et attribuer des leads par id.

Endpoints

Méthode	Chemin	Scope
GET	`/team/members`	`team:read`

Lister les membres

curl "https://app.whatsetter.com/api/v1/team/members" \
  -H "Authorization: Bearer ws_live_…"

const res = await fetch('https://app.whatsetter.com/api/v1/team/members', {
  headers: { Authorization: 'Bearer ws_live_…' },
});
const { data: members } = await res.json();

import requests

r = requests.get(
    "https://app.whatsetter.com/api/v1/team/members",
    headers={"Authorization": "Bearer ws_live_…"},
)
members = r.json()["data"]

{
  "data": [
    {
      "id": "66a1b2c3d4e5f6a7b8c9d0e1",
      "name": "Julien Martin",
      "email": "julien@acme.com",
      "role": "editor",
      "is_owner": false
    },
    {
      "id": "66a1b2c3d4e5f6a7b8c9d0e2",
      "name": "Marie Dupont",
      "email": "marie@acme.com",
      "role": "owner",
      "is_owner": true
    }
  ]
}

Pas de pagination : les équipes sont petites, et un espace de travail contient 200 membres au maximum. La source est la même liste d’adhésions que la page Équipe du dashboard.

Attribuer des leads avec ces ids

id est ce que PATCH /leads/{id} attend dans assigned_to :

curl -X PATCH "https://app.whatsetter.com/api/v1/leads/66f1a2b3c4d5e6f7a8b9c0d1" \
  -H "Authorization: Bearer ws_live_…" \
  -H "Content-Type: application/json" \
  -d '{"assigned_to":"66a1b2c3d4e5f6a7b8c9d0e1"}'

Un id qui n’est pas membre de l’espace de travail répond 422 validation_error. Mets la liste en cache de ton côté et rafraîchis-la quand une attribution échoue : quelqu’un a peut-être quitté l’équipe.

Ce que signifie le rôle

role est le préréglage du dashboard auquel correspondent les permissions du membre : owner, admin, editor, responder, viewer, ou custom quand les permissions ont été ajustées à la main. is_owner vaut true pour la personne propriétaire de l’espace de travail. Les personnes invitées mais pas encore confirmées ne sont pas listées : elles ne peuvent pas posséder un lead. Le propriétaire vient en premier, puis les noms par ordre alphabétique.

Rôle	En deux mots
`owner`	Tout, y compris la facturation et la suppression de l’espace de travail.
`admin`	Gère les campagnes, l’équipe et les intégrations, pas la facturation.
`editor`	Le quotidien : campagnes, conversations, leads.
`responder`	Répond aux conversations et gère les leads de son périmètre.
`viewer`	Lit tout, ne modifie rien.
`custom`	Permissions ajustées à la main dans le dashboard.

Les permissions sont appliquées côté serveur sur chaque action du dashboard. La clé API a ses propres scopes et n’hérite du rôle d’aucun membre. Voir Équipe et rôles pour le détail.

Les erreurs que tu rencontreras

HTTP	`code`	Quand
401	`missing_api_key`, `invalid_api_key`	Clé absente, inconnue ou révoquée.
403	`insufficient_scope`	La clé n’a pas `team:read`.
429	`rate_limited`	Trop de requêtes cette minute. Respecte `Retry-After`.