Requesting dedicated long codes for SMS messaging with Amazon Pinpoint - Amazon Pinpoint

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. You cannot request a long code for A2P messaging within the United States. Instead you'll need to request a 10DLC. For more information on 10DLC and how to request one, see "10DLC" in SMS and voice settings.

Note

In the United States and Canada, sending rates for long codes are restricted to 1 message per second. This restriction is set by the phone carriers, and isn't a limitation of Amazon Pinpoint. This restriction 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 each second. See Best practices for more information on ways to help you improve your customer engagement.

Depending on your location, the steps to request a long code are different. If you're located in the United States or Canada you can request a long code using the Amazon Pinpoint Console. For all other countries and territories you'll need to first file a Support request, described below.

Note

If you're new to SMS messaging with Amazon Pinpoint, you should also request a monthly SMS spending threshold that meets the expected demands of your SMS use case. By default, your monthly spending threshold is $1.00 (USD). For more information, see Requesting increases to your monthly SMS spending quota for Amazon Pinpoint.

Requesting a long code in the US and Canada

If you're in the United States or Canada, you can purchase long codes directly through the Amazon Pinpoint console. For the steps to request a long code using the Amazon Pinpoint console, see Requesting a number.

Requesting a long code outside of the US and Canada

If you're located outside of the United States or Canada, you need to create a ticket in the AWS Support Center requesting any long codes.

To request a dedicated long code by opening a case in the AWS Support Center

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

  2. On the Support menu, choose Support Center.

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

  4. Under Create case, choose Service limit increase.

  5. Under Case details, complete the following sections:

    • For Limit type, choose Pinpoint SMS.

    • (Optional) For Provide a link to the site or app which will be sending SMS messages, provide information about the website, application, or service that will send SMS messages.

    • (Optional) For What type of messages do you plan to send, choose the type of message that you plan to send using your long code:

      • One Time Password – Messages that provide passwords that your customers use to authenticate with your website or application.

      • Promotional – 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 account alerts. Transactional messages must not contain promotional or marketing content.

    • (Optional) For Which AWS Region will you be sending messages from, choose the region that you'll be sending messages from.

    • (Optional) For Which countries do you plan to send messages to, enter the country or region that you want to purchase short codes in.

    • (Optional) In the How do your customers opt to receive messages from you, provide details about your opt-in process.

    • (Optional) In the Please provide the message template that you plan to use to send messages to your customers field, include the template that you will be using.

  6. Under Requests, complete the following sections:

    • For the Region, choose the Region from which you'll be sending messages.

      Note

      The Region is required in the Requests section. Even if you provided this information in the Case details section you must also include it here.

    • For Resource Type, choose Dedicated SMS Long Codes.

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

  7. Under Case description, for Use case description, provide details about your use case.

  8. (Optional) If you want to submit any further requests, choose Add another request. For the required information, see the other sections within Requesting support for SMS messaging with Amazon Pinpoint.

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

  10. When you finish, choose Submit.

After we receive your request, we provide an initial response within 24 hours. We might contact you to request additional information. Once approved, you can add keywords and response messages to your long code. See Managing SMS and voice settings in Amazon Pinpoint.

If we're able to provide you with a long code, we send you information about the costs associated with obtaining it. We also provide an estimate of the amount of time that's required to provision the long code. In many countries, we can provide you with a dedicated long code within 24 hours. However, in some countries and regions, it can take several weeks to obtain a dedicated long code for the SMS channel.

In order to prevent our systems from being used to send unsolicited or malicious content, we have to consider each request carefully. We might not be able to grant your request if your use case doesn't align with our policies.

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 Sending a test SMS message.