Passar para o conteúdo principal

dim_bot_interaction

Detalhamento dos fluxos que os clientes percorreram com os Bots durante os atendimentos.

Escrito por Caroline Silva

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
webchat
WEBCHAT
instagram
FBMESSENGER
messenger
any
WAB-OMNICHAT
INSTAGRAM
WPP

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
STICKER
LOCATION
VCARD
WHIZZ_INACTIVITY
IMAGE
WHIZZ
BUTTON
null
INTERACTIVE
VIDEO
TEXT
LIST
COLLECTION
FILE
GROUPED
DOCUMENT

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
BOT

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

Respondeu à sua pergunta?