Skip to main content
Mapp SMS

Use Mapp as your SMS messaging provider.

Updated over a week ago

Before you start

Things you need to know:

  • Make sure you have the following before starting:

    • Login details for Fresh Relevance.

    • Login details for Mapp Engage with the appropriate credentials. These are provided to you by your Mapp Engage project manager.

  • Before setting your API details, go to https://secure.ecircle-ag.com/{yourcompany}/home/login.jsp and log in with your username and password. You need this login information later.


Core table configuration

Fresh Relevance uploads account data to Mapp Engage. The following attributes must be present:

  • mobile

  • CustomAttribute.cart_html

Create custom attributes

If necessary, create the Custom Attributes as follows:

  1. In your Mapp account, expand the Administration drop-down menu and go to Attributes > Profile Attributes. The User Attributes Management window opens. Stay on the Custom Attributes tab.

  2. Select Create New Attribute. The Create New Attribute window opens.

  3. For Name, enter Cart_html.

  4. Expand the Data Type drop-down menu and select String.

  5. Select Save.

The customer attribute should look like this:

Name

Datatype

Description

Mapp Engage Mailmerge

cart_html

String

Cart Contents. Formatted cart layout, containing the whole message to be sent.

<%user.CustomAttribute.cart_html%>


Choose a group

Decide which group you want to use with Fresh Relevance and note its ID:

  1. In your Mapp account select Groups.

  2. If you need another group, select New Group, enter the properties, and select Create.

  3. Keep a record of the group ID.


Choose SMS to send

If you are sending SMS using Fresh Relevance, create a default message on the MAPP platform. This message is just an empty shell - all the content of the SMS comes from the cart layout on Fresh Relevance. The SMS message should just contain: <%parameter.body%>.

Only create this message if you're doing the initial setup for triggered messaging. If you're configuring Campaign-based Identification or Analytics then skip ahead to Set Your API Details.

  1. In Your Mapp account, expand the Messages drop-down menu and go to Prepared Messages > SMS.

  2. Select Create.

  3. On the Compose Message page, create your new message containing <%parameter.body%>.

  4. Select Prepare Sendout to create a new prepared message.

  5. Back on the Compose Message page, copy the ID for your new message and keep store it in a temporary note.


Set your API details

  1. In Fresh Relevance, expand the User menu and go to Settings > Triggers and Messaging integrations.

  2. Select Messaging Provider(s).

  3. Expand the Service Provider drop-down menu and select Mapp SMS.

  4. Select NEXT.

  5. Enter your Mapp Engage details. Paste the ID you copied from your Mapp Engage account to the Default Prepared Message ID for Triggered Messages field. Select the ? icon next to each field for more details.

  6. Select SAVE.

Permissions

Mapp handles unsubscribes typically through the Keyword or landing page URL approach in the message.

Speak with your Mapp account manager if you need help configuring this.

Mapp configures an event function so that as soon as someone unsubscribes from the message, they are added to the group blacklist for Fresh Relevance abandonment. Users who are unsubscribed can’t be added back in by Fresh Relevance. This image shows how the event handler should look:

Set up triggered messages

Learn how to set up triggered messages in Set up trigger programs.


Send a test message

To check that Fresh Relevance is working correctly after setup, you should send a test message.

  1. Expand the Content drop-down menu and select Cart Layout.

  2. Under the heading Edit and existing layout, find Default Cart and select View.

  3. Under the heading Send Test Message, expand the Trigger drop-down menu and select the trigger that you want to test.

    • If you haven't created a trigger yet, go to the Triggers section and create one. Learn how in Set up SMS triggers.

  4. For Mobile, enter your mobile number.

    • Your mobile number should be entered in E.164 format, for example, +447778889999 for UK or +12345234523 for USA.

  5. Select Send Test Message(s).

    • A pop-up message at the top of the screen indicates that a test message is queued.

You can also select View Send History to view the Person History page for your mobile number.

Did this answer your question?