AWS Mobile
Developer Guide

Add Messaging to Your Mobile App with Amazon Pinpoint

Important

The following content applies if you are already using the AWS Mobile Hub to configure your backend. If you are building a new mobile or web app, or you're adding cloud capabilities to your existing app, use the new AWS Amplify CLI instead. With the new Amplify CLI, you can use all of the features described in Announcing the AWS Amplify CLI toolchain, including AWS CloudFormation functionality that provides additional workflows.

Overview

Engage your users more deeply by tying their app usage behavior to messaging campaigns.

When you enable the AWS Mobile Hub Messaging and Analytics feature, your app is registered with the Amazon Pinpoint service. You can define User Segments and send E-mail, SMS, and Push Notification messages to those recipients through the Amazon Pinpoint console.

Amazon Pinpoint also enables you to gather and visualize your app's Analytics. The metrics you gather can be as simple as session start and stop data, or you can customize them to show things like how closely actual behavior matches your predicted model.

You can then algorithmically tie messaging campaigns to user behavior. For instance, send a discount mail to frequent users, or send a push notification that initiates a data sync for users that have selected a certain category in a feature of your app.

Set Up Your Backend

To set up email or SMS as part of a Amazon Pinpoint campaign take the following steps.

To setup your app to receive Push Notifications from Amazon Pinpoint, see Add Push Notifications to Your Mobile App with Amazon Pinpoint

  1. Complete the Get Started steps before your proceed.

  2. For Email: Choose the Messaging and Analytics tile to enable the

    feature.

    1. Choose Email, and then choose Enable.

    2. Choose the Amazon Pinpoint console link at the bottom of the descriptive text on the left.

    3. Choose Email in the Amazon Pinpoint console Channels tab.

    4. Choose Email address, type the address your messages should come from, and then choose verify at the end of the entry field.

      The email account you enter will receive an email requesting your approval for Amazon Pinpoint to use that account as the sender address for emails sent by the system. The status of Pending Verification is displayed in the console entry field until Amazon Pinpoint has processed your approval.

    5. Choose Email domain, type the domain your messages should come from, and then choose verify at the end of the entry field.

      A dialog is displayed providing the name and value of the TXT record you must add to the domain's settings. The status of Pending Verification is displayed in the entry field until the console processes your approval.

      Add a default user name to Default from address.

    6. Choose Save.

    7. For information about sending mail from Amazon Pinpoint, see Sending an Email Message.

    1. For SMS: Choose the Messaging and Analytics tile to enable the feature.

      1. Choose SMS, and then choose Enable.

      2. Choose the Amazon Pinpoint console link at the bottom of the descriptive text on the left.

      3. Choose SMS in the Amazon Pinpoint console Channels tab.

      4. Adjust the options for Default message type, Account spend limit, and Default sender ID. For more information on these options, see Updating SMS Settings.

      5. For information about sending SMS messages from Amazon Pinpoint, see Sending an SMS Message.

Connect to your backend

The AWS Mobile SDK is not required to receive Email or SMS messages from Amazon Pinpoint.