Genesys Cloud - Developer Community!

É melhor usar a API Conversations ou a API Analytics para obter dados de chamada? 

Olá, Jeferson!

Depende do objetivo, mas minha regra prática é:

Use a Conversations API quando você precisa atuar ou consultar algo mais "operacional" da conversa, especialmente próximo do tempo real. Exemplo: consultar uma conversa específica, participantes atuais, atributos, ou usar em lógica de fluxo/Data Action.

Use a Analytics API quando você precisa de histórico, relatórios, métricas, timeline, segmentos, filas, agentes, disconnect type, transferências, tempos, wrap-up, etc. Para análise de chamadas, auditoria e troubleshooting, normalmente a Analytics API é a melhor opção.

Exemplo:

GET /api/v2/conversations/{conversationId}
Melhor para estado/dados operacionais da conversa.

GET /api/v2/analytics/conversations/{conversationId}/details
Melhor para detalhe histórico da interação, segmentos e jornada da chamada.

POST /api/v2/analytics/conversations/details/query
Melhor para buscar várias conversas por intervalo/filtros e montar relatórios.

Então, se a pergunta é "quero obter dados de chamada para análise/report", eu iria de Analytics API. Se a pergunta é "quero consultar ou agir sobre uma conversa específica em execução ou recém-criada", aí eu olharia a Conversations API.

Só cuidado com volume: o endpoint Analytics Conversation Details Query tem limite de retorno por consulta, então para cargas grandes é melhor quebrar por intervalos menores. A Genesys documenta limite máximo de 100.000 registros por query nesse endpoint.

Olá, Jeferson!

Complementando o ponto do Arthur: na prática, eu separaria pelo tipo de uso.

Para consulta pontual ou ação em uma conversa específica, principalmente em tempo mais próximo do real, a Conversations API atende melhor.

Agora, para análise histórica de chamadas, extração de indicadores, auditoria, troubleshooting, relatórios por fila/agente/wrap-up/segmentos, eu iria de Analytics API.

Um ponto importante é que a Analytics entrega uma visão mais "fechada" da jornada da interação, com segmentos e métricas que normalmente são mais úteis para análise de chamada.

Então, resumindo bem:
Conversations API = operação/consulta pontual da conversa.
Analytics API = histórico, métricas e relatórios.

Só vale cuidar do volume e dos filtros por período, porque consultas grandes na Analytics precisam ser bem segmentadas para evitar limite ou timeout.