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

PropriedadeTipoDescrição
hostIdstring (UUID)Identificador único do host (obrigatório)
startDatestring (date-time)Data inicial para filtrar as conversas (obrigatório)
endDatestring (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álidos
  • 401: Token de autenticação inválido ou ausente
  • 404: Dados não encontrados
  • 500: 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