Retorna todos os operadores vinculados ao host do token, incluindo informações do usuário associado e os perfis de acesso por avatar. Usuários com role de administrador interno (Tolky) são automaticamente excluídos da resposta.

​
Endpoint

POST /api/externalAPIs/public/tolkyReasoning/hosts/listPeople

​
Parâmetros

deleted
boolean
default: "false"

Quando true, inclui também os operadores marcados como excluídos (deleted = true). Por padrão, apenas operadores ativos são retornados.

​
Exemplo

curl -X POST '{{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/hosts/listPeople' \
  -H 'Authorization: Bearer {TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{}'

​
Com operadores excluídos

curl -X POST '{{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/hosts/listPeople' \
  -H 'Authorization: Bearer {TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{"deleted": true}'

​
Resposta

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "uuid-do-host-people",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-03-20T14:00:00Z",
      "lastTaskAssignedAt": "2026-03-25T09:15:00Z",
      "hostId": "uuid-do-host",
      "userId": "uuid-do-user",
      "role": "atendente",
      "active": true,
      "userName": "Maria Silva",
      "email": "maria@empresa.com",
      "phone": "+5511999999999",
      "description": "Operadora de atendimento",
      "deleted": false,
      "visible": true,
      "platformRole": "operator",
      "hostPeopleRoleId": "uuid-da-role",
      "accessProfileId": "uuid-do-perfil",
      "avatarAccessMode": "full",
      "bannedUntil": null,
      "availability": "available",
      "user": {
        "userFirstName": "Maria",
        "userName": "Maria Silva",
        "email": "maria@empresa.com",
        "phone": "+5511999999999"
      },
      "avatarProfiles": [
        {
          "profileName": "Atendimento Geral",
          "subSlug": "atendimento-geral"
        },
        {
          "profileName": "Suporte Técnico",
          "subSlug": "suporte-tecnico"
        }
      ]
    }
  ]
}

​
Campos da Resposta

data
array

Lista de operadores do host.

​
Erros

CódigoDescrição
400Host ID não encontrado para o token fornecido
403Token ausente ou inválido
500Erro interno do servidor

​
Notas

  • Requer token Bearer no header Authorization.
  • O token deve estar associado a um host com hostId válido.
  • Operadores com role de administrador interno (Tolky) ou superadmin são automaticamente excluídos da resposta por segurança.
  • O campo authUserId é omitido da resposta por segurança.
  • Quando deleted não é informado ou é false, apenas operadores com deleted = false são retornados.
Criar HostListar Datasets