Principal Métricas, dados e relatórios Explicação das tabelas e colunas do Construtor de Relatório (Report Builder) — Tópicos ClaudIA e Cloud Chat

Explicação das tabelas e colunas do Construtor de Relatório (Report Builder) — Tópicos ClaudIA e Cloud Chat

Última atualização em Jul 09, 2026

Quando usar

  • Você está montando um relatório nos novos relatórios e precisa entender quais tabelas e colunas estão disponíveis nos tópicos ClaudIA e Cloud Chat

  • Você quer entender o que cada campo significa antes de usar em uma análise

  • Você precisa identificar a tabela certa para uma análise específica (conversas, mensagens, CSAT, campanhas, métricas de agentes e times)

Sobre este artigo

Referência rápida das tabelas e colunas do novo módulo de relatórios, organizadas por tópico:

  • Tópico ClaudIA — dados das conversas atendidas pela ClaudIA (IA): conversas, mensagens, respostas geradas, feedbacks de auditoria, CSAT e conteúdos da base de conhecimento

  • Tópico Cloud Chat — dados operacionais do Cloud Chat: conversas, primeiras respostas, CSAT, tags, contatos, disparos ativos (campanhas) e métricas diárias de agentes e times

As colunas terminadas em Sk são chaves internas usadas para relacionar as tabelas entre si — não foram listadas abaixo. A coluna Etl Updated At, presente em várias tabelas, indica quando o registro foi atualizado pela última vez no data lake.

Tópico ClaudIA

1. claudia_conversation

Tabela principal das conversas atendidas pela ClaudIA. Cada linha é uma conversa.

Coluna Descrição
Cloudchat Id Identificador (UUID) da conversa na ClaudIA — é o elo com a coluna Conversation Uuid do Cloud Chat
Helpdesk Id Identificador do ticket no helpdesk integrado (ex.: Zendesk)
Creation Date / Update Date / Close Date Datas de criação, atualização e encerramento
Status Class Status da conversa
Is N2 Flag Se a conversa foi escalada para atendimento humano (N2)
Resolution Level Class Nível em que a conversa foi resolvida (N1 = IA, N2 = humano)
Conversation Id Identificador interno da conversa
Project Name Projeto (cliente) ao qual a conversa pertence
Application Identifier Class Canal/aplicação de origem da conversa
Low Confidence Count Value Respostas com baixa confiança na conversa
Enlightenment Question Count Value Perguntas de esclarecimento feitas pela IA
Resolution Retries Count Value Tentativas de resolução
Problem Resolved Question Sent Count Value Quantas vezes a IA perguntou se o problema foi resolvido
Unanswered Ticket Escalator Count Value Escalonamentos por falta de resposta do cliente
Activeintent Class Intenção ativa identificada na conversa
Active Flow Id / Active Flow Session Id Fluxo (Eddie) ativo e sessão do fluxo
Problem Solved Flag Se o cliente confirmou que o problema foi resolvido
Resolution Reason Motivo de resolução/encerramento
Resolution Reason Refined Motivo de resolução refinado (versão normalizada)
Tag Name Tag atribuída à conversa
Ab Key Name Chave do teste A/B em que a conversa participou
Gencx Value Nota GenCX — avaliação automática da qualidade da experiência
Gencx Reasoning Text Justificativa da nota GenCX
Frustration Score Value / Frustration Class Score e classificação de frustração do cliente
Frustration Reasoning Text Justificativa da classificação de frustração
Frustration Score Update Date Quando o score de frustração foi atualizado
Has Rate Limit Error Flag Se houve erro de limite de requisições na conversa

2. claudia_messages

Todas as mensagens trocadas nas conversas da ClaudIA.

Coluna Descrição
Message Id Identificador da mensagem
Project Name Projeto (cliente)
Cloudchat Id Conversa à qual a mensagem pertence
Sender Role Quem enviou (cliente, IA ou agente)
Content Text Conteúdo da mensagem
Send At Data e hora de envio
Private Flag Se é uma nota privada (não visível para o cliente)
Message Type Tipo da mensagem
Originated From Answer / Originated From Action Resposta ou ação que originou a mensagem
Originated From Enlightenment Limit Flag Se foi originada pelo limite de perguntas de esclarecimento
Originated From User Query Pergunta do cliente que originou a mensagem
Originated From Class Classificação da origem
Media Class Tipo de mídia (texto, imagem, áudio etc.)

3. claudia_prompt_revision

Cada linha é uma resposta gerada pela IA — útil para analisar o comportamento da ClaudIA resposta a resposta.

Coluna Descrição
Prompt Revision Id Identificador da resposta gerada
Cloudchat Id Conversa à qual a resposta pertence
Project Name Projeto (cliente)
Application Identifier Canal/aplicação de origem
Response Action Class Ação decidida pela IA (responder, escalar, reter etc.)
Enlightenment Limit Reached Flag Se o limite de perguntas de esclarecimento foi atingido
Originated From User Query Pergunta do cliente que originou a resposta
Response Class Classificação da resposta
Created At / Updated At Datas de criação e atualização
Response Raw Final Answer Resposta final gerada pela IA
Conversation Active Flow Id / Conversation Active Session Id Fluxo (Eddie) e sessão ativos no momento da resposta
Response Bot Flow Id / Response Bot Session Id Fluxo e sessão acionados pela resposta
Response Used Content Id Conteúdo principal da base de conhecimento usado na resposta
Response Used Content Id 1/2/3 Demais conteúdos considerados na resposta
Clarification Content Id 1/2/3 Conteúdos usados em perguntas de esclarecimento
Response Model Reasoning Raciocínio do modelo ao gerar a resposta
Response Error Message Mensagem de erro, quando a geração falhou
Frustration Score / Frustration Label / Frustration Reasoning Text Frustração do cliente no momento da resposta

4. claudia_conversation_feedback

Feedbacks de auditoria das conversas da ClaudIA (avaliações de qualidade).

Coluna Descrição
Conversation Feedback Id Identificador do feedback
Cloudchat Id Conversa avaliada
Project Name Projeto (cliente)
Client Problem Solved Flag Se o avaliador considerou o problema resolvido
General Feedback Text Feedback geral sobre a conversa
Error Impact Value Impacto do erro identificado (nota)
Conversation Properly Closed Flag Se a conversa foi encerrada corretamente
Conversation Should Scaled To N2 Flag Se deveria ter sido escalada para N2
Conversation Should Resolved N1 Flag Se deveria ter sido resolvida no N1
Is Tag Correct Flag / Right Tag Name Se a tag está correta e a tag sugerida
Created By Autor do feedback
Created At / Updated At Datas de criação e atualização

5. claudia_csat

Respostas de CSAT das conversas atendidas pela ClaudIA.

Coluna Descrição
Csat Id Identificador da pesquisa
Project Name Projeto (cliente)
Cloudchat Id Conversa associada
Helpdesk Id Ticket no helpdesk integrado
Csat Raw Value Valor bruto da resposta do cliente
Csat Value Nota numérica
Comment Text Comentário do cliente
Creation Date / Collect Date Criação da pesquisa e coleta da resposta

6. claudia_contents

Conteúdos da base de conhecimento da ClaudIA.

Coluna Descrição
Content Id Identificador do conteúdo
Project Name Projeto (cliente)
Content Title / Content Text / Content Response Text Título, texto e resposta do conteúdo
Tag Name Tag aplicada quando o conteúdo é usado
Is N2 Flag Se o conteúdo direciona a conversa para N2
Topic Name Tópico do conteúdo
Content Type Tipo do conteúdo
Flow Id Fluxo (Eddie) acionado pelo conteúdo, quando aplicável
Source Metadata Class Origem do conteúdo
Draft Flag / Disabled Flag / Excluded Flag Se está em rascunho, desativado ou excluído
Created At / Updated At Datas de criação e atualização

Tópico Cloud Chat

7. cloud_chat_conversations

Tabela principal das conversas do Cloud Chat. Cada linha é uma conversa (ticket), já com métricas de tempo e volume consolidadas.

Coluna Descrição
Conversation Id Identificador interno da conversa
Conversation Display Id ID que aparece na URL da conversa (ex.: .../app/accounts/1/conversations/{conversation_display_id})
Conversation Uuid Identificador (UUID) da conversa — é o elo com a coluna Cloudchat Id do tópico ClaudIA
Account Id / Account Name Conta associada
Customer Id / Instance Id Identificadores do ambiente (tenant)
Inbox Id / Inbox Name Caixa de entrada (canal)
Team Id / Team Name Time atribuído
Assignee Id / Assignee Name / Assignee Email Agente responsável
Agent Type Tipo do agente (humano ou IA)
Ai Agent Flag Se a conversa foi atendida por agente de IA
Contact Id / Contact Inbox Id Contato associado
Campaign Id Campanha que originou a conversa, quando aplicável
Status Code Status (aberta, resolvida, pendente, adiada)
Priority Code Prioridade da conversa
Tags List Lista de tags da conversa
Csat Value Nota de CSAT da conversa
Csat Sent Flag / Csat Responded Flag Se o CSAT foi enviado e respondido
Csat Response Submitted At Quando o CSAT foi respondido
Created At / Updated At Datas de criação e atualização
Client First Message At Primeira mensagem do cliente
First Reply Created At Primeira resposta ao cliente
Time To First Response Seconds/Minutes Tempo até a primeira resposta
Waiting Since Date Desde quando aguarda resposta
Snoozed Until Date Até quando está adiada
Contact/Agent/Assignee Last Seen At Últimas visualizações
Last Activity At Última atividade na conversa
Proactively Initiated Flag Se foi iniciada proativamente (disparo ativo)
Resolved Flag Se foi resolvida
Resolved At / Resolved At Date Quando foi resolvida
Is Conversation Recontact Flag Se é um recontato (cliente voltou em até 24h)
Minutes To Solve / Working Minutes To Solve Tempo até a resolução (corrido e em horário útil)
Minutes Waiting / Working Minutes Waiting Tempo aguardando resposta (corrido e em horário útil)
Minutes In Service / Working Minutes In Service Tempo em atendimento (corrido e em horário útil)
Messages Sent/Received In Conversation Mensagens enviadas pelo atendimento e recebidas do cliente
Contact Custom Fields / Conversation Custom Fields Campos personalizados do contato e da conversa

8. cloud_chat_conversations_first_reply_metrics

Métricas detalhadas de primeira resposta por conversa, incluindo primeira resposta humana após handoff da IA.

Coluna Descrição
Conversation Id / Conversation Display Id Identificadores da conversa
Customer Id / Instance Id / Account Id Identificadores do ambiente e da conta
Inbox Id / Inbox Name Caixa de entrada (canal)
Assigned Team Id / Assigned Team Name Time atribuído
Conversation Created At Criação da conversa
Client First Message At Primeira mensagem do cliente
First Reply Created At Primeira resposta ao cliente (IA ou humano)
First Responder Id/Name/Type Quem deu a primeira resposta e se foi IA ou humano
Time To First Response Seconds/Minutes Tempo até a primeira resposta
Human Handoff At Quando a conversa foi transferida da IA para humano
Human First Reply Created At Primeira resposta humana
First Human Responder Id/Name Primeiro agente humano a responder
Time To First Human Response After Handoff Seconds/Minutes Tempo entre o handoff e a primeira resposta humana

9. cloud_chat_csat

Respostas de CSAT das conversas do Cloud Chat, já enriquecidas com agente, time, caixa e contato.

Coluna Descrição
Conversation Id / Conversation Display Id Identificadores da conversa
Customer Id / Instance Id / Account Id Identificadores do ambiente e da conta
Conversation Created At Criação da conversa
Response Submitted At Quando o cliente respondeu a pesquisa
Csat Value Nota do cliente
Feedback Message Comentário do cliente
Tags List Tags da conversa
Assigned Agent Id / Assigned Agent Name Agente atribuído
Inbox Id / Inbox Name Caixa de entrada (canal)
Team Id / Team Name Time atribuído
Contact Id/Name/Phone Number Contato que respondeu

10. cloud_chat_conversations_tags

Tags aplicadas por conversa — cada linha é uma tag aplicada a uma conversa.

Coluna Descrição
Conversation Id / Conversation Display Id Identificadores da conversa
Customer Id / Instance Id / Account Id Identificadores do ambiente e da conta
Conversation Created At Criação da conversa
Tag Name Nome da tag aplicada
Tagged At Quando a tag foi aplicada
Assignee Name / Inbox Name / Team Name Agente, caixa e time da conversa

11. cloud_chat_conversations_custom_fields

Campos personalizados (custom fields) preenchidos por conversa — cada linha é um campo personalizado de uma conversa. Complementa a coluna Conversation Custom Fields da tabela cloud_chat_conversations (item 7), que traz os campos como um blob único: aqui cada campo vira uma linha, pronta para filtrar e pivotar.

Coluna Descrição
Conversation Id / Conversation Display Id Identificadores da conversa
Customer Id / Instance Id / Account Id Identificadores do ambiente e da conta
Conversation Created At Criação da conversa
Conversation Custom Field Name Nome do campo personalizado
Conversation Custom Field Value Valor preenchido no campo
Custom Field Updated At Quando o valor do campo foi atualizado pela última vez
Custom Attribute Id Identificador da definição do campo personalizado no Cloud Chat
Assignee Name / Inbox Name / Team Name Agente, caixa e time da conversa

12. cloud_chat_tags

Catálogo de tags cadastradas na conta.

Coluna Descrição
Tag Id Identificador da tag
Customer Id / Instance Id / Account Id Identificadores do ambiente e da conta
Tag Name / Tag Description Nome e descrição da tag
Created At / Updated At Datas de criação e atualização

13. cloud_chat_contacts

Contatos (clientes finais) cadastrados no Cloud Chat.

Coluna Descrição
Contact Id Identificador do contato
Customer Id / Instance Id / Account Id Identificadores do ambiente e da conta
Contact Name / Middle Name / Last Name Nome do contato
Contact Email / Contact Phone Number E-mail e telefone
Identifier Identificador externo do contato (ex.: ID no seu sistema)
Contact Type Tipo do contato
Location / Country Code Localização
Additional Attributes / Custom Attributes Atributos adicionais e personalizados
Blocked Flag Se o contato está bloqueado
Last Activity At Última atividade
Created At / Updated At Datas de criação e atualização

14. cloud_chat_outbound_events

Eventos de disparos ativos (campanhas e envios proativos) — cada linha é um envio para um contato, com o rastro completo de entrega.

Coluna Descrição
Customer Id Identificador do ambiente (tenant)
Conversation Id / Conversation Display Id Conversa gerada pelo disparo
Inbox Id / Inbox Name Caixa de entrada (canal) do disparo
Campaign Id / Campaign Name Campanha que originou o envio
Campaign Audience Name Audiência da campanha
Outbound Source Type Origem do disparo (campanha, API, envio unitário)
Created At Criação do evento
Message Sent Flag / Sent At Se o envio foi efetivado e quando
Message Received Flag / Received At Confirmação de entrega ao dispositivo e quando
Message Read Flag / Read At Recibo de leitura e quando
Message Replied Flag / Replied At Se o destinatário respondeu e quando
Error Code / Error Category Código e categoria do erro, quando o envio falha

15. cloud_chat_outbound_events_funnel_chart

Visão agregada dos disparos ativos em formato de funil (enviado → recebido → lido → respondido), pronta para gráficos.

Coluna Descrição
Customer Id Identificador do ambiente (tenant)
Event Created At Data do evento
Campaign Name / Campaign Audience Name Campanha e audiência
Inbox Name Caixa de entrada (canal)
Stage Name Etapa do funil (enviado, recebido, lido, respondido)
Event Count Quantidade de eventos na etapa

16. cloud_chat_agent_metrics

Métricas diárias consolidadas por agente — uma linha por agente por dia.

Coluna Descrição
Agent Id / Agent Name Agente
Customer Id Identificador do ambiente (tenant)
Metric Date Data de referência das métricas
Tickets Created Assigned Tickets criados atribuídos ao agente no dia
Tickets Resolved Assigned Tickets resolvidos pelo agente no dia
Sum (Working) Minutes To Solve Soma dos tempos de resolução (corrido e em horário útil)
Sum (Working) Minutes In Service Soma dos tempos em atendimento (corrido e em horário útil)
Sum (Working) Minutes Waiting Soma dos tempos de espera (corrido e em horário útil)
Tickets Resolved With Recontact 24h Tickets resolvidos em que o cliente voltou em até 24h
Csat Responses / Csat Positive Responses Respostas de CSAT recebidas e positivas
First Reply Tickets Count / Sum First Reply Minutes Tickets com primeira resposta do agente e soma dos tempos
First Reply After Handoff Tickets Count / Sum First Reply After Handoff Minutes Tickets com primeira resposta humana após handoff da IA e soma dos tempos

Para calcular médias (ex.: tempo médio de resolução), divida a coluna de soma pela contagem correspondente — ex.: Sum Minutes To Solve ÷ Tickets Resolved Assigned.

17. cloud_chat_team_metrics

A tabela é idêntica a cloud_chat_agent_metrics, com a seguinte diferença:

As métricas são agregadas por time (Team Id / Team Name) em vez de por agente — uma linha por time por dia.

Cruzando ClaudIA e Cloud Chat

As tabelas dos dois tópicos se conectam pela conversa: a coluna Cloudchat Id (tópico ClaudIA) corresponde à coluna Conversation Uuid (tópico Cloud Chat). Esse relacionamento já está configurado — ao montar uma análise, basta combinar campos dos dois lados.

Observações