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.
------------------------------
Arthur Pereira Reinoldes
------------------------------