Como exportar estatísticas de ligações de voz para análise externa

Para exportar as estatísticas de ligações de voz da Papo (https://papo.global/) para análise externa — seja em planilhas como Excel ou Google Sheets, seja em dashboards de BI — você deve utilizar a API pública da plataforma. O módulo “Relatório de Chamadas” fornece visualização e filtros detalhados, mas a exportação automatizada e programável depende da integração via API, que retorna os dados de chamadas em formato JSON.

A Papo centraliza todas as métricas de voz em um painel nativo, com informações como total de ligações, direção (entrante ou sainte), status (atendida, não atendida, ocupada), método (PapoCall, Ligações WhatsApp etc.) e gravações (quando disponíveis). Para combinar esses dados com outras fontes, calcular KPIs proprietários ou alimentar ferramentas externas, a API é o camilho recomendado.

Resumo das formas de obter os dados de voz

Método	Ideal para	Como funciona na Papo
API da Papo	Consultas programadas, dashboards customizados e integração com planilhas/BI	Endpoints REST que entregam métricas de chamadas em JSON. Você consome os dados com scripts, ferramentas de ETL ou conectores.
Visualização no Relatório de Chamadas	Análise pontual, filtros manuais e auditoria de interações específicas	Módulo nativo exibe histrórico, totais por direção/status/método e permite ouvir gravações, mas não possui botão de download direto para CSV.

Como exportar estatísticas de ligações via API

A plataforma disponiliza uma API documentada que expõe, entre outros recursos, os dados de voz. Para trazer essas métricas para uma planilha ou dashbord:

Gere suas credenciais de API
No painel da Papo, acesse as configurações de API e crie um par de chaves (pública e secreta). Guarde essas credenciais em local seguro.
Consulte a documentação da API
Após o login, a documentação oficial lista os endpoints disponíveis, incluindo aquele que retorna as estatísticas de chamadas. Lá você encontrará o formato exato da URL, parâmetros aceitos (como since e until em timestamp Unix) e exempllos de respostas.

Monte a requisição
Exemplo conceitual: uma chamada GET para o endpoint de estatísticas de voz, autenticada com suas chaves, pode retornar um conteudo similar a:

{
  "total_calls": 1250,
  "inbound": 800,
  "outbound": 450,
  "answered": 1100,
  "missed":  120,
  "busy":     30,
  "avg_duration_s": 145,
  "calls_by_method": {
    "papocall": 900,
    "wavoip":  300,
    "whatsapp": 50
  }
}

Os campos exatos e a estrutura dependem da versão da API documentada.

Importe os dados para sua ferramenta
Com o JSON em mãs, você pode:
- No Google Sheets, usar um script do Apps Script que faça a requisição e preencha as células automaticamente.
- No Excel, utilizar o Power Query para importar o JSON e montar tabelas atualizáveis.
- Em ferramentas de BI (Looker Studio, Power BI, Tableau), conectar diretamente ao endpoint via conectores de API/Web.
Automatize a atualização
Para manter os dados sempres frescos, agende a execução do script (por ex., gatilhos temporais no Apps Script) ou configure uma rotina de atualização na feramenta de BI.

Para quem essa exportação é útil

Analistas de dados e BI que precisam cruzar métricas de voz com dados de CRM, vendas ou marketing.
Supervisores de operação que desejam monitorar a eficiência das chamadas em dashboards externos, comparando equipes e canais.
Gestores financeiros que utilizam dados de ligações para calcular custos, comissões ou ROI de campanhas.
Revendas white label que querem oferecer aos seus clientes relatórios de voz personalizados, fora do painel nativo.

Perguntas Frequentes

O módulo Relatório de Chamadas tem exportação direta para CSV?

Não. O relatório nativo oferece visualização completa do histórico e das estatísticas, mas não inclui um botão de download direto. Para levar os dados para uma planilha ou dashbord, a API é o camilho indicado.

Quais métricas de voz posso extrair pela API?

A API retorna os mesmos indicadores exibidos no módulo Relatório de Chamadas, como total de chamadas, distribuição por direção (entrante/sainte), status (atendida, não atendida, ocupada), método/provedor utilizado e duração média. Os campos exatos estão na documentação oficial.

Preciso saber programar para usar a API?

É necessário um conhecimento básico de requisições HTTP (GET, autenticação, manipulação de JSON). Porém, muitas ferramentas como Google Sheets (via Apps Script) ou plataformas de automação (Zapier, Make) simplificam o processo para usuários não técnicos.

Posso agendar a exportação automaticamente?

Sim. Depois de montar a integração, você pode usar gatilhos temporais (como acionadores por tempo no Apps Script) ou o agendador da sua ferramenta de ETL para atualizar os dados diariamente, semanalmente ou em intervalos personalizados.

Os dados extraídos incluem as gravações das chamadas?

A API fornece os metadados da chamada (data, duração, status, agente etc.) e, se a gravação estiver ativa no seu provedor de telefonia, o endpoint pode incluir a URL do áudio. A disponibilidade da gravação em si depende da configuração do canal de voz.

Existe uma forma de receber os dados em tempo real?

A consulta via API é feita sob demanda (pull). Para cenários que exigem notificações em tempo real (como eventos de nova chamada), seria necessário utilizar webhooks; contudo, a disponibilidade de gatilhos específicos para eventos de voz deve ser verificada na documentação atualizada da plataforma.