Use Dynamic Lists in Interactive WhatsApp message

Sendwo's dynamic lists revolutionize your WhatsApp interactions. By leveraging data from custom fields, you can create interactive messages with rows that dynamically populate with relevant information.

These lists are powered by JSON objects, where each row's details (title, description, values) are determined by specifying the corresponding keys (e.g., product_name, price).

This guide will provide a step-by-step walkthrough on configuring and utilizing this powerful feature, using a product catalog example for practical understanding.

What Are Dynamic Lists?

Dynamic lists revolutionize your WhatsApp messages by automatically generating rows based on JSON data stored in a custom field. Simply specify the relevant keys within your JSON object, and the system effortlessly creates personalized rows for each subscriber.

By leveraging dynamic lists, you can effortlessly display relevant information, making your WhatsApp messages more engaging and personalized. For a practical demonstration of how to utilize dynamic lists with WooCommerce products, explore our comprehensive guide: How to Display WooCommerce Products Inside WhatsApp.

Example Use Case:

Suppose you want to send a product catalog to a user. Your data (API response) might look like this:

[
  {
    "product_name": "Apple iPhone 15 Pro",
    "price": "$999",
    "description": "The Apple iPhone 15 Pro features a powerful A17 Pro chip, 48MP camera system, and a sleek titanium design for maximum performance and durability.",
    "buy_link": "https://www.apple.com/iphone-15-pro/"
  },
  {
    "product_name": "Samsung Galaxy S24 Ultra",
    "price": "$1,199",
    "description": "The Samsung Galaxy S24 Ultra offers a stunning 6.8-inch AMOLED display, a 200MP camera, and cutting-edge performance with the latest Snapdragon processor.",
    "buy_link": "https://www.samsung.com/galaxy-s24-ultra/"
  }
]

Using this feature, each product dynamically generates a row with its respective title, description, and action buttons.

Step 1: Fetch Data Using HTTP API

1. Set Up the API Request:

• Navigate to HTTP API Integration in Sendwo.
• Configure the API to fetch your data (e.g., product catalog).

Example API Response:

[
  {
    "product_name": "Apple iPhone 15 Pro",
    "price": "$999",
    "description": "The Apple iPhone 15 Pro features a powerful A17 Pro chip, 48MP camera system, and a sleek titanium design for maximum performance and durability.",
    "buy_link": "https://www.apple.com/iphone-15-pro/"
  },
  {
    "product_name": "Samsung Galaxy S24 Ultra",
    "price": "$1,199",
    "description": "The Samsung Galaxy S24 Ultra offers a stunning 6.8-inch AMOLED display, a 200MP camera, and cutting-edge performance with the latest Snapdragon processor.",
    "buy_link": "https://www.samsung.com/galaxy-s24-ultra/"
  }
]

2. Save API Response to a Custom Field:

• Assign the API response to a custom field.(e.g., ProductCatalog). And map value will be List Items
• The response must be in JSON format containing an array of objects.

Step 2: Configure Dynamic Rows in the Flow Builder

To populate your interactive message with dynamic rows, follow these steps:

1. Row Generation Method: Choose Dynamic to enable rows based on the custom field data.
2. Custom Field for Dynamic Rows: Select the custom field containing the JSON data (e.g., ProductCatalog).
3. Key/Index for Dynamic Row Title: Specify the key from the JSON object to be used as the row title.
   • Example: Use product_name to dynamically display values like "Apple iPhone 15 Pro" or "Samsung Galaxy S24 Ultra".
4. Row Description Format: Define the row description using multiple keys from the JSON object.
   • Format: #custom_field->key#Example: #ProductCatalog->price# - #ProductCatalog->description# will display:

$999 - The Apple iPhone 15 Pro features a powerful A17 Pro chip, 48MP camera system, and a sleek titanium design for maximum performance and durability.

1. Save Selection to Custom Field: Choose a custom field where the user’s selection will be stored (e.g., SelectedProduct).
2. Key/Index for Saved Value: Specify the key from the JSON object whose value should be saved to the custom field.
   • Example: Use buy_link to save the product’s purchase link (e.g., https://www.apple.com/iphone-15-pro/).

Step 3: Test Your Dynamic List

1. Preview the Message:

• Access the Flow Builder and preview the dynamic list within your message.
• Carefully examine the generated rows to ensure they accurately reflect the data received from the API.

2. Simulate User Interaction:

• Interact with the message as if you were a user, selecting one of the dynamically generated rows.
• Verify that the selected value is correctly saved to the specified custom field.

Real-Life Examples

1. Product Catalog

API Response:

[
  {
    "product_name": "Apple iPhone 15 Pro",
    "price": "$999",
    "description": "Powerful A17 Pro chip and 48MP camera.",
    "buy_link": "https://www.apple.com/iphone-15-pro/"
  },
  {
    "product_name": "Samsung Galaxy S24 Ultra",
    "price": "$1,199",
    "description": "6.8-inch AMOLED display and 200MP camera.",
    "buy_link": "https://www.samsung.com/galaxy-s24-ultra/"
  }
]

Dynamic Configuration:

• Row Title (Key): product_name
• Row Description: #ProductCatalog->price# - #ProductCatalog->description#
• Saved Value (Key): buy_link

Best Practices

• Ensure API Responses Are Well-Formatted: The API response must be a JSON array of objects.
• Use Clear Keys and Descriptions: Keep your keys intuitive and descriptions user-friendly.
• Test Before Deploying: Verify that rows are dynamically generated and selections are saved correctly.

Conclusion

Effortlessly create personalized WhatsApp messages with Sendwo's dynamic lists. Simply reference keys within your JSON data to populate rows with product names, descriptions, and more. It's easy to use and delivers a truly interactive experience for your customers. Start using dynamic lists today!