Meaningful sessions by hour

Overview

The get_meaningful_sessions_count_by_hour function provides meaningful session counts grouped by hour of day. This helps identify peak engagement times and optimal staffing periods. Use this endpoint to:

• Identify peak conversation hours
• Optimize human agent scheduling
• Understand user engagement patterns throughout the day

Quick start

query GetMeaningfulSessionsCountByHour(
  $accountId: uuid!
  $deskIds: _uuid
  $brainIds: _uuid
  $startDate: timestamp
  $endDate: timestamp
) {
  rows: get_meaningful_sessions_count_by_hour(
    args: {
      account_id: $accountId
      desk_ids: $deskIds
      brain_parent_ids: $brainIds
      start_time: $startDate
      end_time: $endDate
    }
  ) {
    hour
    session_count
  }
}

Variables:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

Parameters

Parameter	Type	Description
accountId	uuid!	Account identifier (required)
deskIds	_uuid	Filter by desk IDs
brainIds	_uuid	Filter by AI agent IDs
startDate	timestamp	Start date (format: yyyy-mm-dd)
endDate	timestamp	End date (format: yyyy-mm-dd)

Response fields

Field	Type	Description
hour	Int	Hour of day (0-23)
session_count	Int	Number of meaningful sessions

Common use cases

Try it

Loading GraphQL Playground...

Account hourly pattern

Get hourly session distribution:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

Specific desk

Get hourly pattern for a specific desk:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "deskIds": "{d2be0283-9b53-4d7b-b77d-2650f3a1a99c}",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

Specific AI agent

Get hourly pattern for a specific AI agent:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "brainIds": "{a2wv9283-9b53-4d7b-b77d-2650f3a1a99c}",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

Example response

{
  "data": {
    "rows": [
      { "hour": 0, "session_count": 12 },
      { "hour": 1, "session_count": 8 },
      { "hour": 2, "session_count": 5 },
      { "hour": 8, "session_count": 45 },
      { "hour": 9, "session_count": 89 },
      { "hour": 10, "session_count": 124 },
      { "hour": 11, "session_count": 132 },
      { "hour": 12, "session_count": 98 },
      { "hour": 13, "session_count": 115 },
      { "hour": 14, "session_count": 142 },
      { "hour": 15, "session_count": 128 },
      { "hour": 16, "session_count": 95 },
      { "hour": 17, "session_count": 72 },
      { "hour": 18, "session_count": 45 },
      { "hour": 23, "session_count": 15 }
    ]
  }
}