Target Contacts Based on Their SMS Responses: Setup with Shared Short Code and Keyword
    • 2 Minutes to read
    • Dark
      Light

    Target Contacts Based on Their SMS Responses: Setup with Shared Short Code and Keyword

    • Dark
      Light

    Article summary

    Objective

    Target contacts based on their response to your SMS Message sent in Mapp Engage.

    In this use case, the group's reply configuration uses a shared short code with a keyword. If you are using a dedicated code, see Target Contacts Based on Their SMS Responses: Setup with Dedicated Code.

    For more information, see SMS Code Types.

    Prerequisites

    Your system is set up to receive incoming SMS messages, including a callback URL. For more information, see SMS Providers & Setup Steps.

    Whiteboard

    You send an SMS to contacts offering a 25% discount if they reply "Promotion YES25" to your text. For example:

    "Text Promotion YES25 to receive a 25% discount voucher. Text Promotion QUIT if you want to stop receiving these messages."

    Words that should trigger the Whiteboard can appear anywhere in the body text after the keyword! In this example, "Promotion" is the set keyword that allows Engage to identify the correct group. "YES25" and "Quit" are words that will trigger the automation.

    The inbound SMS message must include the keyword and triggering words for the automation to be triggered.

    The Whiteboard is divided into two paths:

    • Responses with the text "Promotion YES25". Here we add the filter Attribute Value to check whether the contact has opted in to receive email. If so, Mapp Engage emails them the 25% discount voucher. If not, the voucher is sent in an SMS.

      It is more advantageous for marketers to send the voucher via Email, as the conversion tracking possibilities for this channel are more advanced than for SMS.

    • Responses with the text "Promotion QUIT" are treated as unsubscribe requests. The automation removes their contacts from the group, so they don't receive any more messages.

    Contacts who don't respond will be ignored - they won't receive a voucher and won't be removed from the group.

    Show detailed configuration

    1. Create an event-based whiteboard, start with a Multiple Event, and click Add Path to create two branches.
       

    2. Rename the labels on the paths so that the Whiteboard looks like this:
       

    3. Click Add Event in the first path. Configure the event as follows:

      • Criteria: Message Body

      • Operator: Contains

      • Value: YES25

      • Activate the Case sensitive checkbox.
        Save the criterion.
         

    4. Click Add Event in the second path. Configure the event as follows:

      • Criteria: Message Body

      • Operator: Contains

      • Value: QUIT

      • Activate the Case sensitive checkbox.
        Save the criterion.
         

    5. Add the next step to the "YES25" branch - the filter Attribute Value. Add two paths in the configuration of this filter to check whether these contacts have opted in to receive Email messages from Mapp Engage.

      • "Email Contactable": contacts who have opted in for Email go down this path.
         

      • "Not Email Contactable": contacts who haven't opted in for Email go down this path.
         

    6. Add the Send Email job to the "Email Contactable" path. Select the Email message that contains the 25% voucher.
       

    7. Add the Send SMS job to the "Not Email Contactable" path. Select the SMS message that contains the 25% voucher.
       

    8. Now add the next step to the QUIT branch. Add the job Add To / Remove From Group and configure it as follows:

      • Membership Change: Remove or Unsubscribe from Group

      • Remove from Group: Specific Group

      • Group: Master_SMS (this is what the group is called in this example)

      • Method: Remove Without Notification.
        These contacts will not get any more SMS messages sent to this group. These contacts will remain there if they are also part of the Email group.
         

    Related Topics

    Reacts to SMS Message


    Was this article helpful?