---
title: "Target Contacts Based on Their SMS Responses: Setup with Dedicated Code"
slug: "target-contacts-based-on-their-sms-responses-setup-with-dedicated-code"
updated: 2024-03-06T08:06:17Z
published: 2024-03-06T08:06:17Z
---

> ## 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.

# Target Contacts Based on Their SMS Responses: Setup with Dedicated Code

## 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 **dedicated short code**. If you are using a shared short code with a keyword, see [Target Contacts Based on Their SMS Responses: Setup with Shared Short Code and Keyword](/v1/docs/target-contacts-based-on-their-sms-responses-setup-with-shared-short-code-and-keyword).

For more information, see [SMS Code Types](/v1/docs/sms-code-types).

## Whiteboard

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

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

The Whiteboard is divided into two paths:

- Responses with the text "**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 "**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.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/6215b03b-2f2e-448d-9adc-541540ed8cd1.png)

**Show detailed configuration**

1. Create an event-based whiteboard, start with a **Multiple Event,** and click **Add Path** to create two branches.![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/a9d2836a-0912-4dbc-9277-91663056ad65.png)
2. Rename the labels on the paths so that the Whiteboard looks like this: ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/2c2e5d36-bc61-40c1-81a6-00a678a4db1c.png)
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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/519cf66b-9778-4fe2-a383-5c7de8149cff.png)
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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/6bb95bbd-d56c-4d5c-a5b3-5a7b20e6e9cd.png)
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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/3a56ca35-4c93-4a12-936e-7f3ea8163b68.png)
  - "Not Email Contactable": contacts who haven't opted in for Email go down this path. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/d407616b-f286-4f76-bd4b-eda1f3646ca1.png)
6. Add the **Send Email** job to the "Email Contactable" path. Select the Email message that contains the 25% voucher. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/91f4e50c-ad5c-4c60-9708-1d494f751006.png)
7. Add the **Send SMS**job to the "Not Email Contactable" path. Select the SMS message that contains the 25% voucher. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/24488d6a-06e3-4749-8e5a-94a04db7be04.png)
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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/a88d1782-95e6-46ea-87fa-6bd54f94720e.png)

## Related Topics

[Reacts to SMS Message](/v1/docs/reacts-to-sms-message)