Novedad en la API de WhatsApp para envío de plantillas: envío de botones con URL dinámicas mediante variables

wolkvox Manager incorpora una nueva mejora en su API de Plantillas de WhatsApp, permitiendo ahora incluir botones con URLs dinámicas (variables) en plantillas de tipo Utility y Marketing.

Esta actualización amplía las capacidades de personalización en los mensajes enviados por WhatsApp, posibilitando que cada botón de acción redirija al usuario a un enlace único, adaptado a su perfil, interés o contexto.

De esta forma, se pueden construir plantillas más interactivas y específicas, facilitando la conexión entre las campañas automatizadas y los flujos de venta o servicio de cada empresa.

Beneficios

• Personalización avanzada: cada botón puede contener una URL personalizada por usuario, campaña o flujo.
• Mayor control desde la API: la variable de la URL se reemplaza dinámicamente durante el envío del mensaje, sin necesidad de editar la plantilla en Meta.
• Flexibilidad operativa: permite incluir hasta dos botones por plantilla, cada uno con su propio parámetro variable.
• Compatibilidad total: funciona con plantillas de los tipos Utility y Marketing, aprobadas por Meta Business.
• Optimización de campañas: potencia las estrategias de conversión al redirigir al cliente a páginas, productos o formularios específicos según su necesidad.

Configuración de la plantilla de WhatsApp

La plantilla debe ser de tipo Utility o Marketing y tener la siguiente configuración: 

1. En la sección Botones, selecciona el tipo “Ir al sitio” e indica el tipo de URL: “URL dinámica”.
   • En el campo URL, escribe la estructura con la variable {{1}} para los dos botones, por ejemplo:
     https://www.wolkvox.com/soluciones/{{1}}
   • En el campo Ejemplo para variable 1, coloca la URL completa reemplazando la variable, por ejemplo:
     https://www.wolkvox.com/soluciones/ventas
   • Puedes agregar hasta dos botones, repitiendo la configuración anterior.
   • Nota: Si seleccionas “URL estática”, la plantilla marcará error al intentar enviarla.
2. Guarda la plantilla y sincronízala una vez sea aprobada por Meta.

Configuración de la API

Para enviar un mensaje con botones dinámicos, utiliza la API con el siguiente formato en modo raw:

{
  "connector_id": "",
  "telephone": "",
  "template_name": "",
  "template_vars": "",
  "customer_id": "",
  "url_attach": "",
  "url_params": [
      {
          "index": 0,
          "text": ""
      },
      {
          "index": 1,
          "text": ""
      }
  ]
}

Explicación de los parámetros principales:

• connector_id: ID del conector de WhatsApp configurado en wolkvox Manager.
• telephone: número del cliente con formato internacional.
• template_name: nombre exacto de la plantilla aprobada por Meta.
• template_vars: valores de reemplazo para las variables del cuerpo del mensaje.
• url_attach: URL pública de un archivo (imagen, video o documento) si la plantilla lo admite.
• url_params: arreglo que define los botones a incluir en el mensaje.
• index: posición del botón (0 para el primero, 1 para el segundo).
• text: valor que reemplazará la variable dentro de la URL dinámica.

Ejemplo:

Si la URL de la plantilla es https://www.wolkvox.com/soluciones/{{1}} y en la API se envía "text": "ventas", el enlace final visible para el cliente será https://www.wolkvox.com/soluciones/ventas.

Resultado en WhatsApp

Al recibir el mensaje, el cliente visualizará los botones personalizados. Por ejemplo:

• ventas → abre https://www.wolkvox.com/soluciones/ventas
• cobranza → abre https://www.wolkvox.com/soluciones/cobranza

Esto permite que cada usuario acceda directamente al enlace correspondiente a su contexto o interés.

Notas importantes

• Solo se pueden agregar hasta 2 botones por plantilla.
  • Si se intenta incluir más de dos, el envío marcará error.
• La variable en la URL debe ser obligatoriamente {{1}} para ambos botones.
  • Esto es fundamental para que la API pueda reemplazar correctamente los valores de las URLs dinámicas.
• Ambos botones deben ser de tipo “Ir al sitio” con “URL dinámica”.
  • Si se configura una URL estática, el envío del mensaje fallará.
• El nombre del botón (texto visible) no es variable; lo que cambia dinámicamente es el valor dentro de la URL.
• Para leer la documentación oficial de la API [da clic aquí].

Control de concurrencia en la ejecución de APIs en wolkvox Manager

Con el objetivo de mejorar la estabilidad, el rendimiento y la confiabilidad del ecosistema de integraciones, wolkvox Manager incorpora un nuevo mecanismo de control de concurrencia en la ejecución de sus APIs.

Esta mejora garantiza que, cuando una API esté en proceso de ejecución, no pueda ser llamada nuevamente hasta que finalice su operación. De esta forma se evita la ejecución simultánea de múltiples solicitudes idénticas, especialmente en APIs con procesos de respuesta prolongados o que implican un alto consumo de recursos.

El sistema devuelve una respuesta informativa cuando detecta que la misma API ya está siendo procesada: 

{
  "code": "409",
  "error": "Conflict",
  "msg": "This request is already being processed. Please wait a few seconds and try again."
}

Este cambio contribuye a una operación más controlada, reduciendo la posibilidad de sobrecargas o inconsistencias durante la ejecución de integraciones críticas.

Beneficios

• Mayor estabilidad: evita ejecuciones duplicadas que puedan afectar el rendimiento del sistema o provocar conflictos de datos.
• Optimización del rendimiento: libera recursos del servidor al prevenir solicitudes simultáneas innecesarias.
• Prevención de errores: reduce el riesgo de errores de procesamiento y garantiza respuestas más predecibles.
• Comportamiento controlado en integraciones externas: las aplicaciones que consuman las APIs de wolkvox Manager recibirán una respuesta clara cuando una ejecución previa esté en curso.
• Gestión automática del bloqueo: el control se libera de forma automática al finalizar la ejecución activa, sin intervención manual.

Nueva plantilla “button url (api cloud)” para enviar mensajes con botón de enlace en WhatsApp

En los routing points de tipo chat de wolkvox Studio, se ha incorporado una nueva plantilla dentro del componente “Responder chat” llamada “button url (api cloud)”, la cual permite enviar mensajes de WhatsApp que incluyen botones con enlaces (URL), y de forma opcional, texto, imagen o documento adjunto.

Esta mejora facilita la creación de mensajes promocionales, informativos o de autogestión sin la necesidad de tener una plantilla previamente aprobada en el conector de WhatsApp, agilizando la comunicación entre empresas y clientes.

Beneficios

• Agilidad en la comunicación: ya no se requiere crear ni aprobar plantillas en Meta Business para enviar mensajes con botones en WhatsApp.
• Personalización total: se puede configurar libremente el texto del mensaje, encabezado, pie de página y botón.
• Soporte multimedia: permite incluir imágenes, videos o documentos directamente desde una URL pública.
• Interacción inmediata: los clientes pueden acceder con un clic al enlace deseado, potenciando campañas de marketing, venta o autoservicio.
• Integración flexible: el componente “Responder chat” puede utilizar esta plantilla dentro de flujos de bots o campañas automatizadas.

Configuración

1. Abre la ventana de configuración del componente “Responder chat”.
2. Entra en la pestaña “Avanzado”.
3. Selecciona la plantilla “button url (api cloud)”.
4. Da clic en el botón “Cargar plantilla”.
5. Se cargará el JSON de la plantilla. Modifica la plantilla según tus necesidades.
6. Guarda los cambios realizados.

{
  "type": "button_url",
  "display_text": "Texto boton",
  "url": "https:\/\/example.com\/landing",
  "body_text": "(Optional) Texto body",
  "footer_text": "(Optional) Texto del footer",
  "header": {
      "type": "(Optional) image, video, document, text",
      "url": "(Optional) https:\/\/example.com\/banner.png",
      "text_header": "(Optional) Texto del header"
  }
}

Configuración de campos del JSON

Notas

• Si en header.type defines "text", debes eliminar el campo "url" y usar "text_header".
• Si eliges "image", "video" o "document", elimina "text_header" y conserva "url".

Resultado en WhatsApp

El cliente recibirá un mensaje con formato enriquecido que incluye:

• Imagen o encabezado multimedia.
• Texto informativo o promocional.
• Un botón interactivo con el enlace configurado.