https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=create_utility_template
Descripción:
API que permite la creación programática de plantillas de mensajes de WhatsApp de categoría Utilidad. Estas plantillas están diseñadas para notificaciones de seguimiento, confirmaciones, alertas y otras comunicaciones transaccionales que proporcionan información importante a los clientes.
Beneficio:
Cómo funciona:
Ejemplos de código:
En nuestro workspace de Postman (da clic aquí para ir), tienes acceso a ejemplos de código que facilitan la integración con nuestras APIs en diferentes lenguajes de programación, como cURL, Python, JavaScript, y más.
Esta funcionalidad es ideal para integraciones rápidas y permite adaptar los llamados a la API según el lenguaje de programación de tu sistema.
Cómo Usar los Ejemplos de Código:
| NAME | DESCRIPTION | TYPE |
|---|---|---|
| connector_id | El ID del conector de WhatsApp al que se vinculará la plantilla. | String |
| name | El nombre único de la plantilla. Importante: Este nombre debe ser único en toda tu operación de Wolkvox Manager y no puede repetirse en otras plantillas. Tampoco puede contener mayúsculas ni espacios ni caracteres especiales aunque sí puede contener números. | String |
| language | El código de idioma de la plantilla. Debe ser uno de los idiomas soportados por Meta (consulta la lista completa dando [clic aquí]) | String |
| category | La categoría de la plantilla. Para esta API, debe ser “UTILITY“. Puedes ir a la documentación oficial de Meta Business acerca de las plantillas de autenticación dando [clic aquí]. | String |
| components | Un arreglo de objetos que definen las secciones de la plantilla (encabezado, cuerpo, pie de página, botones). | Array |
| type | Componente “BODY”. | String |
| text | El contenido principal del mensaje. Puedes incluir variables dinámicas utilizando {{1}}, {{2}}, {{3}}, etc. (Ej. “This is a test with the variables {{1}}, {{2}}, and {{3}}.”). | String |
| example | Objeto que contiene body_text | Object |
| body_text | Obligatorio. Un arreglo de arreglos con textos de ejemplo para las variables definidas en text. Estos ejemplos son solo para la revisión de Meta y no se envían al cliente final. (Ej. [[“Example Name”, “Example Name 2”]]). | String |
| type | Componente “BUTTONS”. Define un botón individual y sus propiedades. | String |
| buttons | Un arreglo de objetos que describen los botones interactivos. Para las plantillas de utilidad, se suelen usar “QUICK_REPLY” o “URL”. | String |
| type | El tipo de botón (ej. “QUICK_REPLY”, “URL”, “PHONE_NUMBER”, “FLOW”). | String |
| text | El texto que se mostrará en el botón. | String |
| NAME | DESCRIPTION | TYPE |
|---|---|---|
| code | Código de error | Int |
| error | Nombre del error | String |
| msg | Explicación del error | String |
| data | Objeto que contiene los datos relevantes de la carga | Object |
| name | El ID único de la plantilla generada por Meta. | String |
| status | El estado actual de la plantilla en el proceso de revisión de Meta. Los posibles estados son: “APPROVED”: La plantilla ha superado la revisión y se puede usar para enviar mensajes. “PENDING”: La plantilla ha superado la validación inicial y está en proceso de revisión por parte de Meta. “REJECTED”: La plantilla no ha superado la validación de categoría o la revisión de Meta. | String |
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=create_utility_template',
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": "",
"name": "",
"language": "",
"category": "UTILITY",
"components": [
{
"type": "BODY",
"text": "",
"example": {
"body_text": [
[
""
]
]
}
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "QUICK_REPLY",
"text": ""
},
{
"type": "QUICK_REPLY",
"text": ""
}
]
}
]
}',
CURLOPT_HTTPHEADER => array(
'wolkvox-token: {{wolkvox-token}}',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
{
"code": "200",
"error": null,
"msg": "Template created successfully",
"data": {
"template_id": "",
"name": "",
"status": ""
}
}
Medellín +57 (604) 322 98 80
Bogotá +57 (601) 381 90 40
Cali +57 (602) 891 28 46
Barranquilla +57 (605) 316 10 34
Sao Paulo
+55 (11) 521 75 933
Madrid
+34 (910) 601 691
Atlanta, GA +1 (470) 447-2610
Miami, FL +1 (470) 447-2610
Ciudad de México
+52 (55) 8526 36 34
Santo Domingo
+1 (829) 249 69 68
Copyright © 2025 WOLKVOX MICROSYSLABS. Todos los derechos reservados. Cra 30 # 4A-45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia
Copyright © 2025 WOLKVOX MICROSYSLABS.
Todos los derechos reservados.
Cra 30 # 4A – 45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia
Usamos cookies, se continuar a navegar assumimos que concorda. Pode ler mais sobre a utilização de cookies nas nossas políticas de privacidade e tratamento de dados pessoais
Hacemos uso de cookies, si continúas navegando asumiremos que estás de acuerdo. Puede leer más sobre el uso de cookies en nuestras políticas de privacidad y tratamiento de datos personales
Hacemos uso de cookies, si continúas navegando asumiremos que estás de acuerdo. Puede leer más sobre el uso de cookies en nuestras políticas de privacidad y tratamiento de datos personales