Cadastro de usuários
A tabela dim_user armazena o cadastro dos usuários da loja na plataforma: atendentes, supervisores, administradores, bots e acessos de API, com o perfil de cada um e se o acesso está ativo. Cada linha é um usuário, identificado pela coluna user_id, com o cadastro atual dele. Com dados atualizados de hora em hora, entre 6h e 22h (horário de Brasília); de madrugada não há atualização.
Exemplo
Uma loja tem uma atendente, uma supervisora que também atende, um bot e uma integração. Na tabela isso vira quatro linhas:
• user_id = 'ana123', name = 'Ana', roles = 'service', is_bot = false, disabled = false.
• user_id = 'bia456', name = 'Bia', roles = 'supervisor | service' (mais de um perfil na mesma coluna).
• user_id = 'bot789', name = 'Bot Atendimento', is_bot = true.
• user_id = 'api000', api_user = true, sem e-mail. Se a Ana for desligada, a linha dela continua na tabela, com disabled = true.
As colunas is_bot e api_user vêm vazias em boa parte dos usuários, principalmente nos cadastros mais antigos. Por isso, para separar atendentes humanos, use coalesce(is_bot, false) = false e coalesce(api_user, false) = false: o filtro is_bot = false sozinho descarta usuários que atendem normalmente. O mesmo vale para disabled.
Usuários desativados continuam na tabela, para que atendimentos antigos ainda tenham nome. Para contar a equipe atual, filtre coalesce(disabled, false) = false; para analisar o passado, não filtre. Quando o usuário tem mais de um perfil, roles junta os valores com ' | ' (ex.: 'admin | service'), e a ordem varia: use roles like '%supervisor%' em vez de igualdade.
O user_id é o mesmo que aparece nas tabelas de atendimento e na users_in_team. Em contas com mais de uma loja, use retailer_id para separar.
Atenção: Os registros desta tabela utilizam o fuso horário UTC, ou seja, para que as datas sejam referentes ao fuso horário brasileiro, é preciso inserir nas queries o fuso horário brasileiro.
SET TIME ZONE '-03:00';
SELECT tb.roles
,tb.roles
,tb.is_bot
,COUNT(tb.user_id) as qtd_usuarios
FROM dim_user AS tb
WHERE tb.created_at >= '2025-04-01'
AND tb.disabled = false
AND tb.api_user = false
GROUP BY tb.roles
,tb.roles
,tb.is_bot
;
Dicionário de dados
Variável | Tipo | Descrição | Obs |
api_user | boolean | Indica se este acesso é do tipo API | |
created_at | timestamp | Data de cadastro do usuário | |
disabled | boolean | Indica se o usuário está ativo/inativo | |
string | E-mail do usuário | ||
external_id | string | Código externo do usuário, quando informado (ex.: integração com outro sistema) | |
is_bot | boolean | Indica se o usuário é do tipo Bot | |
name | string | Nome do usuário | |
retailer_id | string | Código identificador da loja. Em contas com mais de uma loja, separa os registros de cada uma | Chave estrangeira para a tabela dim_retailer |
roles | string | Perfil do usuário | service |
sales_person_code | string | Código de vendedor do usuário, quando informado | |
updated_at | timestamp | Data da última atualização do usuário | |
user_id | string | Código identificador do atendente | Chave primária |
username | string | Nome de usuário cadastrado |
