Scope
schedule-callbacks:read
Body Schema - Response
200 OK (query callback list and count callback)
| Parameter | Type | Description | Required |
|---|---|---|---|
| total_page | integer | Total of pages. >= 0 | yes |
| total | integer | Total of elements. >= 0 | yes |
| page | integer | Number of the requested page. Defaults to 0 when not provided, which is first page. >= 1 | yes |
| per_page | integer | The maximum amount of items per page. Defaults to 50 when not provided.
| yes |
| count | integer | Number of elements in the current page. >= 0 | yes |
| _links | object | "_links" subdivides into: 1 - "self" (object) - the link to the current page. Required. 2 - "first" (object) - the link to the first page. Required. 3 - "last" (object) - the link to the last page. Required. 4 - "prev" (object) - the link to the previous page. Required. | yes |
| _embedded | object | "_embedded" subdivides into: 1 - "id" (string) - ID of the callback. 2 - "callback_id" (string) - ID of the callback. Required. 3 - "interaction_id" (string) - the interaction ID of where the callback originates from. 4 - "campaign_id" (string) - The campaign ID of where the callback originates from. 5 - "record_id" (string) - the ID of the record list where the record comes from. 6 - "record_list_id" (string) - the ID of the record list that is scheduled to be called. 7 - "phone_number" (string) - the phone number that is scheduled to be called. 8 - "record_first_name" (string) - first name of the record that is scheduled to be called. 9 - "record_last_name" (string) - last name of the record that is scheduled to be called. 10 - "record_last_name" (string) - last name of the record that is scheduled to be called. 11 - "record_extra_data" (object) - extra data from the record that is scheduled to be called. 12 - "caller_id" (string) - the number that will be shown as the caller. 13 - "time_to_call" (string - the original time of the callback set by agent. 14 - "next_time_to_call" (string - the next time the callback will be retried. 15 - "timezone" 16 - "exclusive_to_agent" 17 - "agent_id" 18 - "contact_id" 19 - "status" 20 - "assign_type" 21 - "from_call_type" 22 - "dialing_model" 23 - "_links" (object) | yes |
400 (errors were found in the submitted data), 401 (unauthorized), 403 (forbidden)
| Parameter | Type | Description | Required |
|---|---|---|---|
| code | string | n/a | yes |
| message | string | n/a | yes |
| description | string | n/a | no |
| fields | array[object] | "fields" subdivides into: "name" (string) "description" (string) | yes (name and description) |
API AvailabilityThe Scheduled Callback Management API is only available for customers enrolled in Talkdesk's Early Access (EA) program.
To enter the EA program, contact a Customer Sucess Manager.
The Scheduled Callback Management API has been in GA since March 2022.
TroubleshootingIf you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.