Search
Close this search box.

< / >

APIs

14. Edit skill

URL: https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=edit_skill&skill_id={{skill_id}}

Description:

This API allows you to update the information of a skill.

Benefit: Optimize processes and time by editing skill information from external solutions.

Type of request: PUT

How it works:

  • The consumption of this API is done by PUT method.
  • In the json the parameters are added according to the operation or process to be performed.
  • To consume this API you must replace in the url {{{wolkvox_server}} by the nomenclature of the server of the operation.
  • The wolkvox-token header must be used to make use of the authorization token.
  • 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.
  • This API cannot receive the all parameter, it only receives a specific skill.
  • Limit of records that can be downloaded per consumption: 60,000 records.
  • Limit of records that can be uploaded per consumption: 10,000 records.
  • Limit of days queried in dates: 31 days.
  • Limit of result weight: 256 MB.
  • API consumption time limit: 60 seconds.
  • Concurrent consumption limit of a token: 2 simultaneous requests.
  • Daily limit of tokens: Number of licenses multiplied by 1000 daily tokens.

Request

NAME DESCRIPTION TYPE
skill_id Skill ID to edit. Int
skill_name New name for the skill. String
description_skill New description for the skill. String
voicemail Name of the voicemail you want to assign to the skill. String
welcome_message Name of the welcome message you want to use in the skill. String
vto Name of the waiting message you want to use in the skill. This message is used when the operation is outside of its working hours. String
 

Response

NAME DESCRIPTION TYPE
code Response code int
error Error String
msg Description of the response String
Possible response codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/configuration.php?api=edit_skill&skill_id={{skill_id}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_POSTFIELDS =>'{
    "skill_name": "{{skill_name}}",
    "description_skill": "{{description_skill}}",
    "voicemail": "{{voicemail}}",
    "welcome_message": "{{welcome_message}}",
    "vto": "{{vto}}"
}',
  CURLOPT_HTTPHEADER => array(
    'wolkvox_server: {{wolkvox_server}}',
    'wolkvox-token: {{wolkvox-token}}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
			

RESPONSE

				
					{
    "code": 202,
    "error": null,
    "msg": "skill has been updated"
}
				
			
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