https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=list_templates
Descripción:
Esta API permite obtener un listado de todas las plantillas de mensajes de WhatsApp que están asociadas a un conector de WhatsApp específico integrado en tu operación. Esta API es fundamental para administradores y desarrolladores que necesitan una visión general de las plantillas disponibles, sus estados de aprobación, idiomas y componentes.
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 número de identificación del conector de WhatsApp en tu operación de Wolkvox Manager del cual deseas listar las plantillas. | 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 |
| meta_templates | Un arreglo de objetos, donde cada objeto representa una plantilla de WhatsApp y sus propiedades. | String |
| name | El nombre único de la plantilla. | String |
| previous_category | La categoría anterior de la plantilla, si ha sido modificada. | String |
| parameter_format | Formato de los parámetros de la plantilla. | String |
| components | Arreglo que describe las secciones de la plantilla. | String |
| type | Tipo de componente (ej. “HEADER”, “BODY”, “FOOTER”, “BUTTONS”). | String |
| format | Tipo de multimedia si el encabezado es multimedia (ej. “IMAGE”, “DOCUMENT”, “VIDEO”). | String |
| example | Contiene ejemplos del contenido, como header_handle (URLs de ejemplo de archivos multimedia) o body_text (ejemplos para variables del cuerpo). | String |
| text | El contenido textual del componente. | String |
| buttons | Arreglo de objetos que describen los botones (tipo, texto, URL, flow_id, flow_action, Maps_screen para flujos). Los tipos de botones soportados en wolkvox son “URL”, “QUICK_REPLY”, “PHONE_NUMBER” y “FLOW”. Obtén más información acerca de los tipos de botones dando [clic aquí]. | 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 |
| status | El estado de la plantilla en Meta Business Suite. Puede ser: “APPROVED”: La plantilla ha sido revisada y aprobada, lista para ser usada. “PENDING”: La plantilla está en proceso de revisión. “REJECTED”: La plantilla no ha sido aprobada. | String |
| category | La categoría de la plantilla (ej. “UTILITY”, “MARKETING”, “AUTHENTICATION”). | String |
| sub_category | Subcategoría de la plantilla, si aplica (ej. “CUSTOM”, “FORM”). | String |
| id | El ID único de la plantilla en Meta. | String |
| templateName | Este campo representa el nombre identificador de la plantilla tal como se maneja internamente en Wolkvox Manager. Funciona como un alias o un nombre amigable para la plantilla dentro del ecosistema de Wolkvox. | String |
| plantilla | Este campo contiene el texto del cuerpo del mensaje de la plantilla. presenta el texto completo del mensaje, incluyendo las variables, de una manera más directa y consolidada. | String |
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/whatsapp.php?api=list_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 => 'GET',
CURLOPT_POSTFIELDS =>'{
"connector_id": ""
}',
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": "Templates listed successfully",
"data": {
"meta_templates": [
{
"name": "",
"previous_category": "",
"parameter_format": "POSITIONAL",
"components": [
{
"type": "",
"text": ""
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "URL",
"text": "",
"url": ""
}
]
}
],
"language": "",
"status": "",
"category": "",
"id": ""
}
]
}
}
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
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