fbpx

< / >

APIs Reports Manager

2. Conversations

URL:

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

Description:

This report shows the content of the chat conversations managed by the advisors, indicating specifically the messages shared during the service, the date of the conversation and the identification of the client and advisor.

Benefit:

By knowing the content of the messages shared by customers, you can verify if the chat service is aligned with the quality standards of the operation, if you obtained a response on first contact and identify for which procedures customers prefer chat channels.

How it works:

  • The consumption of this API is done by GET method.
  • 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.
  • In terms of time, to keep track of your operation you can make a consumption every 5 minutes of the information.

NAMEDESCRIPTIONTYPE
apiType of report requiredString
date_iniInitial Date (YYYYmmddHHiiss)String
date_endFinal Date (YYYYmmddHHiiss)String

NAMEDESCRIPTIONTYPE
conn_idCorresponds to the call identification numberString
agent_nameName of the agentString
customer_nameName of the customerString
channelRefers to the channel used in the interactionString
fromIndicates the senderString
from_nameIndicates the name of the senderString
to_nameIndicates the name of the person receiving the messageString
dateIndicates the date in year-month-day-time formatString
messageDetails the messages sent and received by the agent and customerString
customer_idCorresponds to the customer identification numberString
feelingSentiment recognizedString

Possible response codes
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=chat_2&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}',
  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-token: {{token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
				
			

RESPONSE

				
					{
    "code": 200,
    "error": null,
    "msg": "1 records were found",
    "data": [
        {
            "conn_id": "",
            "agent_name": "",
            "customer_name": "",
            "conversation": [
                {
                    "channel": "",
                    "from": "",
                    "from_name": "",
                    "to_name": "",
                    "date": "",
                    "message": "",
                    "customer_id": "",
                    "feeling": ""
                }
            ]
        }
    ]
}
				
			
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