Miembros del equipo

Un miembro del equipo es una persona con acceso a tu espacio de trabajo de WhatSetter. La API los lista para que tus herramientas puedan poner nombre a un responsable y asignar leads por id.

Endpoints

Método	Ruta	Scope
GET	`/team/members`	`team:read`

Listar miembros

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
    }
  ]
}

No hay paginación: los equipos son pequeños, y un espacio de trabajo admite como máximo 200 miembros. La fuente es la misma lista de pertenencias que muestra la página Equipo del dashboard.

Asignar leads con estos ids

id es lo que PATCH /leads/{id} espera en 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 que no es miembro del espacio de trabajo responde 422 validation_error. Guarda la lista en caché por tu lado y refréscala cuando una asignación falle: puede que alguien haya dejado el equipo.

Qué significa el rol

role es el preajuste del dashboard al que corresponden los permisos del miembro: owner, admin, editor, responder, viewer, o custom cuando los permisos se ajustaron a mano. is_owner es true para la persona propietaria del espacio de trabajo. Las personas invitadas pero aún no confirmadas no aparecen: no pueden ser responsables de un lead. Primero el propietario, luego los nombres por orden alfabético.

Rol	En dos palabras
`owner`	Todo, incluida la facturación y la eliminación del espacio de trabajo.
`admin`	Gestiona campañas, equipo e integraciones, no la facturación.
`editor`	El día a día: campañas, conversaciones, leads.
`responder`	Responde conversaciones y gestiona los leads de su alcance.
`viewer`	Lo lee todo, no cambia nada.
`custom`	Permisos ajustados a mano en el dashboard.

Los permisos se aplican en el servidor en cada acción del dashboard. La clave API tiene sus propios scopes y no hereda el rol de ningún miembro. Ver Equipo y roles para los detalles.

Errores que encontrarás

HTTP	`code`	Cuándo
401	`missing_api_key`, `invalid_api_key`	Clave ausente, desconocida o revocada.
403	`insufficient_scope`	La clave no tiene `team:read`.
429	`rate_limited`	Demasiadas peticiones este minuto. Respeta `Retry-After`.