WHY WOLKVOX? OMNICHANNEL PLATFORM WOLKVOX CRM CHATBOTS AND VOICEBOTS MANUALS

COLOMBIA Medellín +57 (4) 322 98 80 Bogotá +57 (1) 381 90 40 Cali +57 (2) 891 28 46 Barranquilla +57 (5) 316 10 34 ARGENTINA Buenos Aires +54 (11) 5217 5933 SPAIN Madrid +34 (910) 601 691 MEXICO Ciudad de México +52 (55) 8526 36 34 BRASIL Brasilia +55 (61) 9836 4127 São Paulo +55 (12) 9811 155 83 UNITED STATES New York +1 (914) 373 71 36 DOMINICAN REPUBLIC Santo Domingo +1 (829) 249 69 68 CHILE Santiago de Chile +56 (2) 240 533 89 GUATEMALA Ciudad de Guatemala +502 (2) 314 1344 PERU Lima +51 (1) 644 91 39

1. Chats En

< / >

APIs Reports Manager

1. Chats En

URL:

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

Description:

This report allows to know in depth the management of the chat channels attended by human agents, detailing the details of the chat (chat ID, date, duration, coding, skill and channel), of the customer (ID, name, email, phone, characters sent), the agent (ID, name, characters sent) and efficiency meters (ASA and Last Participant).

Benefit:

Provides a complete view of the non–automated chat interaction between customer and advisor.

How it works:

This API is consumed by GET method.
To consume this API you must replace in the url {{wolkvox_server}} for the nomenclature of the operation server and the {{wolkvox-token}} generated from wolkvox Manager to obtain the information securely.
Keep in mind that the same token cannot be consumed simultaneously, so you can program that the next API is consumed when the result of the previous one is successful.
In terms of time, to track your operation you can make a consumption every 5 minutes of the information.
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

REQUEST

NAME	DESCRIPTION	TYPE
api	Type of report required	String
date_ini	Initial Date (YYYYmmddHHiiss)	String
date_end	Final Date (YYYYmmddHHiiss)	String
agent_dni	Agent’s ID	String

Response

RESPONSE

NAME	DESCRIPTION	TYPE
conn_id	Corresponds to the chat identification number.	String
channel	Indicates the contact channel of the interaction. This column can display one of the following values: Facebook, Instagram, Web, and WhatsApp.	String
date	Indicates the date with year–month–day–hour format.	String
customer_name	Customer name.	String
customer_email	It is the customer‘s email.	String
customer_phone	It is the customer‘s phone.	String
customer_chars	Indicates the numerical amount of characters typed by the customer.	String
agent_id	Refers to the numerical identification of each of the Wolkvox Agents.	String
agent_name	Agent name.	String
agent_chars	Indicates the numerical amount of characters typed by the agent	String
time_on_agent	Indicates the time the agent used in the attention.	String
chat_duration	Indicates interaction duration in seconds.	String
cod_act	It is the ID of the typification or coding used by the agent.	String
description_cod_act	Indicates the description of the typification code.	String
comments	Comment type text of the interaction.	String
customer_id	Corresponds to the identification number of the customer.	String
skill_id	It is the numerical identification of the skill group.	String
ASA	The time that passes from when the chat is initiated by the customer and answered by the advisor.	String
last_participant_who_spoke	Indicates who sent the last message. This column displays the following values: agent (agent), chat-bot (chatbot), and customer (customer).	String
extra_field	Additional field to save information.	String
comment	Comment type text of the interaction.	String
user_id	User identification.	String
feeling	Analyzed and identified sentiment. The values displayed in this column are: very negative, negative, neutral, positive, and very positive.	String
agent_anwers	Number of times the agent writes to the customer.	String

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_1&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;

				
					curl --location --globoff 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=chat_1&date_ini={{date_ini}}&date_end={{date_end}}' \
--header 'wolkvox_server: {{wolkvox_server}}' \
--header 'wolkvox-token: {{wolkvox-token}}'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=chat_1&date_ini={{date_ini}}&date_end={{date_end}}")
  .method("GET", body)
  .addHeader("wolkvox_server", "{{wolkvox_server}}")
  .addHeader("wolkvox-token", "{{wolkvox-token}}")
  .build();
Response response = client.newCall(request).execute();

				
					import requests

url = "https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=chat_1&date_ini={{date_ini}}&date_end={{date_end}}"

payload = {}
headers = {
  'wolkvox_server': '{{wolkvox_server}}',
  'wolkvox-token': '{{wolkvox-token}}'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

RESPONSE

				
					{
    "code": 200,
    "error": null,
    "msg": "1 records were found",
    "data": [
        {
            "conn_id": "",
            "channel": "",
            "date": "",
            "customer_name": "",
            "customer_email": "",
            "customer_phone": "",
            "customer_chars": "",
            "agent_id": "",
            "agent_name": "",
            "agent_chars": "",
            "time_on_agent": "",
            "chat_duration": "",
            "cod_act": "",
            "description_cod_act": "",
            "comments": "test",
            "customer_id": "",
            "skill_id": "",
            "ASA": "",
            "last_participant_who_spoke": "",
            "extra_field": "",
            "comment": "",
            "user_id": "",
            "feeling": "",
            "agent_anwers ": ""
        }
    ]
}

APPLICATIONS

MULTICHANNEL DIALER

WOLKVOX STUDIO

ARTIFICIAL INTELLIGENCE

VOICE OF THE CUSTOMER

QUALITY AND PRODUCTIVITY

ANALYTICS

TELEPHONY

INTEGRATIONS

BY INDUSTRY

BY COMPANY TYPE

SMART TEAMS

AUTOMATION AND ARTIFICIAL INTELLIGENCE

DIGITAL TRANSFORMATION

APPLICATIONS

MULTICHANNEL DIALER

WOLKVOX STUDIO

ARTIFICIAL INTELLIGENCE

VOICE OF THE CUSTOMER

QUALITY AND PRODUCTIVITY

ANALYTICS

TELEPHONY

INTEGRATIONS

BY INDUSTRY

BY COMPANY TYPE

SMART TEAMS

AUTOMATION AND ARTIFICIAL INTELLIGENCE

DIGITAL TRANSFORMATION

< / >

APIs Reports Manager

1. Chats En

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

AUTOMATION AND
ARTIFICIAL INTELLIGENCE

AUTOMATION AND
ARTIFICIAL INTELLIGENCE