# How to build a WA List Message

{% embed url="<https://youtu.be/AAr0BaB_sWw>" %}
How to build WhatsApp List Message
{% endembed %}

### What is WhatsApp List Message

A WhatsApp list message is an interactive message that lets you create a list of options for your contacts to choose from. Interactive messages on WhatsApp give your users a simpler way to find and select what they want from your business.&#x20;

### Understanding List Message Components Header, Button, Item, etc.

#### When a user taps the button in the message, it displays a modal that lists the options:

<figure><img src="https://2313828995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdBA0EUhBaqGNudxOfOLO%2Fuploads%2FEbHup20XZxJuK2d7wSQQ%2FLists%20-%20Graphic%20(2).png?alt=media&#x26;token=97114d59-d79e-4604-a089-8efc24ede585" alt=""><figcaption><p>Interactive list messages</p></figcaption></figure>

### **How to build the list**

You can easily build the WhatsApp List messages using the Workflow automation. You can refer to the video and description given below.

### **Parameters - Keys and Values**

<table data-full-width="false"><thead><tr><th width="161">Key</th><th width="161">Sample Value</th><th width="419">Description</th></tr></thead><tbody><tr><td>Action Name</td><td>Main Menu</td><td>Any name which you prefer</td></tr><tr><td>keyword</td><td>sample</td><td><p><strong>Required</strong></p><p>Maximum 20 characters</p></td></tr><tr><td>list_header</td><td>List Header</td><td><strong>Required</strong><br>Maximum 60 characters</td></tr><tr><td>message</td><td>Message Here</td><td><p><strong>Required</strong></p><p>Maximum 4096 characters</p></td></tr><tr><td>footer</td><td>This is Footer</td><td><p><strong>Optional</strong></p><p>Maximum 60 characters</p></td></tr><tr><td>button_name</td><td>Button Here</td><td><p><strong>Required</strong></p><p>Maximum 20 characters</p></td></tr><tr><td>list_title</td><td>Title Here</td><td><p><strong>Optional</strong></p><p>Maximum 24 characters</p></td></tr><tr><td>item1</td><td>Option1</td><td><p><strong>Required</strong></p><p>Maximum 24 characters</p></td></tr><tr><td>Item2</td><td>Option2</td><td><p><strong>Optional</strong></p><p>Maximum 30 items and maximum 24 characters</p></td></tr><tr><td>desc1</td><td>Description of item 1</td><td><strong>Optional</strong><br>Maximum 30 descriptions and maximum 72 characters<br></td></tr><tr><td>desc2</td><td>Description of item 2</td><td><strong>Optional</strong><br>Maximum 30 descriptions and maximum 72 characters</td></tr></tbody></table>

### **Multi User Parameters - Keys and Values**

If you are using the multi-user feature, i.e you are using more than one WhatsApp number in your sub-account for sending messages.&#x20;

<table data-full-width="false"><thead><tr><th width="161">Key</th><th width="161">Sample Value</th><th width="419">Description</th></tr></thead><tbody><tr><td>source_user_id</td><td>userid</td><td><p><strong>Required</strong></p><p>User ID of the GHL sub-account, only in case you are using multi-user feature</p></td></tr></tbody></table>

### SOP: Creating a Custom List for Clients

#### Objective:

To create a customized and easy-to-use list for clients or personal use using workflow automation.

#### Key Steps:

1. Go to workflow automation and click on "create workflow."
2. Select "start from scratch" and open an existing workflow or create a new one.
3. Click on the plus sign and select "webhook."
4. Name the webhook (e.g., main menu)
5. Set the keyword and ensure it is unique and relevant (e.g., menu).
6. Define the list header, messages, footer, and other keys and values according to your requirements.
7. Create sub-menus by following the same process with matching keywords (e.g., sales).
8. Familiarize yourself with the keys and values by creating a sample list with exact values.
9. Test the list by sending the keyword on WhatsApp to ensure it displays correctly.
10. Make necessary changes to the values to customize the list as needed.

#### Cautionary Notes:

* <mark style="color:red;">**Whenever you create or modify a list make sure to: Save the list, Save the workflow, and rerun the Test Workflow to save the list in our system**</mark>
* Ensure the keyword is unique and easy to remember for users.
* Test the list thoroughly before deploying it for clients.

#### Tips for Efficiency:

* Utilize the help section for detailed information on keys and values
* Start with a simple sample list to understand how values will appear.
* Regularly update and customize the list based on client requirements.

### Note

GHL charges a small fee for the premium actions, but as you need to build or update the list occasionally, the cost remains low and negligible.

So, for your convenience and an error-free experience, you can use premium actions to build the list