Update a particular dialer campaign

This API allows you to update the dialer campaign details

Sample Request

curl --request PUT \
     --url https://api-smartflo.tatateleservices.com/v1/dialer/campaign/id \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

📘 Important!

Before we begin, note that the * sign denotes the mandatory variables in each table.

Request Variables (Path Params)

The following parameter is required to update a particular dialer campaign:

Variable NameDescriptionData Type
idUnique ID of the dialer campaign.string

Request Variables (Body Params)

The following parameter is required to update a particular dialer campaign:

Variable NameDescriptionData Type
nameName of the Dialer CampaignString
descriptionDescription of the CampaignString
dial_methodMethod with which leads get connected, valid value is 1 or 2 with the following convention ['id' => '1', 'name' => 'Preview'], ['id' => '2', 'name' => 'Ratio'],String
auto_dial_durationPreview duration before dialing, mandatory field if dial method is 1String
outbound_caller_idCaller ID for the dialer campaignString
agent_wise_caller_idValid value 1 or 0 for enabling or disabling setting caller id for each agentboolean
lead_list_mapSelect lead lists and their status, can select upto 3 active lead lists in the format [{list_id:1234,list_status:1},{list_id:1235,list_status:0},...]array
agent_wise_lead_listValid value 0 or 1 to select lead list individually for each agentboolean
list_traversal_orderTraversal order method for lead list while dialing, value should be 1,2 or 3 with the following meaning: ['id' => '1', 'name' => 'Oldest First'], ['id' => '2', 'name' => 'Newest First'],['id' => '3', 'name' => 'Random'],Traversal order method for lead list while dialing, value should be 1,2 or 3 with the following meaning: ['id' => '1', 'name' => 'Oldest First'], ['id' => '2', 'name' => 'Newest First'],['id' => '3', 'name' => 'Random'],string
agent_scriptId of script where content will be visible to only agent while dialing leadstring
disposition_listId of list containing short codes that describe the outcome of callsstring
number_of_retryRefresh Countstring
retry_after_minutesRefresh Interval duration in minutesstring
auto_disposition_cancel_durationWrap up time for agent in secondsstring
dial_statusDial Status of the campaignarray of strings
time_groupId of Campaign Active Time which will reflect for all agentsstring
time_group_recordingId of Campaign Active Time Recordingstring
ring_timeoutThe call will ring on each agent for the defined seconds before trying any other agentstring
quick_transfer_listId of Quick Transfer List of the campaignstring
account_dnd_listId of DND list set up of the campaignstring
hide_lead_detailsValid value 0 or 1,enabling this will hide customer's detailsboolean
update_lead_detailsValid value 0 or 1, enabling this will update customer's detailsboolean
automatic_schedule_call_enabledValid value 0 or 1, enabling this will allow adding automatic schedule call for the campaignboolean
enable_hangupValid value 0 or 1, enabling this will cause hangup call for agentboolean
enable_external_transferValid value 0 or 1, enabling this will allow external transferboolean
after_call_work_durationTime given to the agent after a call ends in secondsstring
enable_web_formValid value 0 or 1, enabling this will allow to add web formboolean
webform_urlURL of web-form in the dialer campaignstring
music_on_holdId of music to be played while the calls is connecting to the agentsstring
ring_strategyRing Strategy of Dialer Campaign, valid value is 1,2 or 3 with the following convention: ,['id' => '1', 'name' => 'Random'],['id' => '2', 'name' => 'Fewest Calls'],['id' => '3', 'name' => 'Longest Wait Time'],string
dial_ratioRatio in which agents will be called, mandatory field if dial method is 2string
enable_transferValid value 0 or 1, enabling this will allow transfering callsboolean
manual_lead_listLead List for Manual Dial, mandatory field if manual_dial_enabled is 1array of strings
break_listId of Pause code List containing break code and name, if agent takes break specifying purpose/reasonstring
map_agent_caller_idIndividual mapping of each agent with caller idstring
map_agent_lead_listIndividual mapping of each agent with lead liststring
connect_agent_throughAgent Connection method, valid value is 1,2 or 3 with following convention: ['id' => '1', 'name' => 'Agent Mobile'], ['id' => '2', 'name' => 'Agent Extension'], ['id' => '3', 'name' => 'Both (Extension first, otherwise mobile)']string
dial_in_typeAgent Call Method, valid value is 1,2 or 3 with following convention: ['id' => '1', 'name' => 'Dial In (Session)'], ['id' => '3', 'name' => 'Dial Out (Session)'], ['id' => '2', 'name' => 'Dial Out (Each Call)']string
agent_only_callbackValid value 0 or 1, enabling this will allow callback for agent in agent panelboolean
agent_dial_in_numberAgent number in case of dial instring
agentAgent who gets connected and picks the inbound callarray of int32s
enforce_agent_pause_codeOption while showing break codes of a listint32
manual_dial_enabledValid value 0 or 1, enabling will allow manual dial for agent in agent panelboolean
enable_inboundValid value 0 or 1, enabling will set inbound queue for the dialer campaignboolean
inbound_queueId of queue to receive incoming calls from customer, mandatory field if enable_inbound is 1.string
enable_agent_opt_outValid value 0 or 1, enabling this will remove self from inbound queue in agent panelboolean
inbound_lead_listLead List for inbound queue, mandatory field if enable_inbound is 1.string
enable_auto_answerValid value 0 or 1, enabling will make agent get connected to the callboolean
call_qualification_durationThis duration in seconds will be used to qualify the call as a successful callstring
announcement_recordingId of Welcome tune recordingstring

Response Variables

The response returned is as following:

Variable NameDescriptionData Type
SuccessThe request success status, the possible values are: True (default) for success. False for failure.Boolean
MessageThe message corresponding to the success status. For example, in 400 Response where the "success" variable pops as True, the message displayed is shown here.String
Language
Click Try It! to start a request and see the response here!