---
title: WhatsApp Buttons (BETA)
slug: whatsapp-buttons-beta
docTags: 
createdAt: 2025-08-17T22:53:17.720Z
---

### Introduction

The #Button command allows sending **interactive messages** with predefined response buttons. It is especially useful for **quick surveys**, **service evaluations**, **confirmations**, or any flow where the user must select an option in a **simple and structured** way. Proper implementation improves the **user experience** and simplifies **data collection** in the system.



::Image[]{src="https://api.archbee.com/api/optimize/srzEvL3tK0Cgq-VfwOzrO/WfGr2gQT5GpqdZDz-SyR3_image.png" size="48" width="432" height="285" position="center" showCaption="false"}



### Command Syntax

:::BlockQuote
\#Button|\<Message shown to the user>|\<Option1>\*\<OptionID1>/\<Option2>\*\<OptionID2>/...
:::

### How it works

1. **#Button**
   &#x20;Instructs the system to display a **message with interactive buttons** instead of plain text.
2. **\<Message shown to the user>**
   &#x20;The **main text** displayed above the buttons, usually framed as a **question or instruction**.
3. **\<OptionX>**
   &#x20;The **text visible** on each button. This is what the user selects.
4. **\*\<OptionIDX>**
   &#x20;A **unique identifier** assigned to each option.
   - Used to **log the user’s choice** in a structured format.
   - Can **trigger automated flows** or specific actions in the CRM/chatbot.
5. **/**
   &#x20;Acts as the **separator** between the different button options.

### Example

:::BlockQuote
\#Button|Hello, we recently assisted you, how would you rate our service?|⭐⭐⭐⭐⭐\*id\_excellent/⭐⭐⭐\*id\_normal/⭐\*id\_poor/
:::

- The user will see the message:
  &#x20;**"Hello, we recently assisted you, how would you rate our service?"**
- Three **buttons** will appear below:
  1. ⭐⭐⭐⭐⭐ → **Excellent rating**
  2. ⭐⭐⭐ → **Normal rating**
  3. ⭐ → **Poor rating**

Each button is **linked to an ID**:

- id\_excellent for **5 stars**.
- id\_normal for **3 stars**.
- id\_poor for **1 star**.

### Result

1. The user receives a **message with buttons**.
2. When the user clicks a button:
   - The **response is recorded** with its corresponding ID.
   - Your CRM may trigger an **automated flow**, such as:
     - **Saving the response** in the database.
     - **Sending a thank-you message**.
     - **Alerting the support team** if the rating is low.
   - Check how your CRM saves responses in their official documentation:
     - [Highlevel CRM Integration](docId\:qH5M7bG-7rf8ySjWwpjXm)&#x20;

### ⚠️ Important Notes

1. **IDs must be unique and consistent** across the system to avoid errors.
2. **Keep button texts short**, as long labels may not display correctly on all devices.
3. **Use clear and neutral language** in the main message to increase response rates.
4. It is recommended to include **no more than 3–5 buttons per message** to keep the interaction simple.