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 phone number that contains up to 12 digits, depending on the country that it's based in. Long codes are typically meant for low-volume, person-to-person communication. However, you can also use long codes for sending test messages, or for sending low volumes of messages to your customers.

Note

In the United States and Canada, sending rates for long codes are restricted to 1 message per second. This limit might be higher or lower in other countries and regions. If you send a large volume of messages from a long code, wireless carriers might begin to block your messages. If you send SMS messages programmatically, your applications should limit the number of messages that they send per second.

After we receive your request, we send you information about the costs associated with obtaining a long code in your country or region. We also provide an estimate of the amount of time that's required to provision a long code in your country or region.

Note

If you're new to SMS messaging with Amazon Pinpoint, you should also 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. For more information, see Requesting Increases to Your Monthly SMS Spend Threshold for Amazon Pinpoint.

Step 1: Open a Service Limit Increase Case

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

To request a dedicated long code

  1. Sign in to the AWS Management Console at https://console.aws.amazon.com/.

  2. On the Support menu, choose Support Center, as shown in the following image.

  3. On the My support cases tab, choose Create case.

  4. Under Create case, choose Service limit increase.

  5. Under Case classification, complete the following sections:

    • For Limit type, choose Pinpoint SMS.

    • For Link to site or app which will be sending SMS, provide information about the website, application, or service that will send SMS messages.

    • For Type of messages, choose the type of messages that you plan to send using your long codes.

    • For Targeted countries, enter the country or region that you want to purchase long codes in.

  6. Under Requests, complete the following sections:

    • For Resource Type, choose Dedicated SMS Long Codes.

    • For Limit, choose the type of messages that you plan to send using this long code.

    • For New limit value, enter the number of long codes that you want to purchase.

  7. Under Case description, for Use case description, provide the following information:

    • The AWS Region that you use Amazon Pinpoint in.

    • A description of your use case. Include information about the content that you plan to send, how you obtained your customers' contact information, why you requested the number of long codes that you specified earlier, and whether you plan to use the long codes that you obtain to send two-way SMS messages.

    • The response that Amazon Pinpoint should automatically send customers when they respond to your messages with the keyword HELP.

    • The response that Amazon Pinpoint should automatically send customers when they respond to your messages with the keyword STOP.

    • The keyword that customers can send to your long code to opt in to receiving your messages, and the response that Amazon Pinpoint should automatically send customers when they send this keyword to your long code.

  8. Under Contact options, for Preferred contact language, choose whether you want to receive communications for this case in English or Japanese.

  9. When you finish, choose Submit.

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

After AWS notifies you that your long codes have been registered, 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 All projects page, choose a project that the SMS channel is enabled in.

  3. In the navigation pane, under Settings, choose SMS and voice.

  4. Under Number settings, choose the long code.

  5. Under Default keywords, verify that the responses for the HELP and STOP keywords match the values that you specified in your request.

  6. Under Registered keyword, verify that the opt-in keyword and response match the values that you specified in your request.

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

  8. When you finish, 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 Send Test Messages with Amazon Pinpoint.