📥 Relatórios

Exportar dados e relatórios do Chatys para CSV/Excel

O Chatys permite exportar praticamente todos os seus dados para análise externa — histórico de conversas, base de contatos, métricas de atendimento, resultados de campanhas e mais. A exportação é útil para análises avançadas em ferramentas de BI (Power BI, Looker, Google Sheets), compliance com regulamentações de dados, migração para outras plataformas ou simplesmente para ter um backup offline das informações mais importantes do seu negócio.

Permissões para exportação: Exportar conversas e contatos requer perfil Administrador ou Supervisor. Agentes podem exportar apenas seus próprios dados (conversas atribuídas a eles). Todas as exportações são registradas no Log de Auditoria da conta.

Exportar histórico de conversas

O histórico de conversas é a exportação mais completa — inclui todas as mensagens trocadas, metadados das conversas e informações de atendimento. Útil para auditoria, treinamento de equipe ou migração de plataforma.

Dashboard de Resultados do Chatys com opção de exportação de dados

Dashboard de Resultados — acesse a exportação de dados pelo botão de download no canto superior direito de cada relatório.

1
Acesse Resultados no menu lateral e clique na aba Conversas.
2
Use os filtros para selecionar o escopo da exportação: período (data início e fim), canal (WhatsApp, Instagram, todos), agente responsável, status (abertas, resolvidas, pendentes) e tags aplicadas.
3
Clique em "Exportar" (ícone de download) no canto superior direito. Selecione o formato: CSV (para planilhas e BI) ou Excel (.xlsx) (para análise direta no Microsoft Excel ou Google Sheets).
4
Para exportações grandes (acima de 10.000 conversas), o arquivo será gerado em segundo plano e um link de download será enviado por e-mail ao Admin em até 30 minutos.
5
Clique no link do e-mail ou em Resultados → Exportações Recentes para baixar o arquivo gerado. Os links de download ficam disponíveis por 48 horas.

O arquivo de conversas exportado inclui as seguintes colunas:

  • conversa_id — Identificador único da conversa
  • contato_nome, contato_telefone — Dados do contato
  • canal — WhatsApp ou Instagram
  • agente_nome, agente_email — Responsável pelo atendimento
  • departamento — Departamento da conversa
  • data_inicio, data_fim — ISO 8601 (ex: 2025-01-15T14:30:00-03:00)
  • status — aberta, resolvida, pendente
  • tma_segundos — Tempo médio de resposta em segundos
  • tmr_segundos — Tempo de resolução em segundos
  • csat_nota, csat_comentario — Avaliação de satisfação, se aplicável
  • tags — Tags aplicadas, separadas por vírgula
  • mensagens_json — Histórico completo em JSON (apenas exportação completa)
Exportação de mensagens individuais: Para exportar o conteúdo de cada mensagem (não apenas os metadados), selecione "Incluir conteúdo das mensagens" antes de exportar. Isso aumenta significativamente o tamanho do arquivo. A exportação com mensagens é restrita ao perfil Admin por questões de privacidade.

Exportar lista de contatos/clientes

A exportação de contatos gera um arquivo com toda a sua base de clientes e leads, incluindo campos personalizados, tags e histórico resumido. Essencial para migração para outro CRM, campanhas de e-mail ou enriquecimento de dados.

1
Acesse Clientes no menu lateral.
2
Aplique os filtros desejados na barra lateral: por tag, por canal de origem, por data do primeiro contato, por status (ativo, inativo) ou por campo personalizado.
3
Clique em "Exportar contatos" no topo da lista. Você pode exportar apenas os contatos filtrados ou toda a base.
4
Selecione quais campos incluir na exportação: campos padrão (nome, telefone, e-mail, criado em) e/ou campos personalizados criados para sua conta.
5
Clique em "Gerar arquivo". O download começa imediatamente para bases menores que 5.000 contatos. Acima disso, o link chega por e-mail.
LGPD e exportação de dados pessoais: A exportação de contatos contém dados pessoais (nome, telefone, e-mail). Trate o arquivo exportado com os cuidados exigidos pela Lei Geral de Proteção de Dados (LGPD): armazene em local seguro, com acesso restrito, e não compartilhe com terceiros sem a devida base legal de tratamento.

Exportar métricas e relatórios

Os relatórios de métricas de atendimento são exportados diretamente das telas de análise. Cada dashboard e relatório tem seu próprio botão de exportação com opções de formato e período.

Relatório de desempenho de agentes do Chatys com métricas individuais exportáveis

Relatório de Desempenho de Agentes — exporte para Excel com gráficos e comparativos individuais de cada membro da equipe.

Relatórios disponíveis para exportação:

  • Dashboard KPIs (geral): Exporta todos os KPIs do período selecionado: conversas abertas, resolvidas, TMA, TMR, FCR, CSAT. Formato CSV ou Excel com gráficos embutidos.
  • Desempenho por Agente: Relatório individual de cada agente com suas métricas. Acesse Resultados → Desempenho → Exportar. Inclui ranking comparativo e evolução temporal por agente.
  • Volume por canal: Distribuição de conversas por canal (WhatsApp vs Instagram) ao longo do período. Útil para decisões de investimento em canais.
  • Mapa de calor de horários: Exporta os dados do mapa de calor de volume por hora e dia da semana. Útil para escalar a equipe nos horários de pico.
  • Satisfação (CSAT): Todas as avaliações recebidas no período, com nota, comentário, agente que atendeu e data. Acesse Resultados → Satisfação → Exportar.
1
Em qualquer tela de Resultados, selecione o período desejado no seletor de data (canto superior direito).
2
Aplique os filtros necessários (canal, agente, departamento).
3
Clique no ícone de download (seta para baixo) no canto da tela. Selecione o formato de saída.
4
Para Excel com gráficos: os gráficos do dashboard são replicados automaticamente no arquivo Excel como gráficos editáveis. Útil para apresentações e relatórios executivos.

Exportar dados de broadcast

Cada campanha de broadcast gera um relatório completo de entrega e engajamento. Esses dados podem ser exportados para análise de desempenho das suas campanhas de marketing.

1
Acesse Campanhas no menu lateral e selecione a campanha desejada clicando sobre ela.
2
Na tela de detalhes da campanha, clique em "Exportar relatório".
3
O arquivo gerado inclui, para cada destinatário: número de telefone, nome do contato, status de entrega (Enviado, Entregue, Lido, Falhou), data/hora de cada status e se houve resposta.
4
Para exportar o relatório consolidado de MÚLTIPLAS campanhas, acesse Resultados → Broadcasts → Exportar período. Selecione o período e todos os relatórios de campanhas do período são consolidados em um único arquivo.
Análise de taxa de resposta: Use o campo respondeu no arquivo exportado para identificar quais contatos responderam ao broadcast e fazer follow-up personalizado. Filtre os contatos com respondeu=S e importe de volta ao Chatys com uma nova tag para segmentação.

Formato e estrutura dos arquivos exportados

Compreender a estrutura dos arquivos exportados facilita a integração com outras ferramentas e evita problemas de codificação de caracteres ou formato de datas.

  • Codificação: Todos os arquivos CSV são gerados em UTF-8 com BOM. O BOM (Byte Order Mark) garante que o Excel no Windows reconheça automaticamente os caracteres especiais (acentos, cedilha) sem necessidade de conversão manual.
  • Separador de campos: O separador padrão é ponto e vírgula (;) para compatibilidade com o Excel em português (que usa ; como separador padrão no Brasil). Para importar em ferramentas que usam vírgula, selecione "Separador: Vírgula" nas opções de exportação.
  • Formato de datas: Todas as datas são exportadas no formato ISO 8601 com timezone: 2025-01-15T14:30:00-03:00. Ao importar no Excel, formate a coluna como Data e Hora personalizada: DD/MM/AAAA HH:MM.
  • Valores numéricos: Números decimais usam ponto (.) como separador decimal — padrão internacional. Se o Excel exibir como texto, selecione as colunas numéricas → Dados → Texto para Colunas → Ponto como separador decimal.
  • Campos com múltiplos valores (tags): Campos que podem ter múltiplos valores (como tags) são separados por pipe (|) dentro de um único campo: cliente-vip|lead-quente|follow-up.
  • Campos vazios: Campos sem valor são exportados como células vazias (não como "null" ou "N/A"), para facilitar o tratamento em planilhas e scripts.

Agendando exportações automáticas

Para equipes que precisam de relatórios periódicos sem intervenção manual — como um relatório semanal enviado toda segunda-feira — o Chatys suporta exportações agendadas e integração via API para automação completa.

1
Em qualquer relatório, clique em "Agendar exportação" (disponível no plano Pro e Enterprise).
2
Configure a frequência: diária (todos os dias às X horas), semanal (dia da semana específico) ou mensal (dia do mês).
3
Selecione o período do relatório: "Últimas 24 horas", "Última semana", "Último mês" ou período fixo.
4
Informe os e-mails destinatários que receberão o arquivo automaticamente. Você pode adicionar e-mails externos à conta (ex: para o gestor que não usa o Chatys).
5
Para integração direta com Google Sheets, Power BI ou Looker via API REST, acesse a documentação em developers.chatys.com.br. O endpoint GET /api/v1/reports/export retorna os dados em JSON ou CSV com os mesmos filtros disponíveis na interface.
Integração com Google Sheets: Use o Google Apps Script para importar automaticamente os dados do Chatys via API REST para uma planilha do Google. A cada execução agendada (ex: toda segunda às 9h), os dados são atualizados na planilha sem ação manual. Consulte a documentação da API em developers.chatys.com.br para exemplos de código.

Casos de uso — como aplicar no seu negócio

Veja como empresas de diferentes segmentos usam a exportação de dados do Chatys para análise, compliance e integração com outros sistemas:

🛍️ E-commerce e lojas online

Uma loja de calçados exporta a base de contatos todo primeiro dia do mês para enriquecer o CRM principal no HubSpot. O arquivo CSV com nome, telefone, tags e histórico de atendimento é importado com mapeamento de campos configurado uma única vez — nas exportações seguintes, o processo leva menos de 3 minutos. Contatos que interagiram no WhatsApp mas nunca compraram são segmentados no HubSpot para receber e-mail marketing de ativação.

Prática recomendada: Configure uma exportação agendada automática semanal (disponível no plano Pro) para enviar a base de contatos atualizada por e-mail todo domingo às 22h. Isso elimina a dependência de alguém se lembrar de exportar manualmente — e garante sempre um backup atualizado da base.

🏥 Clínicas e saúde (conformidade LGPD)

Uma clínica de psiquiatria exporta o histórico completo de conversas de um paciente (com conteúdo das mensagens) quando o prontuário eletrônico precisa ser complementado com o histórico de comunicação pré-consulta. O arquivo é armazenado no prontuário com acesso restrito apenas ao médico responsável. Quando um paciente solicita a portabilidade dos seus dados (direito garantido pela LGPD), a exportação do histórico de conversas é o dado principal a ser entregue.

📋 Consultorias com relatórios para clientes

Uma consultoria de atendimento terceirizado exporta as métricas de TMA, TMR e CSAT de cada mês para montar o relatório mensal de SLA entregue ao cliente contratante. O arquivo Excel com gráficos embutidos é enviado junto com a apresentação executiva. Como os dados vêm diretamente do Chatys — e não de planilhas preenchidas manualmente — o cliente tem confiança na precisão dos números e a consultoria tem credibilidade comprovada.

🎃 E-commerce sazonal e campanhas

Após um broadcast de Black Friday para 8.000 contatos, a gestora de marketing exporta o relatório da campanha e filtra os contatos com campo "respondeu = S". Os 340 clientes que responderam são importados de volta ao Chatys com a tag "Respondeu-BF2025" e recebem uma segunda mensagem personalizada de follow-up com oferta exclusiva — taxa de conversão dessa lista é 4x maior que a campanha original.

⚖️ Auditoria jurídica e disputas

Uma loja de móveis planejados enfrenta uma disputa com um cliente que alega não ter recebido informações sobre o prazo de entrega. O gerente exporta a conversa específica com o conteúdo completo das mensagens e screenshots do histórico. O arquivo exportado com data, hora e conteúdo de cada mensagem serve como evidência documental que o atendente informou o prazo corretamente em 3 momentos distintos da conversa, resolvendo a disputa sem necessidade de processo judicial.

Melhores práticas de exportação de dados:
  • Configure exportações agendadas semanais para backup automático da base de contatos — não dependa de exportação manual que pode ser esquecida em semanas movimentadas
  • Mantenha um registro das exportações realizadas com data, período exportado e finalidade — isso facilita auditorias de conformidade com a LGPD
  • Considere usar a API REST para automatizar exportações para ferramentas de BI como Power BI ou Looker — mais confiável e eficiente do que exportação manual mensal

Solução de problemas comuns

  • O arquivo exportado está corrompido ou não abre: Certifique-se de que o download foi concluído completamente antes de abrir — arquivos grandes podem ser interrompidos. Verifique o tamanho do arquivo baixado versus o tamanho indicado no e-mail de aviso. Se corrompido, acesse Resultados → Exportações Recentes e tente baixar novamente pelo link direto (válido por 48h).
  • Caracteres com acento aparecem errados (acentuação corrompida no Excel): O arquivo está em UTF-8 mas o Excel pode estar abrindo como ANSI. Solução: não abra o arquivo clicando duas vezes. Em vez disso, abra o Excel, vá em Dados → Obter Dados → De Arquivo de Texto/CSV, selecione o arquivo e na janela de importação defina Codificação como "Unicode (UTF-8)". Alternativamente, use o Google Sheets que detecta UTF-8 automaticamente.
  • A exportação está demorando muito ou parece travada: Exportações de períodos longos (ex: 1 ano inteiro) ou com muitas conversas podem levar 10 a 30 minutos. Para períodos acima de 6 meses, recomendamos fazer exportações trimestrais para reduzir o volume. Verifique a seção "Exportações Recentes" em Resultados — o status mostrará "Processando", "Concluído" ou "Falhou".
  • O arquivo exportado está vazio (sem dados): Verifique se os filtros aplicados não são muito restritivos — tente exportar sem filtros para confirmar se há dados no período. Confirme também o período selecionado: se você selecionou "hoje" às 00h01 e não há conversas ainda neste horário, o arquivo ficará vazio. Tente "Ontem" ou "Última semana" para verificar.

Este artigo foi útil?