Nueva API para subir un archivo de ejemplo a Meta Business

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager, que permite subir un archivo a Meta Business Suite. Este archivo se utilizará como ejemplo de archivo multimedia, el cual es requerido obligatoriamente por Meta al crear una plantilla de WhatsApp que incluya un archivo multimedia como adjunto. Es importante destacar que este archivo multimedia será solo un ejemplo y no se incluirá dentro de la plantilla de WhatsApp. Los agentes que envíen un mensaje usando una plantilla de WhatsApp deberán incluir la URL pública del archivo que desean adjuntar y colocarla en el campo 'Enlace de archivo de WhatsApp' en el formulario de "Enviar WhatsApp" del aplicativo wolkvox Agent en su versión web o en el campo 'URL archivo' del aplicativo wolkvox Agent en su versión de escritorio. Solo se permiten archivos de tipo imagen, video o documento.

Beneficios

• Cumplimiento con Requisitos de Meta: Facilita el cumplimiento de los requisitos de Meta al crear plantillas de WhatsApp que incluyan archivos multimedia.
• Flexibilidad para Agentes: Permite a los agentes incluir la URL pública del archivo que desean adjuntar al usar la plantilla, proporcionando flexibilidad en el contenido enviado.
• Integración con Meta Business Suite: Simplifica el proceso de subir archivos multimedia a Meta Business Suite, integrando esta funcionalidad directamente en wolkvox Manager.
• Soporte para Múltiples Tipos de Archivos: Permite la subida de diferentes tipos de archivos multimedia, incluyendo imágenes, videos y documentos, lo que amplía las posibilidades de uso en las plantillas de WhatsApp.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para crear plantillas de WhatsApp de categoría Marketing

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite crear una plantilla de WhatsApp de categoría Marketing en un conector de WhatsApp vinculado a su operación. Esta API facilita la creación de plantillas personalizadas para campañas de marketing, permitiendo a los usuarios definir el contenido y las variables del mensaje.

Beneficios

• Personalización de Mensajes: Permite la creación de plantillas de WhatsApp personalizadas para campañas de marketing, mejorando la interacción con los clientes.
• Integración con Meta: Facilita la integración con Meta Business Suite, asegurando que las plantillas cumplan con los requisitos y estándares de Meta.
• Flexibilidad para Agentes: Los agentes pueden reemplazar los valores de las variables en el mensaje, permitiendo una personalización según el cliente.
• Soporte para Múltiples Tipos de Archivos: Permite la inclusión de diferentes tipos de archivos multimedia, como imágenes, documentos y videos, en las plantillas.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para listar plantillas de WhatsApp

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite listar las plantillas asociadas a un conector de WhatsApp integrado en su operación. Esta API facilita la gestión y revisión de las plantillas de WhatsApp, proporcionando información detallada sobre cada una de ellas, incluyendo su estado, categoría y componentes.

Beneficios

• Gestión Centralizada: Facilita la gestión y revisión de las plantillas de WhatsApp, proporcionando una visión centralizada de todas las plantillas asociadas a un conector.
• Información Detallada: Proporciona información detallada sobre cada plantilla, incluyendo su estado, categoría y componentes, lo que facilita la toma de decisiones y la gestión de las plantillas.
• Integración con Meta: Permite una integración más fluida con Meta Business Suite, asegurando que las plantillas cumplan con los requisitos y estándares de Meta.
• Facilidad de Uso: Simplifica el proceso de revisión y gestión de plantillas, mejorando la eficiencia operativa y la experiencia del usuario.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para crear plantillas de mensajes de autenticación en WhatsApp

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite crear plantillas de mensajes de WhatsApp de tipo autenticación. Estas plantillas están diseñadas para enviar mensajes que requieren autenticación, como códigos de verificación, mejorando la seguridad y la experiencia del usuario al interactuar con servicios que requieren verificación de identidad.

Beneficios

• Seguridad Mejorada: Las plantillas de autenticación permiten enviar mensajes seguros que requieren verificación de identidad, mejorando la seguridad en las interacciones con los usuarios.
• Personalización de Mensajes: Facilita la creación de mensajes personalizados que incluyen códigos de verificación y botones de acción, mejorando la experiencia del usuario.
• Integración con Meta: Permite una integración fluida con Meta Business Suite, asegurando que las plantillas cumplan con los requisitos y estándares de Meta.
• Eficiencia Operativa: Automatiza el proceso de envío de códigos de verificación, reduciendo la necesidad de intervención manual y mejorando la eficiencia operativa.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para crear plantillas de mensajes de utilidad en WhatsApp

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite crear plantillas de mensajes de WhatsApp de categoría utilidad. Estas plantillas están diseñadas para enviar mensajes útiles y prácticos, mejorando la comunicación con los clientes al proporcionar información relevante y acciones rápidas.

Beneficios

• Comunicación Eficaz: Las plantillas de utilidad permiten enviar mensajes prácticos y útiles, mejorando la comunicación con los clientes al proporcionar información relevante.
• Personalización de Mensajes: Facilita la creación de mensajes personalizados que incluyen variables y botones de acción, mejorando la experiencia del usuario.
• Integración con Meta: Permite una integración fluida con Meta Business Suite, asegurando que las plantillas cumplan con los requisitos y estándares de Meta.
• Eficiencia Operativa: Automatiza el proceso de envío de mensajes útiles, reduciendo la necesidad de intervención manual y mejorando la eficiencia operativa.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para sincronizar plantillas de WhatsApp en wolkvox Manager

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite sincronizar las plantillas de WhatsApp creadas en un conector de WhatsApp con la integración de la operación en wolkvox Manager. Esta API facilita la gestión y actualización de las plantillas de WhatsApp, asegurando que todas las plantillas estén alineadas y actualizadas en el sistema.

Beneficios

• Sincronización Automática: Facilita la sincronización automática de las plantillas de WhatsApp, asegurando que todas las plantillas estén actualizadas y alineadas en el sistema.
• Gestión Centralizada: Permite una gestión centralizada de las plantillas, mejorando la eficiencia operativa y la experiencia del usuario.
• Integración con Meta: Asegura que las plantillas cumplan con los requisitos y estándares de Meta Business Suite, facilitando la integración y el uso de las plantillas en las comunicaciones.
• Actualización en Tiempo Real: Proporciona una actualización en tiempo real de las plantillas, mejorando la precisión y la relevancia de las comunicaciones enviadas a través de WhatsApp.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para editar plantillas de WhatsApp

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite editar la información de las plantillas de WhatsApp creadas en un conector de WhatsApp. Esta API facilita la actualización y modificación de las plantillas existentes, permitiendo a los usuarios ajustar el contenido y la estructura de los mensajes según sea necesario.

Beneficios

• Actualización Flexible: Permite la actualización y modificación flexible de las plantillas de WhatsApp, adaptándose a las necesidades cambiantes de la operación.
• Personalización de Mensajes: Facilita la personalización de los mensajes, mejorando la relevancia y efectividad de las comunicaciones enviadas a través de WhatsApp.
• Integración con Meta: Asegura que las plantillas cumplan con los requisitos y estándares de Meta Business Suite, facilitando la integración y el uso de las plantillas en las comunicaciones.
• Eficiencia Operativa: Mejora la eficiencia operativa al permitir la edición rápida y sencilla de las plantillas, reduciendo la necesidad de intervención manual.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva API para eliminar plantillas de WhatsApp

Se ha implementado una nueva API en el grupo de APIs de WhatsApp de wolkvox Manager que permite eliminar plantillas de WhatsApp creadas en un conector de WhatsApp integrado en una operación. Esta API facilita la gestión de plantillas, permitiendo a los usuarios eliminar aquellas que ya no son necesarias o que requieren ser reemplazadas.

Beneficios

• Gestión Eficiente de Plantillas: Permite una gestión eficiente de las plantillas de WhatsApp, facilitando la eliminación de plantillas obsoletas o innecesarias.
• Optimización de Recursos: Ayuda a optimizar los recursos al eliminar plantillas que ya no se utilizan, mejorando la organización y el rendimiento del sistema.
• Flexibilidad Operativa: Proporciona flexibilidad operativa al permitir la eliminación rápida y sencilla de plantillas, adaptándose a las necesidades cambiantes de la operación.
• Integración con Meta: Asegura que la gestión de plantillas cumpla con los requisitos y estándares de Meta Business Suite, facilitando la integración y el uso eficiente de las plantillas en las comunicaciones.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Envío de tarjetas tipo carrusel a WhatsApp desde wolkvox Studio con el componente “Responder chat”

Ahora es posible enviar mensajes tipo carrusel a través de WhatsApp utilizando la plantilla “media card carousel (api cloud)” en el componente “Responder Chat” dentro de wolkvox Studio. Esta funcionalidad está disponible únicamente para routing points de tipo ChatBot, y es compatible con conectores de WhatsApp tipo Cloud API.

Esta plantilla permite enviar mensajes ricos que incluyen múltiples tarjetas con imagen, texto y botones, ideales para mostrar catálogos, promociones, productos o servicios de forma interactiva.

Beneficios

• Presenta información visual y estructurada directamente en el chat de WhatsApp.
• Mejora la experiencia del usuario al interactuar con múltiples opciones en un solo mensaje.
• Aumenta la conversión en campañas de marketing o atención al cliente.
• Permite integrar botones de respuesta rápida y enlaces personalizados por tarjeta.

Requisito previo: Crear la plantilla tipo carrusel en Meta Business

Antes de poder usar una plantilla tipo carrusel en el componente Responder Chat (Reply Chat) de wolkvox Studio, es obligatorio crear previamente la plantilla en Meta Business.

Esta plantilla debe ser registrada correctamente en Meta utilizando la API oficial de plantillas de mensajes de WhatsApp.

Para conocer el paso a paso técnico sobre cómo crear estas plantillas tipo carrusel, consulta directamente la guía oficial de Meta dando [clic aquí]

Plantilla en wolkvox Studio

• name: Es el nombre exacto de la plantilla de Meta Business. Este valor debe coincidir, no se puede inventar.
• language.code: Código del idioma de la plantilla.
• Componente "body":  
  • "type": Tipo de componente. En este caso, siempre debe ser "body".
  • "parameters": 
    • "type": Tipo de parámetro. Aquí siempre es "text".
    • "text": Texto que reemplazará a las variables en la plantilla. Este campo es configurable y debe coincidir con las variables definidas en la plantilla.
• Componente "carousel": 
  • "type": Tipo de componente. Aquí siempre debe ser "carousel".
  • "cards": Un arreglo de tarjetas que forman el carrusel. Cada tarjeta tiene sus propios componentes.
• Tarjeta "card_index":  Índice de la tarjeta en el carrusel. Este campo es obligatorio y debe ser único para cada tarjeta.
  • Componentes de la tarjeta (header):  
    • "type": Tipo de parámetro. Aquí siempre es "image".
    • "image": Objeto que contiene la URL de la imagen.
      • "link": URL de la imagen. Este campo es configurable y debe ser una URL válida de una imagen.
  • Componentes de la tarjeta (body): 
    • "body": 
      • "parameters": Generalmente vacío, ya que el cuerpo de la tarjeta suele ser estático.
  • Componentes de la tarjeta (buttons): 
    • "sub_type": Subtipo de botón. Puede ser "quick_reply" o "url".
    • "index": Índice del botón. Debe coincidir con el índice definido en la creación de la plantilla.
    • "parameters": Parámetros del botón.
      • "type": Tipo de parámetro. Aquí siempre es "text".
      • "text": Texto asociado al botón. Este campo es configurable y debe coincidir con las variables definidas en la plantilla.

{
  "template": {
    "name": "carousel_media_cards_v2",
    "language": {
      "code": "es_MX"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Pablo"
          },
          {
            "type": "text",
            "text": "30% off"
          },
          {
            "type": "text",
            "text": "30OFF"
          }
        ]
      },
      {
        "type": "carousel",
        "cards": [
          {
            "card_index": 0,
            "components": [
              {
                "type": "header",
                "parameters": [
                  {
                    "type": "image",
                    "image": {
                      "link": "<url_link>"
                    }
                  }
                ]
              },
              {
                "type": "body",
                "parameters": []
              },
              {
                "type": "button",
                "sub_type": "quick_reply",
                "index": 0,
                "parameters": []
              },
              {
                "type": "button",
                "sub_type": "url",
                "index": 1,
                "parameters": [
                  {
                    "type": "text",
                    "text": "es"
                  }
                ]
              }
            ]
          },
          ...
        ]
      }
    ]
  }
}

Configuración del componente “Responder chat”

1. Arrastra el componente "Responder Chat" al flujo en un routing point de tipo ChatBot y haz doble clic sobre el componente para abrir su panel de configuración.
2. En la parte superior del panel, selecciona la pestaña “Avanzado”.
3. En el campo Plantillas, selecciona la plantilla “media card carousel (api cloud)”.
4. Haz clic en el botón “Cargar plantilla”.
5. Se autocompletará un bloque JSON con la estructura de la plantilla. Allí podrás modificar los parámetros de texto, imágenes y botones de cada tarjeta según lo necesites. Puedes cambiar valores como el nombre del cliente, porcentaje de descuento, enlaces personalizados, etc. Cada tarjeta puede tener una imagen (header), texto (body) y botones de respuesta rápida o enlaces (buttons).
6. Una vez configurado el contenido, haz clic en Guardar para aplicar los cambios al componente.

Optimización de la API "Solicitar detalle de la campaña" (API 6 de Campañas): Inclusión de Todos los Registros

Se ha implementado una mejora significativa en la API "6. Solicitar detalle de la campaña" del grupo de APIs "Campañas" en Wolkvox Manager. Esta API, utilizada para obtener información detallada sobre campañas predictivas, progresivas y preview, ahora permite una visión más completa del universo de contactos de una campaña.

Anteriormente, la API solo retornaba registros que poseían un conn_id (indicando que habían sido gestionados telefónicamente). Con esta mejora, ahora es posible incluir en la respuesta todos los registros cargados en la campaña, incluso aquellos que aún no tienen un conn_id o que no han sido gestionados telefónicamente.

El comportamiento de esta API se controla mediante un nuevo parámetro en la solicitud, que permite al usuario elegir el nivel de detalle deseado:

• default: Este valor mantiene el funcionamiento original de la API, retornando únicamente los registros que tienen un conn_id (aquellos que han tenido algún tipo de gestión telefónica).
• all: Este nuevo valor expande la respuesta para incluir todos los registros cargados en la campaña, independientemente de si han sido gestionados telefónicamente o no, o si poseen un conn_id.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Nueva columna “Characters” en el reporte “8. CDR TTS” de Diagram Reports

Se ha implementado una mejora en el reporte "8. CDR TTS" dentro de la sección "Reportes" del menú lateral izquierdo de Wolkvox Manager. Ahora, este reporte incluye una nueva columna denominada "Characters". Esta adición permite a los usuarios visualizar la cantidad total de caracteres utilizados en cada interacción específica con un cliente que ha involucrado el componente "TTS" (Text-to-Speech) de Wolkvox Studio.

La columna "Characters" proporciona una métrica detallada del volumen de texto procesado por el motor TTS para generar el audio de la interacción, ofreciendo una visión más clara del uso y costo asociado a este componente.

Beneficios

• Optimización de Costos: Permite a las empresas monitorear y gestionar de manera más efectiva los costos asociados al uso del servicio TTS, ya que la facturación de algunos proveedores puede estar basada en el volumen de caracteres procesados.
• Análisis Detallado: Ofrece una métrica adicional para el análisis de las interacciones, lo que puede ayudar a identificar patrones de uso del TTS y optimizar la extensión de los mensajes.
• Toma de Decisiones Informada: Facilita la toma de decisiones sobre la configuración y el uso de los componentes TTS en Wolkvox Studio, permitiendo ajustes para mejorar la eficiencia y la rentabilidad.
• Transparencia en el Consumo: Proporciona mayor transparencia sobre el consumo de recursos de TTS por interacción, lo cual es vital para operaciones que dependen en gran medida de esta tecnología.

Nuevos parámetros en la API “4. Detalle de interacciones” del grupo de APIs “Interacciones y Chats”

Se ha optimizado la API "4. Detalle interacciones" en wolkvox Manager, incorporando dos nuevos parámetros que ofrecen mayor flexibilidad y funcionalidad al consultar el detalle de las interacciones. Esta API permite obtener información detallada sobre las interacciones, incluyendo datos del mensaje (remitente, gestor de la atención, mensaje y respuesta), el skill, fechas de creación y cierre, el agente, evaluación y comentarios.

Los nuevos parámetros añadidos son:

• attach_array: Este parámetro permite especificar el formato del resultado, ya sea en array o en formato JSON. Los valores posibles son yes para array y no para JSON.
• include_attachments: Este parámetro permite incluir o excluir archivos adjuntos en la respuesta de la API. Los valores posibles son true para incluir archivos adjuntos y false para excluirlos.

Lee la documentación oficial de la API dando [clic aquí].

Lee la documentación en Postman Collections dando [clic aquí].

Beneficios

• Flexibilidad en el Formato de Respuesta: La capacidad de elegir entre recibir los datos en formato de array o JSON permite una mayor adaptabilidad a las necesidades específicas de procesamiento y análisis de datos de los usuarios.
• Inclusión de Archivos Adjuntos: La opción de incluir o excluir archivos adjuntos en la respuesta proporciona un control más detallado sobre la información recuperada, optimizando el uso de recursos y el ancho de banda según sea necesario.
• Información Detallada y Completa: La API ofrece una visión completa y detallada de las interacciones, facilitando un análisis exhaustivo y una mejor comprensión de las comunicaciones entre clientes y agentes.
• Mejora en la Toma de Decisiones: Con información más detallada y opciones de formato flexibles, los administradores y analistas pueden tomar decisiones más informadas y precisas, mejorando la gestión y la calidad del servicio.
• Optimización de Procesos: La capacidad de personalizar las respuestas de la API ayuda a optimizar los procesos internos, permitiendo una integración más eficiente con otros sistemas y herramientas de análisis.