Reports
Obter Estatísticas Conversacionais
Retorna estatísticas detalhadas sobre conversas para um host específico, incluindo totais de serviços, mensagens e análises históricas.
Obter Estatísticas Conversacionais
Retorna estatísticas detalhadas sobre as conversas para um host específico, incluindo totais de serviços, mensagens, distribuição por canais e análises históricas por mês e dia.
Endpoint: POST /api/externalAPIs/public/tolkyReasoning/getConversationalStats
Propriedade | Tipo | Descrição |
---|---|---|
hostId | string (UUID) | Identificador único do host (obrigatório) |
startDate | string (date-time) | Data inicial para filtrar as conversas (obrigatório) |
endDate | string (date-time) | Data final para filtrar as conversas (obrigatório) |
Exemplo cURL:
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/getConversationalStats' \
-H 'Content-Type: application/json' \
-d '{
"hostId": "uuid-do-host",
"startDate": "2025-01-01",
"endDate" : "2025-01-31",
}'
Resposta de Exemplo:
{
"code": 200,
"message": "OK",
"data": [
{
"total_contracted_services": 0,
"total_services": 2895,
"total_messages": 52834,
"total_tickets": 0,
"total_messages_sent_by_avatar": 26401,
"total_messages_received_by_user": 26433,
"total_solved_tickets": 0,
"total_opened_tickets": 0,
"total_services_after_hours": 1450,
"total_messages_after_hours": 38795,
"total_messages_responder_manager": 0,
"services_by_channels": [
{
"platform": "web",
"total_services": "10"
},
{
"platform": "api_reasoning",
"total_services": "1161"
},
{
"platform": "api",
"total_services": "1724"
}
],
"history_months": [
{
"mês": "2025-03-01T03:00:00.000Z",
"total_conversations": "272",
"total_messages": "5994",
"total_tickets": "0"
},
// Outros meses omitidos para brevidade
],
"history_days": [
{
"dia": "2025-05-01T03:00:00.000Z",
"total_conversations": "251",
"total_messages": "6121",
"total_tickets": "0"
},
// Outros dias omitidos para brevidade
]
}
]
}
Códigos de Erro:
400
: Campos obrigatórios ausentes ou inválidos401
: Token de autenticação inválido ou ausente404
: Dados não encontrados500
: Erro interno do servidor
Notas:
- Requer autenticação válida através do
tolkyAuthMiddleware
- Os dados retornados incluem estatísticas detalhadas sobre serviços, mensagens e distribuição por canais
- Fornece análises históricas por mês e por dia para o período solicitado
- O parâmetro
hostId
é automaticamente extraído das credenciais de autenticação