get_call_history
Retrieve past call records with start time, caller/callee details, duration, and answered status. Filter by date, missed calls, extension, or queue to analyze call activity.
Instructions
Use this for ANY question about past calls: 'show today's calls', 'missed calls today', 'recent calls for extension 101', 'calls to queue 802 yesterday'. Returns newest calls first. Each record: StartTime, SourceDisplayName, SourceCallerId, DestinationDisplayName, DestinationCallerId, Answered (true/false), TalkingDuration, Direction, Status, Reason. Set missedOnly=true for missed/unanswered calls. Handles timezone-aware 'today' filtering automatically. Requires System Owner role.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Time window: 'today' (default), 'last_24_hours', or 'all_recent' (last 3 days) | today |
| missedOnly | No | Set true for missed/unanswered calls only (checks both Answered=false and Status='Unanswered') | |
| date | No | Explicit date in YYYY-MM-DD format, e.g. '2026-03-17' for yesterday | |
| timezone | No | IANA timezone, e.g. 'Europe/Berlin'. Defaults to UTC. | |
| top | No | Max results to return (applied after sorting) | |
| extension | No | Filter by extension number on source or destination, e.g. '101' | |
| queue | No | Filter by queue number or name, e.g. '802' or 'Support' | |
| scanLimit | No | How many rows to fetch from the server. Increase for busy systems. |