Quando usar
- Você está montando um relatório no Report Builder e precisa entender quais colunas estão disponíveis em cada tabela
- Você quer entender o que cada campo significa antes de usar
- Você precisa identificar a tabela certa para uma análise específica (CSAT, conversas, mensagens, eventos)
Sobre este artigo
Esta FAQ apresenta uma referência rápida das colunas disponíveis no Report Builder, organizadas por tabela.
Para o passo a passo de uso do construtor: Como usar o Construtor de Relatórios (Report Builder).
1. account_user_availability_histories
| Coluna | Descrição |
|---|---|
Event Id |
Identificador único do evento |
Agent Id |
Identificador único do agente |
Agent |
Nome do agente |
Availability |
Status do agente (online, offline, ocupado) |
Availability Reason Id |
Razão da mudança de status |
Created At |
Data e hora do registro |
2. agents
| Coluna | Descrição |
|---|---|
User Id |
Identificador único do agente |
Email |
E-mail do agente |
Name |
Nome completo |
Assignment Limit |
Limite máximo de tickets simultâneos |
3. conversation_events
| Coluna | Descrição |
|---|---|
Id |
Identificador único do evento |
Name |
Tipo do evento |
Value |
Detalhes adicionais do evento |
Account Id |
Identificador da conta |
Inbox Id |
Caixa de entrada associada |
User Id |
Usuário relacionado ao evento |
Conversation Id |
Conversa associada |
Created At |
Data e hora de criação |
Updated At |
Última atualização |
Instance |
Instância específica |
4. conversations
| Coluna | Descrição |
|---|---|
Created At |
Criação da conversa |
Id |
Identificador interno |
Display Id |
Identificador exibido ao usuário |
Assignee Id |
Agente responsável |
Inbox Id |
Caixa de entrada associada |
Agent Type |
Tipo do agente (humano/IA) |
Repeats In Last 24h |
Conversas repetidas em 24h |
Conversation Custom Field Name |
Nome do campo personalizado da conversa |
Conversation Custom Field Value |
Valor preenchido nos campos personalizados |
Para análises e relatórios mais visuais, use ambas as colunas Conversation Custom Field Name e Conversation Custom Field Value em conjunto.
5. csat
| Coluna | Descrição |
|---|---|
Assignee Name/Email/Id |
Informações do agente atribuído |
Contact Name/Email/Number/Id |
Informações do cliente |
Csat Id |
Identificador da pesquisa |
Inbox Id |
Caixa de entrada associada |
Rating |
Nota do cliente (1 a 5) |
Rating Emoji |
Emoji associado |
Feedback Message |
Comentários adicionais |
Created At |
Data da resposta |
Display Id |
Identificador visível do ticket |
Ticket Link |
Link direto ao ticket |
Agent Type |
Agente IA ou humano |
6. inboxes
| Coluna | Descrição |
|---|---|
Id |
Identificador único |
Name |
Nome da caixa |
7. messages
| Coluna | Descrição |
|---|---|
Id |
Identificador da mensagem |
Instance / Account Id / Inbox Id |
Identificadores relacionados |
Conversation Id |
Conversa associada |
Message Type |
Tipo de mensagem |
Created At / Updated At |
Datas de criação e atualização |
Private |
Privacidade da mensagem |
Status |
Status da mensagem |
Source Id |
Origem da mensagem |
Content Type |
Tipo de conteúdo |
Content |
Conteúdo da mensagem |
Content Attributes |
Atributos adicionais |
Sender Type/Id |
Remetente |
Processed Message Content |
Conteúdo tratado |
Conversation display id |
ID que aparece na URL da conversa (ex: https://cloudchat.cloudhumans.com/app/accounts/1/conversations/{conversation_display_id}) |
8. tags
| Coluna | Descrição |
|---|---|
Id |
Identificador da tag |
Title |
Nome da tag |
Description |
Descrição |
Color |
Cor associada |
9. teams
| Coluna | Descrição |
|---|---|
Id |
Identificador do time |
Name |
Nome do time |
Description |
Função ou composição |
Allow Auto Assign |
Atribuição automática ativada |
Account Id |
Conta associada |
Created At / Updated At |
Datas relevantes |
Working Hours Enabled |
Horários configurados |
Out Of Office Message |
Mensagem fora de horário |
Timezone |
Fuso horário do time |
Instance |
Instância específica |
10. campaign_delivery_events
| Coluna | Descrição |
|---|---|
Campaign Delivery Events ID |
Identificador único do evento de entrega |
Campaign ID |
ID da campanha que originou o envio |
Contact ID |
ID do contato/destinatário |
Conversation ID |
ID da conversa onde o evento ocorreu |
Message Sent |
Se o disparo foi efetivamente enviado pelo sistema |
Sent At |
Data e hora do envio |
Message Received |
Confirmação de entrega ao dispositivo |
Received At |
Data e hora da confirmação de entrega |
Message Read |
Recibo de leitura do destinatário |
Read At |
Data e hora da leitura |
Message Replied |
Se o destinatário respondeu |
Replied At |
Data e hora da resposta |
Error |
Mensagem de erro quando há falha |
Created At / Updated At |
Datas do registro |
Instance |
Tenant em que o evento foi registrado |
Campaign display id |
ID que aparece na URL da campanha |
Conversation display id |
ID que aparece na URL da conversa |
Inbox ID |
ID da caixa (canal) |
Title |
Nome da campanha |
Audience |
Audiência da campanha |
11. proactive_delivery_events
A tabela é similar a campaign_delivery_events, com a seguinte diferença:
Não possui Campaign ID, Title ou Audience — por ser enviada via API ou disparo unitário pelo Cloud Chat, esses campos não existem.
Observações
-
Para o passo a passo do Report Builder: Como usar o Construtor de Relatórios (Report Builder)
-
Para a versão v2 do construtor: Guia básico do Construtor de Relatórios v2
-
Para extrair dados crus dessas tabelas via API: Como extrair dados em lote via API (Data Extract API)