Principal Conversas e Dashboard | Monitorando a ClaudIA Como obter uma tabela com os dados crus da ClaudIA

Como obter uma tabela com os dados crus da ClaudIA

Última atualização em Sep 10, 2026

Quando usar

  • Você precisa analisar dados crus das conversas da ClaudIA fora do painel
  • Você quer cruzar métricas da ClaudIA com dados do seu próprio sistema (CRM, BI, data lake)
  • Você quer consultar uma conversa de forma programática, a partir do seu ambiente

Pré-requisitos

  • Acesso ao Cloud Chat do seu projeto, como supervisor, CX Engineer ou administrador — para o Construtor de Relatórios
  • Para os caminhos técnicos (Data Export e API): um time técnico ou de dados do seu lado

Sobre este artigo

Existem hoje três caminhos para ter os dados da ClaudIA em formato de tabela. Qual escolher depende de quem vai consumir: uma pessoa da operação, o BI da sua empresa, ou um sistema.

Como funciona

1 — Construtor de Relatórios (sem depender de time técnico)

Monte suas próprias tabelas, filtros e cruzamentos direto no Cloud Chat, usando o Tópico ClaudIA: conversas, mensagens, respostas geradas, feedbacks de auditoria, CSAT e conteúdos da base. Exporta em CSV, XLSX ou JSON.

É o caminho mais rápido, e o recomendado quando a sua operação não tem um time de dados dedicado.

2 — Data Export: dados brutos no seu data lake (S3)

Disponibilizamos um bucket S3 dedicado à sua empresa, com arquivos Parquet particionados por data e carga diária D-1 (hoje você acessa os dados de ontem para trás). É o caminho para BI e data lake, inclusive para juntar os dados de atendimento com outras fontes internas.

As tabelas da ClaudIA entregues no bucket:

Tabela Uma linha é
claudia_conversation uma conversa que a ClaudIA atendeu
claudia_messages uma mensagem trocada na conversa
claudia_prompt_revision uma chamada ao modelo, com os conteúdos usados e a ação que veio depois
claudia_contents um conteúdo da base de conhecimento
claudia_conversation_feedback uma auditoria feita por um agente humano
claudia_csat uma resposta de CSAT
eddie_result_outcomes uma execução de fluxo controlado e o seu resultado

Junto delas vão também as tabelas do Cloud Chat (conversas, contatos, tags, CSAT, métricas diárias por agente e por time). O id da conversa no Cloud Chat é a chave que amarra os dois lados.

O acesso é somente leitura, e o controle fica com vocês: seu time informa o identificador de um papel (role) da própria conta AWS de vocês e nós autorizamos esse acesso no bucket. Não emitimos credencial nossa para o seu time.

3 — API pública (consulta conversa a conversa)

Também temos API pública documentada. Ela serve para consultar e integrar, não para extração em lote:

  • API da ClaudIA — resumo de uma conversa (status, motivo de resolução, tag, se foi para N2 e as mensagens) e o trace de execução de uma mensagem processada
  • API do Cloud Chat — listar conversas, localizar uma conversa por qualquer identificador, listar mensagens, contatos, tags, caixas de entrada e times

A autenticação usa o login de um usuário do Cloud Chat da própria conta de vocês. As respostas são paginadas e os filtros seguem uma lista fixa de parâmetros — por isso, para carga histórica de BI, o caminho certo é o Data Export, não a API.

Como solicitar

  1. Construtor de Relatórios: já está disponível no Cloud Chat, na área de Relatórios.
  2. Data Export: peça ao seu ponto de contato na Cloud Humans (CSM) ou ao nosso suporte. O serviço não vem ligado por padrão. Nosso time provisiona o bucket, o seu time envia o identificador do papel (role) da AWS de vocês, e a entrega começa no dia seguinte.
  3. API: a documentação é pública, e a página Find your credentials da documentação técnica gera o token do seu usuário.

Observações