Agent Action Analytics

Get agent action statistics over time, with optional filtering by action type, status, and initiating channel.

GET /v1/analytics/agent-actions

Parameters

Parameter	Type	Default	Description
from	ISO 8601	30 days ago	Start of the date range
to	ISO 8601	Now	End of the date range
interval	string	day	Grouping interval: day, week, or month
action_type	string	—	Filter by action type (see values below)
status	string	—	Filter by status (see values below)
initiator	string	—	Filter by source channel: email, chat, voice, whatsapp, messenger, instagram

Action Types

Value	Description
booking_modification	Modification to an existing booking
booking_cancellation	Cancellation of a booking
date_change	Change of check-in/check-out dates
room_upgrade	Room upgrade request
add_service	Adding extra services to a booking
special_request	Special guest request
general_inquiry	General information request
response_generation	AI-generated response
tool_execution	Automated tool execution

Status Values

Value	Description
pending_approval	Waiting for staff approval
auto_executed	Automatically executed (high confidence)
manually_approved	Approved and executed by staff
rejected	Rejected by staff
failed	Execution failed
cancelled	Cancelled before execution

Response

{
  "period": {
    "from": "2026-03-01T00:00:00.000Z",
    "to": "2026-03-12T00:00:00.000Z"
  },
  "interval": "day",
  "data": [
    {
      "date": "2026-03-01",
      "total": 15,
      "by_status": {
        "auto_executed": 10,
        "pending_approval": 3,
        "manually_approved": 2
      },
      "by_action_type": {
        "response_generation": 8,
        "booking_modification": 4,
        "general_inquiry": 3
      }
    }
  ]
}

Example

cURL

# All agent actions, weekly
curl "https://api.opally.com/v1/analytics/agent-actions?from=2026-01-01&interval=week" \
  -H "Authorization: Bearer op_live_your_api_key_here"

# Only auto-executed booking modifications
curl "https://api.opally.com/v1/analytics/agent-actions?action_type=booking_modification&status=auto_executed" \
  -H "Authorization: Bearer op_live_your_api_key_here"

JavaScript