# How to clear a queue on WhatsApp

### Clearing the Message Queue for WhatsApp Connections

For WhatsApp Business connections, the “Clear Queue” button is available in the connection card. This feature is used when the connection has dropped (the session becomes invalid) and messages stop being sent or received. 

Such connections have the status in the list of connections: "scan the QR code in the WhatsApp mobile application"

<figure><img src="https://2698812344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcL4cMgr32epKlKAkiQmx%2Fuploads%2F1iWOhbC8FSbPgXwrQ2aP%2FScreenshot%202025-11-25%20at%2015-46-25.png?alt=media&#x26;token=3f2e92de-ce06-4eeb-9e87-1cc7e718470f" alt=""><figcaption></figcaption></figure>

#### How the “Clear Queue” Button Works

{% hint style="warning" %}
After confirmation, the entire message queue for this connection is cleared.\
The button is visible only to employees with the **“Connection — Edit”** access right.\
\
Learn more about access rights in this document: "[Available rights for roles](https://docs.radist.online/docs/our-products/radist-web/staff#available-rights-for-roles)**"**
{% endhint %}

When you click the button, a confirmation window appears.&#x20;

<figure><img src="https://2698812344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcL4cMgr32epKlKAkiQmx%2Fuploads%2FpXlaAy3D0n8CEkZmu5ch%2FScreenshot%202025-11-25%20at%2015.47.02.png?alt=media&#x26;token=601b33b1-4f52-42c3-a26d-1cebcf31f12b" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}

#### What Happens After Clearing

* The system fully clears the message queue within up to 5 minutes.
* During this time, no messages are sent through this connection.
* You can continue communication only after the clearing process is completed.
  {% endhint %}

#### When to Use Queue Clearing

**Case: Broadcast and Ban**

If the number gets banned during a broadcast and message sending stops, the queue may contain messages that haven’t been delivered yet. After the ban is lifted, the system will try to send them — which is often undesirable.

In this situation, use **“Clear Queue”** to delete all messages prepared for sending and prevent them from being delivered after the ban is lifted.