---
title: "Unsubscribe Filtered Inbound SMS"
slug: "unsubscribe-filtered-inbound-sms"
updated: 2025-07-25T15:20:07Z
published: 2025-07-25T15:20:07Z
---

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

# Unsubscribe Filtered Inbound SMS

## Goal

Unsubscribe contacts from a Mapp Engage group when they send an inbound SMS containing specific keywords.

## Background Information

This process enables automatic unsubscription from a group in Mapp Engage when a contact replies to an SMS with certain words such as “quit”, “unsubscribe”, or “cancel”. Key points to note:

- Only SMS messages containing predefined keywords will trigger unsubscription.
- A confirmation SMS can optionally be sent to the contact.
- This method supports additional event-based automations triggered by inbound SMS messages.
- Each SMS group supports only one reply handling method. Using this method disables direct SMS subscriptions for the group. Contacts must be imported via file.

---

## Procedure

### 1. Define the Group Settings

1. Go to *Audience > Group*.
2. In the **Actions** column, click the gear icon.
3. Select the *Reply Handling* tab.
4. Expand the **SMS** section.
5. In the **Replies** drop-down, choose *Initiate Event-based Automation*.
6. Click **Save**.

---

### 2. Create the Automation

1. Create an event-based automation.
2. Automation Settings:
  - [Message Reply Received (C)​](/v1/docs/message-reply-received-c)
    - ​**Group**​: Select the SMS group.
    - **Body**​: From the drop-down list, select the ​*Contains*​ option, then provide the keyword. Alternatively, select the ​**Regex (Matches)** ​option.
    - Acivate the ​**Case Insensitive**​ check box.
  - [Unsubscribe Member From One Group (C)​](/v1/docs/unsubscribe-member-from-one-group-c)
    1. **Contact**​: Select the **​Use Event Parameter**​ check box.

​**Group**​: Select the ​**Use Event Parameter**​ check box.

​**Send Confirmation**​: Select whether to send a confirmation SMS. This is the system message​ `SysMsgUnsubscribeFrom`

---

## Using Regex to Define Keywords

- Select **Matches [Regex]** from the drop-down menu.
- Example Regex:

```arduino
arduinoCopyEdit.*\b(quit|end|cancel|unsubscribe|stop|remove)\b.*
```
  - `\b` matches word boundaries.
  - `.*` allows any text before or after.
  - `|` indicates an “OR” condition.

## Related

- [Unsubscribe All Inbound SMS Numbers](/unsubscribe-all-inbound-sms-numbers.md)
- [How-to](/how-to-system-messages.md)