> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatically Add Customers to Unsubscribe List

Use a YCloud Rule-based Agent to confirm unsubscribe requests and add customers to your unsubscribe list.

Example:

When a customer's message to unsubscribe is received, the Rule-based Agent automatically asks the customer if they confirm they want to unsubscribe, and for those who confirm a second time, adds them to the unsubscribe list.

<Frame caption="A confirmation flow routes OPT-OUT to Unsubscribe and keeps the other branch subscribed.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-complete-flow.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=4aead9ee880f3063f987b3194d005835" alt="Keyword trigger connected to confirmation buttons, Unsubscribe, and Send messages." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-complete-flow.png" />
</Frame>

## Step 1: Create a Rule-based Agent flow

<Frame caption="Open Flows and select Create a flow.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-demo-flow-list-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=972fcc6559b08de5043e5d0f2f812fe5" alt="Rule-based Agent flow list with Create a flow and the inactive demonstration flow." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-demo-flow-list-annotated.svg" />
</Frame>

## Step 2: Add unsubscribe trigger keywords

<Info>
  Recommendation: Set multiple unsubscribe keywords and choose "Containing" rather than "Exact matching". This way, any keyword in the list will trigger the Rule-based Agent. After setting up, click the save button.
</Info>

<Frame caption="Choose Containing and add the keywords customers use to opt out.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-keywords-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=7fbd06fc0506384980d18aee19a3288f" alt="Containing keyword rule with STOP and unsubscribe." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-keywords-annotated.svg" />
</Frame>

## Step 3: Confirm customer's unsubscribe intention (optional)

<Warning>
  Strongly recommend adding this step to avoid customers mistakenly entering the unsubscribe list. You can choose to use the "Ask a question" component to ask the customer: "Please confirm if you want to unsubscribe from messages?"
</Warning>

Detailed steps:

1. Select the "Ask a question" component

2. Choose the Buttons message format

<Frame caption="Choose Buttons for a confirmation question.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-question-format-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=7932eaffc1620487c51611ecca1f8135" alt="Ask a question message-format menu with Buttons." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-question-format-annotated.svg" />
</Frame>

3. Set the inquiry content: "Please confirm if you want to unsubscribe from WhatsApp?"

* Set two options for the Button
  * OPT-OUT
  * Keep me subscribed
* After setting up, click Save

<Frame caption="Enter the confirmation question and both reply choices, then save the node.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-confirm-question-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=43ca5d026129ba7463fd57425ca0f98c" alt="Confirmation question with OPT-OUT and Keep me subscribed buttons." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-confirm-question-annotated.svg" />
</Frame>

4. Connect the Keyword trigger to the Ask a question component after setting up

## Step 4: Add to Unsubscribe List

1. Add the Unsubscribe component

2. You can choose whether to automatically reply with a successful unsubscribe message. If needed, click the **Auto-reply** switch and enter the auto-reply content below, then select Save to save.

<Frame caption="Enable Auto-reply if you want to confirm the successful unsubscribe action.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-unsubscribe-reply-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=7d9b9cbbdda43b092f8aff49d4c2073d" alt="Unsubscribe node with Auto-reply enabled and a confirmation message." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-unsubscribe-reply-annotated.svg" />
</Frame>

3. Connect the "OPT-OUT" button from the Ask a question component to the Unsubscribe component

<Frame caption="Connect the trigger to the question, then connect OPT-OUT to Unsubscribe.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-question-connection-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=9424e3af7b00fe05e79356128cc65fcd" alt="Connections from the keyword trigger to the confirmation question and from OPT-OUT to Unsubscribe" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-question-connection-annotated.svg" />
</Frame>

## Step 5: Add a Send messages text (optional)

Add a Send messages text component and connect it to the **Keep me subscribed** button

<Frame caption="Send a short confirmation on the Keep me subscribed branch.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-cancel-reply-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=9c7c5277200273ffebb6ec59fd1b4822" alt="Send messages text editor containing a continued-subscription confirmation." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-cancel-reply-annotated.svg" />
</Frame>

## Step 6: Save and activate the Rule-based Agent

After editing the flow, select **Save**, choose **Active**, then save again. When a customer completes the unsubscribe flow, YCloud adds the phone number to **Contact > Unsubscribe list**.

<Frame caption="Choose the desired status before the final Save. This screenshot shows the activation option.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-save-status-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=31f947db4de3e54cf8b566295b525690" alt="Save the flow dialog with Active selected and Save button." width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-save-status-annotated.svg" />
</Frame>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.