Passar para o conteúdo principal

dim_user

Cadastro de usuários

Escrito por Caroline Silva

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

email

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
disparos
admin
supervisor
marketing
(Se houver mais de um será separado por "|")

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

Respondeu à sua pergunta?