RingAttemptsReport
Query the Ring Attempts Report via the Explore API. Provides detailed information regarding ring attempts. Up to a month of data per request.
Select
The RingAttemptsReport is a report view. The driver processes the following pseudo-columns server-side; any other WHERE clause conditions are evaluated client-side.
- TimespanFrom supports the following operator: >=
- TimespanTo supports the following operator: <
- Timezone supports the following operator: =
If TimespanFrom and TimespanTo are omitted, the driver defaults the time range to the last 31 days.
For example, the following query is processed server-side:
SELECT * FROM RingAttemptsReport WHERE TimespanFrom >= '2025-01-01' AND TimespanTo < '2025-02-01'
Columns
| Name | Type | References | Description |
| RingAttemptId [KEY] | String | The unique identifier of the ring attempt. | |
| InteractionId | String |
CallsReport.InteractionId | The unique identifier of the interaction. |
| ContactId | String |
Contacts.Id | The unique identifier of the contact. |
| BatchRingId | String | The unique identifier of the batch ring. | |
| AttemptType | String | The type of ring attempt. Example values: Rejected, Answered, Missed. | |
| RingStartedAtTime | Datetime | The date and time the ring attempt started. | |
| RingFinishedAtTime | Datetime | The date and time the ring attempt finished. | |
| RingAttemptDuration | Int | The duration of the ring attempt, in seconds. | |
| UserName | String | The name of the agent for the ring attempt. | |
| UserEmail | String | The email of the agent for the ring attempt. | |
| TeamName | String | The team name of the agent. | |
| Queues | String | The queues associated with the dial attempt. |
Pseudocolumns
Pseudocolumn fields are used in the WHERE clause of SELECT statements and offer more granular control over the data returned from the data source.
| Name | Type | Description | |
| TimespanFrom | Datetime | The start date for the report timespan. | |
| TimespanTo | Datetime | The end date for the report timespan. | |
| Timezone | String | The IANA timezone for the report timespan. |