12. Inquire about phone protected by Law 2300 - Wolkvox

< / >

APIs

12. Inquire about phone protected by Law 2300

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=law2300_info&nit={{nit}}&phone={{phone}}

Description:

This API allows you to check if a phone number has been blocked by the protection of Law 2300.

Benefit:

It provides a valuable tool for tracking and managing numbers protected by Law 2300, which contributes to better regulatory compliance and more ethical and responsible communication with contacts.

How it works?:

The consumption of this API is done using the GET method.
To consume this API, you must replace {{wolkvox_server}} in the URL with the nomenclature of the operation’s server.
You should use the wolkvox-token: {{token}} in the Header to utilize the authorization token.
Please note that the same token cannot be consumed simultaneously. Therefore, you can schedule the next API consumption after the previous one has been successful.
In terms of timing, for operational tracking, you can make a consumption every 5 minutes for the information.
Replace {{nit}} with the NIT number of the company validated in the section for Law 2300 of the wolkvox Manager application.
Replace {{phone}} with the phone number you wish to query.
In your operation, you must have the option ‘Activate Compliance with Law 2300’ enabled.
The phone number to be queried must be associated with the NIT configured in the section for Law 2300 in the configuration of the wolkvox Manager application.
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

Response

NAME	DESCRIPTION	TYPE
phone_number	Phone number.	String
last_day	It is the date and time when the phone number was blocked due to the protection of Law 2300.	String
last_channel	Last channel through which contact was made. It can yield the value ‘voice’, ‘chat’, or ‘whatsapp’.	String

Possible error codes

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=law2300_info&nit={{nit}}&phone={{phone}}',
  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;

				
					curl --location 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=law2300_info&nit={{nit}}&phone={{phone}}' \
--header 'wolkvox-token: {{token}}' \
--data ''

				
					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/information.php?api=law2300_info&nit={{nit}}&phone={{phone}}")
  .method("GET", body)
  .addHeader("wolkvox-token", "{{token}}")
  .build();
Response response = client.newCall(request).execute();

				
					import requests

url = "https://wv{{wolkvox_server}}.wolkvox.com/api/v2/information.php?api=law2300_info&nit={{nit}}&phone={{phone}}"

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

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

print(response.text)

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "x records were found",
    "data": [
        {
            "phone_number": "",
            "last_day": "",
            "last_channel": ""
        }
    ]
}

wolkvox
worldwide

UNITED STATES

Atlanta, GA +1 (470) 447-2610
Miami, FL +1 (470) 447-2610

ARGENTINA

Buenos Aires +54 (11) 5217 5933

BRAZIL

Sao Paulo +55 (11) 521 75 933

CHILE

Santiago de Chile +56 (2) 240 533 89

SPAIN

Madrid +34 (910) 601 691

COLOMBIA

Medellín +57 (604) 322 98 80

GUATEMALA

Ciudad de Guatemala +502 (2) 3141344

MEXICO

Ciudad de México +52 (55) 8526 36 34

DOMINICAN REPUBLIC

Santo Domingo +1 (829) 249 69 68

PERU

Lima +51 (1) 644 91 39

|

Information security policy

|

|

Information Transfer Policies

Copyright © 2023 MICROSYSLABS. 1820 N Corporate Lakes Blvd, unit 205. Weston, FL 33326

OMNICHANNEL PLATFORM

CHATBOTS AND VOICEBOTS

wolkvox worldwide

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

Information security policy

Information Transfer Policies

Copyright © 2023 MICROSYSLABS S.A.S.
Cra 30 # 4A – 45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia