Usuários (Platform API)

Gerencie usuários da plataforma NooviChat. Estes endpoints usam a Platform API para criar, atualizar e gerenciar usuários globais.

Platform API

Todos os endpoints usam o prefixo /platform/api/v1/users e requerem token de plataforma.

POST/platform/api/v1/users

Cria um novo usuário na plataforma.

Body

NomeTipoObrigatorioDescricao
namestringSimNome do usuário
emailstringSimEmail único
passwordstringSimSenha (min 6 caracteres)
display_namestringNaoNome de exibição
custom_attributesobjectNaoAtributos personalizados
bash
curl -X POST "https://chat.seudominio.com/platform/api/v1/users" \
  -H "api_access_token: PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Santos",
    "email": "maria@empresa.com",
    "password": "senha_segura_123"
  }'
200Usuário criado (inclui access_token e contas vinculadas; não há created_at)
json
{
  "id": 10,
  "name": "Maria Santos",
  "display_name": null,
  "email": "maria@empresa.com",
  "access_token": "<token de acesso do usuário>",
  "available_name": "Maria Santos",
  "avatar_url": "",
  "confirmed": true,
  "role": null,
  "accounts": []
}
GET/platform/api/v1/users/{id}

Retorna detalhes de um usuário.

bash
curl -s "https://chat.seudominio.com/platform/api/v1/users/10" \
  -H "api_access_token: PLATFORM_TOKEN" | jq .
PATCH/platform/api/v1/users/{id}

Atualiza dados de um usuário.

Body

NomeTipoObrigatorioDescricao
namestringNaoNome
emailstringNaoEmail
passwordstringNaoNova senha
display_namestringNaoNome de exibição
custom_attributesobjectNaoAtributos personalizados
DELETE/platform/api/v1/users/{id}

Remove um usuário da plataforma.

bash
curl -X DELETE "https://chat.seudominio.com/platform/api/v1/users/10" \
  -H "api_access_token: PLATFORM_TOKEN"
GET/platform/api/v1/users/{id}/login

Gera um link SSO para login direto do usuário.

bash
curl -s "https://chat.seudominio.com/platform/api/v1/users/10/login" \
  -H "api_access_token: PLATFORM_TOKEN" | jq .
200Link de login SSO
json
{ "url": "https://chat.seudominio.com/auth/sign_in?token=sso_token_abc123" }