Pessoas e times

A área de Pessoas é onde o admin da organização decide quem tem acesso à plataforma e como o acesso é organizado. Tem três abas: Usuários (membros ativos), Times (sub-grupos) e Convites (quem foi chamado mas ainda não entrou).

Aba Usuários — quem está dentro

Lista todos os membros aceitos e os pendentes da organização, com função, status e desde quando estão. Clique no nome para abrir o painel lateral, onde você pode mudar o papel ou remover o usuário. Use os filtros para achar rápido — "todos os Admins" ou "todos os Pendentes".

Aba Usuários — lista de membros com papel e status

Os 4 papéis da organização

Super Admin — controle total da organização. Pode mudar plano, branding, faturamento, criar/remover qualquer coisa. Use com parcimônia.

Administrador — convida pessoas, organiza times, gerência permissões. Não mexe em plano e faturamento.

Criador — cria agentes, workflows e habilidades. É o papel padrão de quem produz dentro da plataforma.

Membro — usa o que já está pronto (conversa com agentes, consulta documentos), mas não cria.

Convidar uma pessoa

Clique em Convidar usuário, informe email e papel — a pessoa recebe um e-mail com link para criar conta. Se o e-mail demorar, ela pode mesmo assim fazer signup direto pelo /signup com o mesmo email; o sistema reconhece o convite pendente e ativa a conta automaticamente.

Modal Convidar membro — email, nome e papel

Aba Times — organize por sub-grupos

Times são sub-grupos dentro da organização. Útil quando você tem várias áreas que precisam de acessos diferentes. Cada time aparece como um card com a contagem de membros — clique para abrir o detalhe.

Aba Times — cards de cada time da organização

Criar um time

Clique em Novo time, dê um nome (ex: "Marketing", "Suporte") e uma descrição curta. Times são planos — não há sub-times.

Dentro de um time

No painel do time você consegue:

Adicionar/remover membros — quem está naquele time herda os ajustes do time.
Conceder ou negar permissões específicas — exemplo: dar acesso a um módulo extra só pro time de Marketing, sem mexer no papel global da pessoa.
Ligar e desligar funcionalidades por time — cada time pode ter feature flags próprias (ex: módulo de Analytics ativo só pro time de Dados).

Detalhe de um time — membros, permissões e feature flags

Importante: quando uma permissão entra em conflito (papel global libera X, time específico nega), o NEGAR sempre vence. É proteção contra acidente.

Aba Convites — quem foi chamado e ainda não entrou

Lista todos os convites enviados com email, papel proposto e status (Pendente, Aceito, Cancelado). Convites pendentes têm dois botões — reenviar (gera novo e-mail) e cancelar (removê o convite, a pessoa não consegue mais aceitar).

Aba Convites — convites enviados com seu status atual

Para quem é útil

Admin da organização — todo controle de acesso passa por aqui.
Líderes de área — usam Times para isolar permissões da equipe.
RH / TI interna — onboarding e desligamento de pessoas com 2 cliques.

A gestão de pessoas usa três grupos de endpoints: /v1/organizations/current/members (membros aceitos), /v1/invitations (convites pendentes/aceitos/cancelados) e /v1/teams (times + /v1/rbac/teams/{id}/grants para permissões e /v1/flags/teams/{id}/{flag} para feature flags).

Convites

role aceita ADMIN, CREATOR ou MEMBER (SUPERADMIN não pode ser concedido via convite). Status vai por PENDING → ACCEPTED ou CANCELLED/EXPIRED.

curl

# Convidar um membro
curl -X POST https://api.adalink.ai/v1/invitations \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "novo@empresa.com",
    "name": "Maria Silva",
    "role": "MEMBER"
  }'

# Reenviar (se a pessoa nao recebeu)
curl -X POST https://api.adalink.ai/v1/invitations/INVITE_ID/resend \
  -H "Authorization: Bearer SEU_TOKEN"

# Cancelar
curl -X DELETE https://api.adalink.ai/v1/invitations/INVITE_ID \
  -H "Authorization: Bearer SEU_TOKEN"

Times + permissões + flags

Permissões de time entram com effect: GRANT ou DENY. DENY sempre vence. Feature flags do time são overrides — quando não há override, vale o default da org/plataforma.

curl

# Criar time
curl -X POST https://api.adalink.ai/v1/teams \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Marketing", "description": "Time de marketing e crescimento" }'

# Adicionar membro
curl -X POST https://api.adalink.ai/v1/teams/TEAM_ID/members \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "USER_ID" }'

# Conceder permissao especifica ao time
curl -X POST https://api.adalink.ai/v1/rbac/teams/TEAM_ID/grants \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "permissionKey": "agents:create", "effect": "GRANT" }'

Mudar o papel de um usuário: PATCH /v1/organizations/current/members/{userId} com { "role": "ADMIN" }. Remover: DELETE /v1/organizations/current/members/{userId}.