Search
Close this search box.

< / >

APIs

13. CDR Menu options

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=diagram_13&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}

Description:

This API allows you to access the usage history of the “Final Menu Option” component. Remember that the “Menu Option” component is used in routing points of type “voice” and “chat” to track which options the user is navigating through in the flow. You can also track which options the user is navigating through.

Benefit:

This API provides valuable information about user interactions and helps optimize the customer experience.

How it works:

  • The consumption of this API is done through the GET method.
  • To consume this API, you must replace {{wolkvox_server}} in the URL with the operation’s server nomenclature.
  • You must use the `wolkvox-token` header to make use of the authorization token.
  • Please note that the same token cannot be consumed simultaneously. Therefore, you can schedule the next API to be consumed when the result of the previous one is successful.
  • In terms of time, for monitoring your operation, you can make a request for information every 5 minutes.
  • 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
api Type of required report. String
date_ini Start Date (YYYYmmddHHiiss) String
date_end End Date (YYYYmmddHHiiss) String

Response

NAME DESCRIPTION TYPE
code Response Status Code. Int
error Indicates whether there was any kind of error during the execution of the request. String
msg Provides a descriptive message about the result of the request. String
data It is the set of data obtained after a successful request. String
rp_id Routing Point Identifier. String
conn_id Interaction Identifier. String
customer_id Customer Identification Number. String
channel Channel through which the interaction took place. It can yield the values “voice”, “chat-web”, “chat-whatsapp”, “chat-facebook”, or “chat-telegram”. String
telephone Customer’s phone number. String
attempt Number of attempts made in the routing point. String
date Interaction date. String
second_event This is the second in which the indicated menu option was accessed. String
cod_opc_menu Selected menu option. String
Possible error codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=diagram_13&date_ini={{date_ini}}&date_end={{date_end}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'wolkvox_server: {{wolkvox_server}}',
    'wolkvox-token: {{wolkvox-token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
			

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "1172 records were found",
    "data": [
        {
            "rp_id": "",
            "conn_id": "",
            "customer_id": "",
            "channel": "",
            "attempt": "",
            "telephone": "",
            "date": "",
            "second_event": "",
            "cod_opc_menu": ""
        }
    ]
}
				
			
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