Send Message and Update Contact Profile within one Call

  • 1 minute(s) read
Prev Next

Overview

Mapp Connect is a flexible asynchronous API that allows you to send a message to a contact and update Engage contact profile attributes or other Engage data types (such as Wishlist, Abandoned Cart, etc.) within one API call using nested mappings.

Use Case

On your website, you have a form that allows contacts to select their interests and enter their name and email address. When they do, they will receive a thank-you message with a link to a coupon in their online account. At the same time, their profile in Mapp Engage will be updated with their name and hobby. These data can then be used for personalization and segmentation.

Call example

POST /integration/<INTEGRATION ID>/event?subtype=email

The link to the coupon will not be stored in the contact profile in Mapp Engage. There is no need to store it because:

  • it does not include any data about the Contact Profile that can be used later for personalization,

  • it will only be used once in the message as a one-time link.

For more information, see Mapp Engage Variables.

Prerequisites

  • Use your own plugin or one of the pre-defined integrations.

  • Create the attributes that you want to update in Mapp Engage.

  • Create prepared messages for the channel you want to use (Email, SMS, Push) with the placeholder <%parameter.accountURL%>.

  • To send a specific prepared message, set the prepared message ID in the request body using the messageId field.

Procedure

In this use case, we want to send an email message. If you want to use another channel (SMS or Push), you will need to create the relevant events in your app and map them in Mapp Engage.

  1. Create an email event in your third-party app

{
  "email":"user@mapp.com",
  "messageId": "1234567890",
  "firstname": "Paul",
  "interest":"climbing",
  "accountURL":"sample.com/7F000xf"
}

  1. In Mapp Connect, open the Mapping tab.

  2. Click Edit next to the email subtype mapping, then click Edit Field Mapping.

  3. Click the plus sign to add new user attributes. In this example, we are adding:

    • Source: interest, Target: Hobbies

    • Source: accountURL, Target: accountURL

  4. Activate the flow in your third-party app.