Amazon Pinpoint
User Guide

Requesting Dedicated Long Codes for SMS Messaging with Amazon Pinpoint

A long code (also referred to as a long virtual number, or LVN) is a standard 10-digit phone number. Long codes are meant for low-volume, person-to-person communication. For example, in the United States and Canada, sending rates for long codes are restricted to 1 TPS. Sending high-volume traffic to a long code might prompt wireless carriers to block the messages by blacklisting the long code. Long codes are useful for testing your SMS program before you invest in a short code. With Amazon Pinpoint, long codes are supported only for two-way SMS.

You can request up to 5 long codes for each country that you'll send SMS messages to.

Important

If you're new to SMS messaging with Amazon Pinpoint, request a monthly SMS spend threshold that meets the expected demands of your SMS use case. By default, your monthly spend threshold is 1.00 USD. You can request to increase your spend threshold in the same support case that includes your request for a long code. Or, you can submit a separate case. For more information, see Requesting Increases to Your Monthly SMS Spend Threshold for Amazon Pinpoint.

After receiving your request, AWS registers your long code in the targeted countries on your behalf. Typically, AWS Support processes your case within 2 business days. Depending on the complexity of your case, AWS Support might require an additional 3–5 days to ensure that your request can be processed.

To request a dedicated long code, complete the following steps.

Step 1: Open an Amazon Pinpoint SMS Case

Open a case with AWS Support by completing the following steps.

  1. Sign in to the AWS Management Console, and go to the AWS Support Center.

  2. Choose Create case.

  3. For Regarding, choose Service Limit Increase.

  4. For Limit Type, choose Pinpoint SMS.

Step 2: Specify Your Request

Tell AWS Support that you're requesting a dedicated long code by completing the following steps.

  1. For Resource Type, choose Dedicated SMS Long Codes.

  2. For Limit, choose the type of message that you'll send with your long code:

    • One-time Passwords/Two-Factor Authentication – Messages that provide passwords to authenticate with your website or application.

    • Promotional/Marketing – Noncritical messages that promote your business or service, such as special offers or announcements.

    • Transactional – Important informational messages that support customer transactions, such as order confirmations or transaction alerts. Transactional messages must not contain promotional content.

  3. For New limit value, specify the number of long codes that you're requesting. Typically, this value is 1. You can request up to 5 long codes for each country in your request.

  4. (Optional) If you want to include multiple requests in this support case, choose Add another request. Then, specify the type of request.

    If you include multiple requests, provide the required information for each. For the required information, see the other sections in Requesting Support for SMS Messaging with Amazon Pinpoint.

Step 3: Describe Your SMS Use Case

Describe how you'll use your dedicated long code by completing the following steps.

  1. For Link to site or app which will be sending SMS, identify the website or application where your audience members will opt in to receive your SMS messages.

  2. For Type of messages, choose the type of message that you'll send using your long code: Transactional, Promotional, or One Time Passwords.

  3. For Targeted Countries, specify the countries that you're requesting a long code for. For more information, see Supported Countries and Regions.

    If your list of countries exceeds the character limit for this text box, you can instead specify your countries in the Use Case Description box.

  4. For Use Case Description, provide the following details:

    • The AWS Region where you'll use Amazon Pinpoint to send SMS messages with your long code.

    • Because long codes are supported only for two-way SMS, confirm that you require your long code for two-way SMS purposes.

  5. When you finish, choose Submit.

Step 4: Update Your SMS Settings in the Amazon Pinpoint Console

After AWS notifies you that your long code is registered in the targeted countries, complete the following steps.

  1. Sign in to the AWS Management Console and open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.

  2. On the Projects page, choose Account settings.

  3. Under Number settings, choose the long code that AWS assigned to your account. The console shows the Number settings page for your long code. Under Keywords, the console provides:

    • The keywords HELP and STOP, and their default response messages. You can edit the response messages, but you can't edit the keywords.

    • The default registered keyword and its default response message. You can edit both of these values.

  4. In the table that contains the keyword or response that you want to edit, choose Edit, and make your changes.

  5. (Optional) If you want to specify additional keyword responses, or if you want to process inbound messages outside of Amazon Pinpoint, configure two-way SMS settings. For more information, see Two-Way SMS Settings.

  6. When you finish making your changes, choose Save.

Next Steps

You've registered a long code and updated your settings in the Amazon Pinpoint console. Now you can use Amazon Pinpoint to send SMS messages with your long code as the origination number.

To engage an audience segment with an SMS campaign, see Amazon Pinpoint Campaigns.

To send an SMS message directly to a limited audience without creating a campaign, see Direct Messages with Amazon Pinpoint.