Supported Regions and Base URLs
Access and RegistrationAuthentication
Scope
campaigns:read
Body Response - Schema
200 (campaign returned successfully)
| Parameter | Type | Description | Required |
|---|---|---|---|
| _links | object | HAL API related links. "_links" subdivides into: 1 - "self" (object) - link to fetch the detail of the campaign. 2 - "campaigns" (object) - link to fetch a list of all the campaigns. | yes |
| id | string<uuid> | <= 36 characters | yes |
| name | string |
| yes |
| dialing_mode | string | <= 35 characters. Allowed values: "PREDICTIVE", "PREVIEW" | no |
| priority | integer |
| no |
| run_once | boolean | n/a | no |
| action_required | boolean | n/a | no |
| status | string | <= 35 characters. Allowed values: "INCOMPLETE", "READY", "RUNNING", "PAUSED" | no |
| dialing_mode_configuration | object | "dialing_mode_configuration" subdivides into: 1 - 2 - "max_abandonment_rate" (integer) - maximum rate of abandoned calls.
3 - "max_dialing_ratio" (integer) - maximum number of calls launched per agent.
4 - "max_ring_time_in_secs" (integer) - the time in which if the calls are not answered, they are disconnected.
5 - "abandonment_timeout" (object)
| |
| dialing_strategy | object | "dialing_strategy" subdivides into: 1 - "max_skip_attempts" (integer) - the maximum number of times that an agent can skip a call.
2 - "strategy_type" (string) - the strategy on how the records will be dialed. 3 - "preview_timeout" (integer) - the time in seconds that the preview context will be available to the agent.
4 - "max_attempts" (integer) - the maximum number of non-final call attempts each record may receive.
5 - "retry_period" (integer) - time between non-final call attempts.
6 - "retry_time_unit" (string) - the time unit for the retry_period.
7 - "calling_hours" (array[object]) - set of rules to be applied based on location of the records lists. Required. 8 - "dispositions" (object) - system dispositions to be available for defined campaign. Required. 8.2 - "no_answer" (object) - no_answer disposition settings. Required. 8.3 - "abandoned" (object) - abandonment disposition settings. 8.4 - "answering_machine_detection" (object) - answering_machine_detection disposition settings. 8.5 - "invalid_number" (object) - invalid number disposition setting. 9 - "record_chain" (array[object]) - set of rules to be applied based on the phone type. Must have exactly one of each phone type (see type enum). 10 - "lists_sorting_criteria" (string) - the config on how the records will be sorted. <= 10 characters | no |
| created_at | string<date-time> | n/a | no |
400 (errors 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 Campaign Management API is only available for customers enrolled in Talkdesk's Early Access (EA) program.
To enter the EA program, contact a Customer Success Manager.The Campaign Management APII has been in EA since November 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.