Goal​

To unsubscribe contacts from a Mapp Engage group when they send an incoming SMS to the group. Replies are filtered for certain words you define (such as quit, unsubscribe and cancel).

Background Information​

With this setup:

  • A contact sends an SMS to a Mapp Engage group. The SMS contains a word such as quit, unsubscribe or cancel. Mapp Engage starts an event-based automation that immediately unsubscribes the contact from the group.

  • Only inbound SMS messages that contain certain words result in an unsubscribe.

  • You can decide whether to send a confirmation to the contact. The confirmation is also sent via SMS

This method allows you to create other event-based automations that react to an inbound SMS in the same Mapp Engage group.

Each SMS group only has one reply handling setting. If you use the method described here, you cannot allow contacts to subscribe directly to this Mapp Engage group. You must import SMS contacts into Mapp Engage with a file.

Procedure​

Define the Group Settings

  1. In the ​main navigation​, click Audience >  Group.

  2. In the ​Actions​ column, click the symbol.

  3. Click the ​Reply Handling​ tab.

  4. Expand the ​SMS​ area.

  5. From the ​Replies ​drop-down list, select the ​Initiate Event-based Automation​ option.

  6. Click ​Save​.

Create the Automation

  1. Create a new event-based automation. You can create the automation on a whiteboard or manually. Enter a name and description for the automation.

  2. Create the settings for the event and job as follows:

     Automation Settings

    Event

    Job

    ​Unsubscribe Member From One Group (C)​

    ​Group​: Select the SMS group.

    ​Body​: From the drop-down list, select the ​Contains​ option. In the input field, enter the word that should result in an unsubscribe.

    Or, select the ​Regex (Matches) ​option. In the input field, enter a Regex. See below.

    Select the ​Case Insensitive​ check box.

    ​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​ SysMsgUnsubscribeFromGroup​. You must make sure this message is not suppressed for SMS. See ​System Messages via SMS​.

    You can use Regex to enter a combination of words.

    From the drop-down, select ​Matches [Regex]​.

    In the third field, enter the Regex.

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

    \b finds a match at the beginning or end of a word

    ​.*​ indicates that additional text or no text can appear before or after.

    ​|​ represents an "or" and indicates that only one of the patterns must appear in the email

    If a contact sends an inbound SMS with the word STOP, SAP blacklists the mobile number. It is not possible to remove a contact from the SAP blacklist from within the Mapp Engage system.

  3. Click the ​Time Frame​ button.
  4. Define the time frame by selecting a ​Start Date​ and an ​End Date​. Within this time frame, every time the event takes place, the job is executed.
  5. Click ​Save & Activate​ to immediately activate the automation. The automation is saved and activated. The automation has the status ​Activated, Running​ if the start date is immediate and ​Activated, Scheduled​ if the start date is in the future.

Related Topics​

​SMS Messaging
​Unsubscribe All Inbound SMS Numbers​