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

15. WhatsApp click summary -

< / >

APIs Interacciones y Chats

15. WhatsApp click summary

URL:

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

Description:

This API provides an overview of interaction performance in the “WhatsApp Click Summary” report. It offers aggregated data on how chats originating from ads and posts are managed, enabling a quick and efficient evaluation of campaign performance.

Benefits:

Overview: Provides a consolidated view of interaction performance, making it easier to make quick decisions.
Operational Efficiency: Quickly identifies areas for improvement in chat handling, whether managed by bots or human agents.
Resource Optimization: Helps optimize resource allocation by showing how many chats are handled by bots versus those requiring human intervention.
Security: The use of an authorization token ensures that only authorized users can access the data.

How it works:

This API uses the GET method.
To use this API, replace {{wolkvox_server}} in the URL with the server name corresponding to your operation.
You must include the header wolkvox-token: {{token}} to authorize the request using your token.
Replace {{date_ini}} with the start date and time for the query (format: YYYYMMDDHHMMSS, e.g., 20250201000000).
Replace {{date_end}} with the end date and time for the query (format: YYYYMMDDHHMMSS, e.g., 20250228235959).
Keep in mind that a single token cannot be used for simultaneous requests. You should program the next API call to execute only after the previous one returns a successful result.
For operational tracking, you can request data every 5 minutes.

Code Examples:

In our Postman workspace ([click here] to access it), you have access to code examples that facilitate integration with our APIs in different programming languages such as cURL, Python, JavaScript, and more.

This feature is ideal for quick integrations and allows you to adapt the API calls to your system’s programming language.

How to Use the Code Examples:

Navigate to our Postman workspace.
Select the API you want to consult.
Edit the necessary API parameters according to your goals.
In the “Code” tab, select your preferred programming language.
You will get an auto-generated code snippet, ready to use with the parameters and authentication previously configured.

Request

NAME	DESCRIPTION	TYPE
api	Type of report required.	String
date_ini	Start date (YYYYmmddHHiiss).	String
date_end	End date (YYYYmmddHHiiss).	String

Response

NAME	DESCRIPTION	TYPE
code	Response status code.	String
error	Detailed information about any error that may have occurred during API execution.	String
msg	Informational message describing the response.	String
data	Array containing the details of chats closed by channel.	String
ad_chatbot	Number of chats from ads handled by bots.	String
ad_agents	Number of chats from ads handled by human agents.	String
post_chatbot	Number of chats from posts handled by bots.	String
post_agents	Number of chats from posts handled by human agents.	String
total_chatbot	Total number of chats handled exclusively by bots.	String
total_agents	Total number of chats that required human agent intervention.	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_15&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-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_15&date_ini={{date_ini}}&date_end={{date_end}}' \
--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_15&date_ini={{date_ini}}&date_end={{date_end}}")
  .method("GET", body)
  .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_15&date_ini={{date_ini}}&date_end={{date_end}}"

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

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

print(response.text)

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "X records were found",
    "data": [
        {
            "ad_chatbot": "",
            "ad_agents": "",
            "post_chatbot": "",
            "post_agents": "",
            "total_chatbot": "",
            "total_agents": ""
        }
    ]
}

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 Interacciones y Chats

15. WhatsApp click summary

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

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 Interacciones y Chats

15. WhatsApp click summary

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

AUTOMATION AND
ARTIFICIAL INTELLIGENCE