2.1 Inserting records in the campaign (predictive) - Wolkvox

< / >

APIs Campaign

2.1 Inserting records in the campaign (predictive)

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign=predictive&campaign_id={{campaign_id}}&campaign_status={{campaign_status}}

Description:

This API allows you to insert records automatically and remotely or from external platforms, in an existing campaign in wolkvox manager.

Benefit:

This API is very useful when you have, for example, external forms to capture leads, when the user registers automatically the information will be sent to the campaign and the call or message will be sent as parameterized.

How it works:

The consumption of this API is done by POST method.
In the json the parameters are added according to the operation or process to be performed.
To consume this API you must replace in the url {{{wolkvox_server}} by the nomenclature of the server of the operation.
The {{type_campaign}} field is replaced by the campaign type.
The {{campaign_id}} is replaced by the campaign ID number.
The {{campaign_status}} field must be replaced by the current status of the campaign.
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.

NAME	DESCRIPTION	TYPE
customer_name	Customer’s first name	String
customer_last_name	Last name of customer	String
id_type	Identification type	String
customer_id	Customer identification number	String
age	Age	String
gender	Gender	String
country	Country of residence	String
state	State of residence	String
city	City of residence	String
zone	Area of residence	String
address	Residence address	String
opt1	Additional field to enter additional campaign information	String
opt2	Additional field to enter additional campaign information	String
opt3	Additional field to enter additional campaign information	String
opt4	Additional field to enter additional campaign information	String
opt5	Additional field to enter additional campaign information	String
opt6	Additional field to enter additional campaign information	String
opt7	Additional field to enter additional campaign information	String
opt8	Additional field to enter additional campaign information	String
opt9	Additional field to enter additional campaign information	String
opt10	Additional field to enter additional campaign information	String
opt11	Additional field to enter additional campaign information	String
opt12	Additional field to enter additional campaign information	String
tel1	Phone number	String
tel_extra	Extra phone	String
email	Customer’s email	String
recall_date	Is the date of the recall format (yyyymmddhhmmss)	String
recall_telephone	Recall phone number	String

NAME	DESCRIPTION	TYPE
total_registers	Total records added	int

Possible response codes

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign={{type_campaign}}&campaign_id={{campaign_id}}&campaign_status={{campaign_status}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'[{
            "customer_name": " ",
            "customer_last_name": " ",
            "id_type": " ",
            "customer_id": " ",
            "age": " ",
            "gender": " ",
            "country": " ",
            "state": "",
            "city": "",
            "zone": "",
            "address": "",
            "opt1": "",
            "opt2": "",
            "opt3": "",
            "opt4": "",
            "opt5": "",
            "opt6": "",
            "opt7": "",
            "opt8": "",
            "opt9": "",
            "opt10": "",
            "opt11": "",
            "opt12": "",
            "tel1": " ",
            "tel2": "",
            "tel3": "",
            "tel4": "",
            "tel5": "",
            "tel6": "",
            "tel7": "",
            "tel8": "",
            "tel9": "",
            "tel10": "",
            "tel_extra": "",
            "email": "",
            "recall_date": " ",
            "recall_telephone": " "
    
}]',
  CURLOPT_HTTPHEADER => array(
    'wolkvox-token: {{token}}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
					curl --location -g --request POST 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign={{type_campaign}}&campaign_id={{campaign_id}}' 
--header 'wolkvox-token: {{token}}' 
--header 'Content-Type: application/json' 
--data-raw '[{
   "customer_name": "",
    "customer_last_name": "",
    "id_type": "",
    "customer_id": "",
    "age": "",
    "gender": "",
    "country": "",
    "state": "",
    "city": "",
    "zone": "",
    "address": "",
    "opt1": "",
    "opt2": "",
    "opt3": "",
    "opt4": "",
    "opt5": "",
    "opt6": "",
    "opt7": "",
    "opt8": "",
    "opt9": "",
    "opt10": "",
    "opt11": "",
    "opt12": "",
    "tel1": "",
    "tel2": "",
    "tel3": "",
    "tel4": "",
    "tel5": "",
    "tel6": "",
    "tel7": "",
    "tel8": "",
    "tel9": "",
    "tel10": "",
    "tel_extra": "",
    "email": "",
    "recall_date": "",
    "recall_telephone": ""

}]'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, '[{
    "customer_name": "",
    "customer_last_name": "",
    "id_type": "",
    "customer_id": "",
    "age": "",
    "gender": "",
    "country": "",
    "state": "",
    "city": "",
    "zone": "",
    "address": "",
    "opt1": "",
    "opt2": "",
    "opt3": "",
    "opt4": "",
    "opt5": "",
    "opt6": "",
    "opt7": "",
    "opt8": "",
    "opt9": "",
    "opt10": "",
    "opt11": "",
    "opt12": "",
    "tel1": "",
    "tel2": "",
    "tel3": "",
    "tel4": "",
    "tel5": "",
    "tel6": "",
    "tel7": "",
    "tel8": "",
    "tel9": "",
    "tel10": "",
    "tel_extra": "",
    "email": "",
    "recall_date": "",
    "recall_telephone": ""
    
}]');
Request request = new Request.Builder()
  .url("https://wv{{wolkvox_server}}.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign={{type_campaign}}&campaign_id={{campaign_id}}")
  .method("POST", body)
  .addHeader("wolkvox-token", "{{token}}")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

				
					import requests
import json

url = "https://wv{{wolkvox_server}}.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign={{type_campaign}}&campaign_id={{campaign_id}}"

payload = json.dumps([{
  "customer_name": "",
    "customer_last_name": "",
    "id_type": "",
    "customer_id": "",
    "age": "",
    "gender": "",
    "country": "",
    "state": "",
    "city": "",
    "zone": "",
    "address": "",
    "opt1": "",
    "opt2": "",
    "opt3": "",
    "opt4": "",
    "opt5": "",
    "opt6": "",
    "opt7": "",
    "opt8": "",
    "opt9": "",
    "opt10": "",
    "opt11": "",
    "opt12": "",
    "tel1": "",
    "tel2": "",
    "tel3": "",
    "tel4": "",
    "tel5": "",
    "tel6": "",
    "tel7": "",
    "tel8": "",
    "tel9": "",
    "tel10": "",
    "tel_extra": "",
    "email": "",
    "recall_date": "",
    "recall_telephone": ""
   
}])
headers = {
  'wolkvox-token': '{{token}}',
  'Content-Type': 'application/json'
}

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

print(response.text)

RESPONSE

				
					{
    "code": "201",
    "error": null,
    "msg": "All records has been added successfully",
    "data": [
        {
            "total_registers": " "
        }
    ]
}

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