Relatórios
Obter Estatísticas Financeiras
Retorna histórico de custos por mês e dia para um host.
Retorna histórico de custos por mês e dia, relacionados ao número de conversas.
Endpoint
POST /api/externalAPIs/public/tolkyReasoning/reports/getFinancialStats
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
hostId | string (UUID) | UUID do host (obrigatório) |
startDate | string (date-time) | Data inicial do período (obrigatório) |
endDate | string (date-time) | Data final do período (obrigatório) |
Exemplo
curl -X POST \
'{{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/reports/getFinancialStats' \
-H 'Content-Type: application/json' \
-d '{
"hostId": "uuid-do-host",
"startDate": "2025-01-01",
"endDate": "2025-01-31"
}'
Resposta
{
"code": 200,
"message": "OK",
"data": [
{
"history_months": [
{
"mês": "2025-03-01T03:00:00.000Z",
"total_conversations": "272",
"total_cost": "530.40"
},
{
"mês": "2025-04-01T03:00:00.000Z",
"total_conversations": "3483",
"total_cost": "6791.85"
},
{
"mês": "2025-05-01T03:00:00.000Z",
"total_conversations": "2898",
"total_cost": "5651.10"
}
],
"history_days": [
{
"dia": "2025-05-01T03:00:00.000Z",
"total_conversations": "251",
"total_cost": "489.45"
},
{
"dia": "2025-05-02T03:00:00.000Z",
"total_conversations": "435",
"total_cost": "848.25"
}
]
}
]
}
Erros
| Código | Descrição |
|---|---|
400 | Campos obrigatórios ausentes ou inválidos |
401 | Token inválido ou ausente |
404 | Dados não encontrados |
500 | Erro interno do servidor |