New API for uploading a sample file to Meta Business

A new API has been implemented in the wolkvox Manager WhatsApp API group, allowing file uploads to Meta Business Suite. This file will be used as an example of a media file, which Meta requires when creating a WhatsApp template that includes a media file as an attachment. It is important to note that this media file is only an example and will not be included in the WhatsApp template. Agents sending a message using a WhatsApp template must include the public URL of the file they wish to attach and place it in the 'WhatsApp File Link' field in the 'Send WhatsApp' form of the wolkvox Agent application on the web version or in the 'File URL' field of the wolkvox Agent application on the desktop version. Only image, video, or document files are allowed.

Benefits

• Meta Requirements Compliance: Make it easier to meet Meta requirements by creating WhatsApp templates that include media files.
• Agent Flexibility: Allows agents to include the public URL of the file they want to attach when using the template, providing flexibility in the content sent.
• Integration with Meta Business Suite: Simplify the process of uploading media to Meta Business Suite by integrating this functionality directly into wolkvox Manager.
• Support for Multiple File Types: Allows uploading of different types of media files, including images, videos, and documents, expanding the usability of WhatsApp templates.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API for creating WhatsApp templates in the Marketing category

A new API has been implemented in the wolkvox Manager WhatsApp API group that allows you to create a Marketing category WhatsApp template in a WhatsApp connector linked to your operation. This API facilitates the creation of custom templates for marketing campaigns, allowing users to define message content and variables.

Benefits

• Message Personalization: Allows you to create custom WhatsApp templates for marketing campaigns, improving customer engagement.
• Meta Integration: Facilitates integration with Meta Business Suite, ensuring that templates meet Meta requirements and standards.
• Flexibility for Agents: Agents can override variable values in the message, allowing for customer-specific customization.
• Support for Multiple File Types: Allows the inclusion of different types of multimedia files, such as images, documents, and videos, in templates.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API for listing WhatsApp templates

A new API has been implemented in the WhatsApp API group of wolkvox Manager that allows you to list the templates associated with a WhatsApp connector integrated into your operation. This API facilitates the management and review of WhatsApp templates, providing detailed information about each one, including its status, category, and components.

Benefits

• Centralized Management: Facilitates the management and review of WhatsApp templates, providing a centralized view of all templates associated with a connector.
• Detailed Information: Provides detailed information about each template, including its status, category, and components, making it easier to make decisions and manage templates.
• Meta Integration: Enables seamless integration with Meta Business Suite, ensuring templates meet Meta requirements and standards.
• Ease of Use: Simplifies the template review and management process, improving operational efficiency and user experience.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API for creating authentication message templates on WhatsApp

A new API has been implemented in the wolkvox Manager WhatsApp API group that allows you to create authentication-type WhatsApp message templates. These templates are designed to send messages that require authentication, such as verification codes, improving security and the user experience when interacting with services that require identity verification.

Benefits

• Enhanced Security: Authentication templates allow you to send secure messages that require identity verification, improving security in interactions with users.
• Message Personalization: Facilitates the creation of personalized messages that include verification codes and action buttons, improving the user experience.
• Meta Integration: Enables seamless integration with Meta Business Suite, ensuring that templates meet Meta requirements and standards.
• Operational Efficiency: Automates the verification code sending process, reducing the need for manual intervention and improving operational efficiency.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API for creating useful message templates on WhatsApp

A new API has been implemented in the wolkvox Manager WhatsApp API group that allows you to create utility-category WhatsApp message templates. These templates are designed to send useful and actionable messages, improving customer communication by providing relevant information and quick action items.

Benefits

• Effective Communication: Useful templates allow you to send practical and useful messages, improving communication with customers by providing relevant information.
• Message Personalization: Facilitates the creation of personalized messages that include variables and action buttons, improving the user experience.
• Meta Integration: Enables seamless integration with Meta Business Suite, ensuring that templates meet Meta requirements and standards.
• Operational Efficiency: Automates the process of sending useful messages, reducing the need for manual intervention and improving operational efficiency.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API for syncing WhatsApp templates in wolkvox Manager

A new API has been implemented in the wolkvox Manager WhatsApp API group that allows WhatsApp templates created in a WhatsApp connector to be synchronized with the operation integration in wolkvox Manager. This API facilitates the management and updating of WhatsApp templates, ensuring that all templates are aligned and up-to-date in the system.

Benefits

• Automatic Synchronization: Facilitates automatic synchronization of WhatsApp templates, ensuring that all templates are up-to-date and aligned in the system.
• Centralized Management: Allows centralized management of templates, improving operational efficiency and user experience.
• Meta Integration: Ensures that templates meet Meta Business Suite requirements and standards, making it easy to integrate and use templates in communications.
• Real-Time Update: Provides real-time updates to templates, improving the accuracy and relevance of communications sent through WhatsApp.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API for editing WhatsApp templates

A new API has been implemented in the wolkvox Manager WhatsApp API group that allows editing information in WhatsApp templates created in a WhatsApp connector. This API makes it easy to update and modify existing templates, allowing users to adjust the content and structure of messages as needed.

Benefits

• Flexible Update: Allows flexible updating and modification of WhatsApp templates, adapting to the changing needs of the operation.
• Message Personalization: Facilitates message personalization, improving the relevance and effectiveness of communications sent through WhatsApp.
• Meta Integration: Ensures that templates meet Meta Business Suite requirements and standards, making it easy to integrate and use templates in communications.
• Operational Efficiency: Improve operational efficiency by enabling quick and easy editing of templates, reducing the need for manual intervention.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New API to delete WhatsApp templates

A new API has been implemented in the wolkvox Manager WhatsApp API group that allows you to delete WhatsApp templates created in an integrated WhatsApp connector in one operation. This API facilitates template management, allowing users to delete templates that are no longer needed or need to be replaced.

Benefits

• Efficient Template Management: Allows efficient management of WhatsApp templates, making it easy to delete obsolete or unnecessary templates.
• Resource Optimization: Helps optimize resources by eliminating templates that are no longer used, improving system organization and performance.
• Operational Flexibility: Provides operational flexibility by allowing for quick and easy deletion of templates, adapting to the changing needs of the operation.
• Meta Integration: Ensures that template management meets Meta Business Suite requirements and standards, facilitating the integration and efficient use of templates in communications.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

Sending carousel-style cards to WhatsApp from wolkvox Studio with the “Reply to Chat” component

It's now possible to send carousel-style messages through WhatsApp using the "Media Card Carousel (Cloud API)" template in the "Reply Chat" component within wolkvox Studio. This feature is only available for ChatBot routing points and is compatible with WhatsApp Cloud API connectors.

This template allows you to send rich messages that include multiple cards with images, text, and buttons, ideal for displaying catalogs, promotions, products, or services interactively.

Benefits

• Presents visual and structured information directly in the WhatsApp chat.
• Improves user experience by interacting with multiple options in a single message.
• Increase conversion in marketing or customer service campaigns.
• Allows you to integrate quick response buttons and custom links per card.

Prerequisite: Create the carousel template in Meta Business

Before you can use a carousel template in the Reply Chat component of wolkvox Studio, you must first create the template in Meta Business.

This template must be properly registered in Meta using the official WhatsApp Message Template API.

For technical step-by-step instructions on how to create these carousel templates, please refer directly to the official Meta guide by clicking [ here ].

Template in wolkvox Studio

• name: This is the exact name of the Meta Business template. This value must match; it cannot be made up.
• language.code: Template language code.
• "body" component:
  • "type": Component type. In this case, it must always be "body".
  • "parameters":
    • "type": Parameter type. Here it is always "text".
    • "text": Text that will replace the variables in the template. This field is configurable and must match the variables defined in the template.
• "Carousel" component:
  • "type": Component type. This should always be "carousel".
  • "cards": An arrangement of cards that make up the carousel. Each card has its own components.
• Card "card_index": Card index in the carousel. This field is required and must be unique for each card.
  • Card components (header):
    • "type": Parameter type. Here it is always "image".
    • "image": Object containing the URL of the image.
      • "link": Image URL. This field is configurable and must be a valid image URL.
  • Card components (body):
    • "body":
      • "parameters": Usually empty, since the card body is usually static.
  • Card components (buttons):
    • "sub_type": Button subtype. Can be "quick_reply" or "url".
    • "index": The button's index. This must match the index defined when creating the template.
    • "parameters": Button parameters.
      • "type": Parameter type. Here it is always "text".
      • "text": Text associated with the button. This field is configurable and must match the variables defined in the template.

{
  "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"
                  }
                ]
              }
            ]
          },
          ...
        ]
      }
    ]
  }
}

Configuring the “Reply Chat” component

1. Drag the "Reply Chat" component into a ChatBot routing point flow and double-click the component to open its configuration panel.
2. At the top of the panel, select the “Advanced” tab.
3. In the Templates field, select the “media card carousel (cloud api)” template.
4. Click the “Upload Template” button.
5. A JSON block will be automatically populated with the template structure. There you can modify the text, image, and button parameters for each card as needed. You can change values such as the customer's name, discount percentage, custom links, and more. Each card can have an image (header), text (body), and quick response buttons or links (buttons).
6. Once you've configured your content, click Save to apply the changes to the component.

Note: "Carousel" templates are limited to being sent only from a chat-type routing point in Wolkvox Studio. They cannot be sent directly from the Wolkvox Agent application by an agent. This configuration helps maintain consistency and automation in the presentation of structured and visually compelling information through predefined chat flows.

Sending Flow Templates via WhatsApp Cloud API in wolkvox Studio

The ability to send flow templates via WhatsApp Cloud API connectors has been added in Wolkvox Studio. This feature is specifically designed for ChatBot routing points, enabling the creation of more dynamic and interactive conversational experiences in WhatsApp. Flow templates guide the user through a multi-step process with interactive options, such as buttons, lists, or input fields, facilitating actions such as scheduling appointments, filling out forms, or registering for events.

Benefits

• Guided Experience: Provides customers with clear step-by-step instructions, facilitating interaction and reducing errors.
• Frictionless Automation: Allows you to collect information or complete actions without the need for immediate human intervention.
• Versatility: Ideal for a variety of use cases, such as surveys, data updates, confirmations, or event registration.

How to send Flow templates in wolkvox Studio?

1. Access Wolkvox Studio: Enter Wolkvox Manager, go to the interaction flow design section (Wolkvox Studio), and open the desired ChatBot routing point. Drag and drop the "Reply Chat" component into your design flow.
2. Double-click the "Chat Reply" component to open its properties. Select the "Advanced" tab.
3. In the "Templates" field, find and select the 'flow template (api cloud)' template.
4. Click “Upload Template.”
5. The following template will be loaded into the assigned space.

{
    "type": "flow",
    "name_template": "<name_template>",
    "params": [
        "sport"
    ],
    "language": "en_US"
}

• type: This field indicates the template type. Its value should not be changed; it will always be "flow."
• name_template: Name of the flow template previously created in Meta Business. This field must match the name of an existing template.
• params: List of parameters to be used in the template. These parameters must match those defined in the flow template.
• Language: This field defines the language of the flow. Its value should not be changed; it must match the language in which the template was approved in Meta.

6. Save Configuration: Once you've configured the JSON with the necessary parameters, click the "Save" button to apply the changes to the component.

Note: Flow templates in Wolkvox Studio are designed to be sent only from a chat routing point. Currently, these templates cannot be sent directly from the application by an agent. This restriction ensures that interactions using flow templates are managed automatically and consistently within the chat flows configured in Wolkvox Studio.

"Request Campaign Details" API Optimization (Campaigns API 6): Inclusion of All Records

A significant improvement has been implemented in the "6. Request Campaign Details" API in the "Campaigns" API group in Wolkvox Manager. This API, used to obtain detailed information about predictive, progressive, and preview campaigns, now allows for a more complete view of a campaign's contact universe.

Previously, the API only returned records with a conn_id (indicating they had been processed over the phone). With this improvement, it's now possible to include all records uploaded to the campaign in the response, even those that don't yet have a conn_id or haven't been processed over the phone.

The behavior of this API is controlled by a new parameter in the request, which allows the user to choose the desired level of detail:

• default: This value maintains the original operation of the API, returning only records that have a conn_id (those that have had some type of telephone management).
• all: This new value expands the response to include all records loaded into the campaign, regardless of whether they have a conn_id or not.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

New “Characters” column in the “8. CDR TTS” report of Diagram Reports

An improvement has been implemented in the "8. CDR TTS" report within the "Reports" section of the left-hand side menu of Wolkvox Manager. This report now includes a new column called "Characters." This addition allows users to view the total number of characters used in each specific customer interaction involving the "TTS" (Text-to-Speech) component of Wolkvox Studio.

The "Characters" column provides detailed metrics on the volume of text processed by the TTS engine to generate the interaction audio, offering a clearer view of the usage and cost associated with this component.

Benefits

• Cost Optimization: Allows companies to more effectively monitor and manage costs associated with using TTS services, as some providers' billing may be based on the volume of characters processed.
• Detailed Analysis: Provides an additional metric for analyzing interactions, which can help identify TTS usage patterns and optimize message delivery.
• Informed Decision-Making: Facilitates decision-making about the configuration and use of TTS components in Wolkvox Studio, enabling adjustments to improve efficiency and cost-effectiveness.
• Consumption Transparency: Provides greater transparency into TTS resource consumption per interaction, which is vital for operations that rely heavily on this technology.

New parameters in the “4. Interaction Details” API of the “Interactions and Chats” API group

The "4. Interaction Details" API in Wolkvox Manager has been optimized, incorporating two new parameters that offer greater flexibility and functionality when viewing interaction details. This API allows you to obtain detailed information about interactions, including message details (sender, support manager, message and response), skill, creation and closing dates, agent, rating, and comments.

The new parameters added are:

• attach_array: This parameter allows you to specify the format of the result, either as an array or in JSON format. Possible values are yes for array and no for JSON.
• include_attachments: This parameter allows you to include or exclude attachments in the API response. Possible values are true to include attachments and false to exclude them.

Read the official API documentation by clicking [ here ].

Read the documentation on Postman Collections by clicking [ here ].

Benefits

• Response Format Flexibility: The ability to choose between receiving data in array or JSON format allows for greater adaptability to users' specific data processing and analysis needs.
• Including Attachments: The option to include or exclude attachments in the response provides more granular control over the information retrieved, optimizing resource and bandwidth usage as needed.
• Detailed and Complete Information: The API provides a complete and detailed view of interactions, facilitating in-depth analysis and a better understanding of communications between customers and agents.
• Improved Decision-Making: With more detailed information and flexible formatting options, administrators and analysts can make more informed and accurate decisions, improving management and service quality.
• Process Optimization: The ability to customize API responses helps optimize internal processes, enabling more efficient integration with other systems and analytics tools.