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

< / >

Agent APIs

Make auxiliary call

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/agentbox.php?api=aux_call&agent_id={{agent_id}}&customer_phone={{customer_phone}}

Description:

This API allows making auxiliary calls. The auxiliary call is a feature that is activated only for calls coming from predictive campaigns, allowing the agent to manually make different calls to the customer when the call received from the predictive campaign is disconnected.

Benefit:

Using this API provides continuity of interaction, manual flexibility, improved customer experience, and greater control over calls.

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 should replace {{agent_id}} with the extension number assigned to the agent in the wolkvox system. Replace {{customer_phone}} with the customer’s phone number.
  • Debes reemplazar {{customer_phone}} por el teléfono del cliente.
  • 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’s phone number. INT
RESPONSE
NAME DESCRIPTION TYPE
code Indicates the response status code. String
error Provides detailed information about any errors that may occur during the API execution. The value ‘null’ indicates that no errors occurred, and the API execution was successful. String
msg It is an informative message that describes the response. String
data Contains the data or set of data obtained when consuming the API. In other words, it stores specific information related to the operation performed through the API. JSON Object
conn_id Call identification code. String
Possible response codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/agentbox.php?api=aux_call&agent_id={{agent_id}}&customer_phone={{customer_phone}}',
  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": "Type has been successful",
    "data": {
     "conn_id": ""
    }
}
				
			
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