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)​

     • ​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)​

     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:

  arduinoCopyEdit.*\b(quit|end|cancel|unsubscribe|stop|remove)\b.*

  • \b matches word boundaries.

  • .* allows any text before or after.

  • | indicates an “OR” condition.