fbpx
Search
Close this search box.
Search
Close this search box.

< / >

Agent APIs

Schedule callback in predictive dialing

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/agentbox.php?agent_id={{agent_id}}&api=recall&customer_phone={{customer_phone}}&date={{YYYYmmddHHiiss}}&type_recall={{type_recall}}

Description:

This API allows scheduling callbacks in predictive campaigns.

Benefit:

By using this API, you gain ease in managing and tracking communications with clients, time optimization, improved customer experience, process automation, and greater control.

How it works?

  • The consumption of this API is done through the POST method.
  • Replace {{wolkvox_server}} in the URL with the nomenclature of your operation on the server.
  • You must replace {{agent_id}} with the extension number assigned to the agent in the wolkvox system.
  • Replace {{customer_phone}} with the customer’s phone number.
  • Replace {{YYYYmmddHHiiss}} with the date and time when the callback should be executed. It should be in the format YYYYmmddHHiiss, for example: 20231122101520</p>

    <p>Where “YYYY” is the year, “mm” is the month, “dd” is the day, “HH” is the hour in military format, “ii” is the minutes, and “ss” is the seconds.
  • Replace {{type_recall}} with the type of callback you want to establish. It can accept the value “auto” to make the callback automatically or “manual” for the agent to make the callback manually.
  • Use “wolkvox-token: {{token}}” in the HEADER, replacing {{token}} with the authorization token generated in your wolkvox operation.
  • Note that the same token cannot be consumed simultaneously, so you can schedule the next API to be consumed when the result of the previous one is successful.
  • Note: This API is compatible with both wolkvox Desktop Agent and web version.
     

 

REQUEST
NAME DESCRIPTION TYPE
token Token code generated in the wolkvox Manager application. INT
wolkvox_server Server nomenclature where your operation is located. This code is provided by support personnel. INT
agent_id Agent extension number assigned in the Wolkvox system. INT
customer_phone Customer phone number. INT
date

Date on which the callback should be executed. It must be in the format YYYYmmddHHiiss, for example: 20231122101520.

Where “YYYY” is the year, “mm” is the month, “dd” is the day, “HH” is the hour in military format, “ii” is the minutes, and “ss” is the seconds.

String
type_recall Type of callback you want to set. It can accept the value ‘auto’ for automatic callback or ‘manual’ for the agent to make the callback manually. INT
RESPONSE
NAME DESCRIPTION TYPE
code Indicates the status code of the response. INT
error Provides detailed information about any errors that may occur during the execution of the API. The value ‘null’ indicates that no errors occurred, and the API execution was successful. String
msg Is an informative message that describes the response. String
Possible response codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/agentbox.php?agent_id={{agent_id}}&api=recall&customer_phone={{customer_phone}}&date={{YYYYmmddHHiiss}}&type_recall={{type_recall}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => array(
    'wolkvox-token: {{token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
			

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "Recall has been successful"
}
				
			
We use cookies, if you continue browsing we will assume that you agree. You can read more about the use of cookies in our privacy policies and treatment of personal data