Passar para o conteúdo principal

dim_chat_labels

Detalhamento sobre as conversas

Escrito por Caroline Silva

Detalhamento sobre as conversas

A tabela dim_chat_labels armazena as etiquetas aplicadas às conversas, junto com a situação atual de cada conversa (estado, atendente, time, última mensagem e dados do contato). Cada linha é uma etiqueta em uma conversa: a combinação de chat_id e label_id. Conversas sem etiqueta não aparecem nesta tabela. Com dados atualizados de hora em hora, entre 6h e 22h (horário de Brasília); de madrugada não há atualização.


​Exemplo

A conversa chat789 tem duas etiquetas, "Matrícula" e "Retorno". Na tabela ela aparece em duas linhas:


• chat_id = chat789, label_id = lbl001 e tag = Matrícula.


• chat_id = chat789, label_id = lbl002 e tag = Retorno.


• As demais colunas, como internal_state, last_message_date e meta, se repetem nas duas linhas, e a coluna labels traz a lista completa das duas etiquetas nas duas linhas.


Como uma conversa aparece uma vez para cada etiqueta, para contar conversas use COUNT(DISTINCT chat_id). Para contar conversas no total, incluindo as que não têm etiqueta, use a tabela dim_chat, que tem as mesmas colunas e uma linha por conversa.


A coluna tag_creation_date é a data em que a etiqueta foi criada na loja, não a data em que ela foi colocada na conversa. Em poucas linhas tag vem vazia; nesses casos use label_id.


As colunas created_ad e update_at são cópias de created_at e updated_at. Use created_at e updated_at.


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 DISTINCT tb.tag as etiqueta

,COUNT(tb.chat_id) as qtd_conversas

FROM dim_chat_labels AS tb

WHERE tb.created_ad >= '2025-04-01'

GROUP BY ALL

ORDER BY qtd_conversas DESC

;

Dicionário de dados

Variável

Tipo

Descrição

Obs

chat_id

string

Identificador único da conversa de atendimento.

label_id

string

Identificador do rótulo associado à conversa ou atendimento.

customer_cel_number

string

Número de celular do cliente participante da conversa.

created_ad

timestamp

Fazer uso do campo created_at, a coluna created_ad será removida até 28/11/2025

update_ad

timestamp

Fazer uso do campo updated_at, a coluna update_ad será removida até 28/11/2025

created_at

timestamp

Data e hora em que a conversa foi criada.

updated_at

timestamp

Data e hora da última atualização da conversa.

retailer_id

string

Identificador único do estabelecimento.

order_id

string

Identificador do pedido relacionado à conversa.

customer_id

string

Identificador único do cliente.

csr_id

string

Identificador do atendente (Customer Service Representative) responsável pela conversa.

campaign_omni_id

string

Identificador da campanha associada à conversa.

last_finished_by

string

Identificador do usuário que finalizou a última interação da conversa.

last_message_id

string

Identificador da última mensagem enviada na conversa.

origin_team_id

string

Identificador do time de origem da conversa.

contact_owner

string

Identificador do responsável pelo contato do cliente.

pipeline_stage

string

Etapa do funil de vendas ou atendimento em que a conversa se encontra.

sales_person_id

string

Identificador do vendedor associado à conversa.

team_id

string

Identificador do time responsável pela conversa.

first_Unanswered_Message_Date

timestamp

Data e hora da primeira mensagem não respondida na conversa.

snoozed_until_date

timestamp

Data e hora até quando a conversa está adiada (snooze).

last_message_date

timestamp

Data e hora da última mensagem enviada na conversa.

expires_at

timestamp

Data e hora em que a conversa expira ou é encerrada automaticamente.

client_platform

string

Plataforma utilizada pelo cliente (ex: WhatsApp, Messenger, etc.).

fb_messenger_id

string

Identificador do cliente na plataforma Facebook Messenger.

internal_state

string

Estado interno da conversa (ex: aberta, fechada, pendente).

last_message_client_platform

string

Plataforma utilizada pelo cliente na última mensagem.

platform

string

Plataforma geral da conversa (ex: web, mobile, etc.).

retailer_chat_id

string

Identificador da conversa do lojista.

is_replied

boolean

Indica se a última mensagem foi respondida (true/false).

tag

string

Etiqueta ou marcação associada à conversa.

tag_creation_date

string

Data de criação da etiqueta

meta

string

Tag de configuração do consumidor na Meta

labels

string

Rótulo associado à conversa.

Respondeu à sua pergunta?