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

9. Synchronize templates -

< / >

APIs WhatsApp

9. Synchronize templates

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=sync_templates

Description:

This API allows you to synchronize existing message templates from a WhatsApp connector (i.e., those approved in your Meta Business Manager account) directly with your operation’s integration in Wolkvox Manager. This functionality ensures that all your approved templates are available and up to date within the Wolkvox platform, facilitating their use in campaigns and communication flows.

Benefits:

Automatic Template Availability: Ensures all templates approved in Meta are automatically available in Wolkvox Manager, with no manual intervention required.
Operational Efficiency: Reduces time and effort in managing templates by centralizing their administration and maintaining consistency across platforms.
Communication Consistency: Guarantees that the templates used in your WhatsApp campaigns are always updated with the latest versions approved in Meta.
Simplified Flows: Eases the implementation of automated message flows in Wolkvox by providing immediate access to all necessary templates.
Error Reduction: Minimizes human errors related to manually creating duplicate or outdated templates.

How it works:

This API is consumed using the POST method.
To use this API, replace {{wolkvox_server}} in the URL with your operation’s server nomenclature.
The wolkvok-token header must be used to provide the authorization token.
Keep in mind that a single token cannot be consumed simultaneously, so you should program the next API call to execute only after a successful result from the previous one.
Record download limit per request: 60,000 records.
Record upload limit per request: 10,000 records.
Date range query limit: 31 days.
Response size limit: 256 MB.
API timeout limit: 60 seconds.
Simultaneous token usage limit: 2 concurrent requests.
Daily token limit: Number of licenses multiplied by 1,000 daily tokens.

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
connector_id	The unique identification number of the WhatsApp connector integrated into your Wolkvox Manager operation. This ID is essential for the API to determine from which WhatsApp Business account the templates should be synchronized.	String

Response

NAME	DESCRIPTION	TYPE
code	Error code.	Int
error	Error name.	String
msg	Error explanation.	String
data	Object containing the relevant payload data.	Object
name_template	The name of the template as registered in Meta and Wolkvox.	String
body_template	The full body text of the template, including variables (e.g., {{1}}, {{2}}).	String
idiom	The template’s language code (e.g., “es”, “en_US”, “es_MX”). To view all supported language codes, refer to the official Meta Business documentation by clicking [here].	String
category	The category the template belongs to according to Meta’s guidelines (e.g., “MARKETING”, “UTILITY”, “AUTHENTICATION”, “FLOW”).	String

Possible Response Codes

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=sync_templates',
  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 =>'{
    "connector_id": ""
}',
  CURLOPT_HTTPHEADER => array(
    'wolkvox-token: {{wolkvox-token}}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
					curl --location --globoff 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=sync_templates' \
--header 'wolkvox-token: {{wolkvox-token}}' \
--header 'Content-Type: application/json' \
--data '{
    "connector_id": ""
}'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"connector_id\": \"\"\r\n}");
Request request = new Request.Builder()
  .url("https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=sync_templates")
  .method("POST", body)
  .addHeader("wolkvox-token", "{{wolkvox-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/whatsapp.php?api=sync_templates"

payload = json.dumps({
  "connector_id": ""
})
headers = {
  'wolkvox-token': '{{wolkvox-token}}',
  'Content-Type': 'application/json'
}

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

print(response.text)

RESPONSE

				
					{
    "code": "200",
    "error": null,
    "msg": "Templates synced successfully",
    "data": [
        {
            "name_template": "",
            "body_template": "",
            "idiom": "",
            "category": ""
        }
    ]
}

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 WhatsApp

9. Synchronize templates

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 WhatsApp

9. Synchronize templates

Request

Response

RESPONSE

UNITED STATES

ARGENTINA

BRAZIL

CHILE

SPAIN

COLOMBIA

GUATEMALA

MEXICO

DOMINICAN REPUBLIC

PERU

AUTOMATION AND
ARTIFICIAL INTELLIGENCE