Detalhamento dos fluxos que os clientes percorreram com os Bots durante os atendimentos.
A tabela dim_bot_interaction armazena cada passo das conversas entre os clientes e os bots: as mensagens do bot, as respostas do cliente e os eventos do fluxo, com a intenção atual e a anterior. Cada linha é uma interação, identificada pelo uuid. Com dados atualizados em H-1 (de hora em hora, com pausa durante a madrugada).
Exemplo
Um cliente que recebe o menu do bot e escolhe uma opção gera, entre outras, as linhas abaixo no mesmo chat_id:
• type = BOT, message_type vazio, intent_name = Boas-vindas, last_intent_name vazio: o bot entra na primeira etapa do fluxo, sem mensagem associada.
• type = BOT, message_type = LIST, intent_name = Menu principal, last_intent_name = Boas-vindas: o bot envia a lista de opções às 10:00.
• type = CUSTOMER, message_type = INTERACTIVE, intent_name = Menu principal: o cliente escolhe a opção Financeiro às 10:01.
• type = BOT, message_type = WHIZZ, intent_name = Atendimento IA, last_intent_name = Menu principal: o assistente de IA responde às 10:02.
Use type para separar o que o bot fez (BOT) do que o cliente fez (CUSTOMER). Muitas linhas do bot não têm mensagem: são passagens por etapas do fluxo, com message_type e message vazios. Para contar mensagens enviadas, filtre message_type não vazio. Linhas com is_event = true são eventos automáticos, como o aviso de inatividade (message_type = WHIZZ_INACTIVITY).
Para montar o caminho do fluxo, agrupe intent_name com last_intent_name (intenção anterior). Na primeira interação do chat, last_intent_id fica vazio. A mesma conversa pode passar por mais de um bot, então agrupe também por bot_id quando analisar fluxos.
As colunas token, stage e bot_version vêm vazias e tools traz sempre os mesmos valores nulos, então não use essas colunas em análises. A coluna timestamp é a data da interação em segundos (epoch). Para filtrar período, prefira created_at junto com approximate_arrival_date, que deixa a consulta mais rápida.
SET TIME ZONE '-03:00';
SELECT DISTINCT tb.bot_name
,tb.channel_type
,tb.intent_name as stage1
,tb.last_intent_name as stage2
,COUNT(tb.uuid) as qtd_interacoes
FROM dim_bot_interaction AS tb
WHERE tb.created_at >= '2025-04-01'
AND tb.type = 'BOT'GROUP BY ALL
;
Dicionário de dados
Variável | Tipo | Descrição | Obs |
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
|
approximate_arrival_date | date | [Em validação] |
|
bot_id | string | Código identificador do Bot que efetuou a interação | Chave estrangeira para a tabela dim_bot |
bot_name | string | Nome do Bot |
|
bot_version | string | Versão do Bot |
|
channel_type | string | Nome do canal utilizado pelo Bot na interação | whatsapp |
chat_id | string | Código identificador da conversa | Chave estrangeira para a tabela dim_customer_support_request |
created_at | timestamp | Data da interação |
|
customer_id | string | Código identificador do cliente | Chave estrangeira para a tabela dim_customer |
intent_id | string | Código identificador da intenção utilizada pelo Bot | Chave estrangeira para a tabela dim_bot_intent |
intent_name | string | Nome da intenção do Bot |
|
is_event | boolean | Indica se a interação é do tipo evento |
|
last_intent_id | string | Código identificador da intenção anterior a que gerou o registro atual | Chave estrangeira para a tabela dim_intent |
last_intent_name | string | Nome da intenção da interação anterior |
|
message | string | Texto da mensagem utilizada na interação |
|
message_type | string | Tipo da mensagem que foi utilizada na interação | AUDIO |
mp_lib | string | Nome da biblioteca utilizada pelo Bot |
|
not_handled | boolean | Indica se o Bot não conseguiu lidar com a solicitação do cliente. |
|
quoted_message | string | Ponteiro para o array da mensagem respondida |
|
stage | string | Estágio e ambiente de maturidade do Bot | NULL |
timestamp | bigint | Data da interação do Bot |
|
token | string | Token utilizado pelo Bot na interação |
|
tools | string | Json contendo as ferramentas e tokens utilizados pelo Bot na interação |
|
type | string | Tipo de interação do Bot | CUSTOMER |
updated_at | timestamp | Data da última atualização da interação com o Bot |
|
uuid | string | Código identificador da interação do Bot | Chave primária |
version | string | Versão do projeto do botmaker-backend |
