About the SMS and Voice sandbox - Amazon Pinpoint SMS

About the SMS and Voice sandbox

New Amazon Pinpoint SMS accounts are placed into an SMS or voice sandbox. The sandbox protects both AWS customers and recipients from fraud and abuse. It creates a safe environment for test and development.

SMS sandbox

While your account is in the sandbox, you can use all of the SMS sending methods in the Amazon Pinpoint SMS console or the SendTextMessages API. However, the following restrictions are in place while your account is in the sandbox:

  • You have a monthly SMS spending limit of $1.00 (USD).

  • You can send SMS messages only to verified destination phone numbers. You can add up to 10 verified numbers.

  • The rules and restrictions for sending SMS messages to each destination country apply. For example, if you want to send a message to a recipient in the United States, you must first request and register a US number.

  • To verify that you own a phone number, we send a verification code to that number. While the standard fees for each SMS message typically apply, we waive the fee for the first verification code for each phone number. For more information about SMS pricing, see the Amazon Pinpoint SMS Pricing page.

    Note

    Message and data rates apply for messages that you receive. We send one message per verification request.

  • You can delete a destination phone number. However, you must wait 24 hours after adding a phone number before you can delete it.

  • You can send SMS messages only to verified destination numbers.

You can remove these restrictions by requesting production access. For more information, see Moving from the SMS sandbox to production.

Moving from the SMS sandbox to production

After fully testing your SMS environment in the SMS sandbox, you can request to move to production. To do so, create an AWS Support case for a Service limit increase request.

Alternatively, you can request production access from the sandbox environment. To do so, choose Request production access under Account tier on the SMS and voice page.

Note

If your account is in multiple AWS Regions, you must submit a support request for each region.

To move to production from the SMS sandbox
  1. Open the Amazon Pinpoint SMS console at https://console.aws.amazon.com/sms-voice/.

  2. On the Support menu, choose Support Center.

  3. On the Your support cases pane, choose Create case.

  4. Choose the Looking for service limit increases? link, then complete the following:

    • For Service, 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 by 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.

  5. Under Requests, complete the following sections:

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

      Note

      The AWS Regions 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 General Limits.

    • For the Quota, choose SMS Production Access.

    • For New quota value, enter 1.

  6. Under Case description, for Use case description, enter any relevant details about this request.

  7. (Optional) If you want to submit any further requests, choose Add another request.

  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.

After we receive your request, we provide an initial response within 24 hours. We might contact you to request additional information.

Voice sandbox

To help protect our customers from fraud and abuse, we place your account in a sandbox environment when you first create it. The sandbox environment also helps you test the channel to help establish your reputation. While your account is in the sandbox, you have full access to Amazon Pinpoint SMS voice messaging, with the following restrictions:

  • You have a daily limit of 20 messages.

  • You can send a maximum of five voice messages to a single recipient during a 24-hour period.

  • You can send a maximum of five calls per minute.

  • The maximum voice message length is 30 seconds.

  • You can send voice messages only to specific countries. For more information, see Voice quotas.

When you're ready to move your account out of the voice sandbox, create an AWS Support case for a Service limit increase request. For more information, see About the SMS and Voice sandbox.

Note

Before you request production access, you must send at least one voice message from your Amazon Pinpoint SMS account. You can send a voice message by using the SendVoiceMessage API.

Moving from the voice sandbox to production

When you first start using the voice channel, your account is in the sandbox.

To remove these quotas from your account, you can request to have your account removed from the sandbox. When your account is removed from the sandbox, it has production access.

Note

Before you request production access, you must send at least one voice message from your Amazon Pinpoint SMS account.

If you are using SendVoiceMessage from the Amazon Pinpoint SMS and Voice API, version 2 API while in the sandbox, you are required to verify the destination numbers you're sending messages to. You can verify phone numbers through a one-time password sent via text message.

To request production access
  1. Open the Amazon Pinpoint SMS console at https://console.aws.amazon.com/sms-voice/.

  2. On the Support menu, choose Support Center.

  3. Under Open support cases, choose Create case.

  4. Choose the Looking for service limit increases? link.

  5. For Service, choose Pinpoint Voice.

  6. (Optional) Complete the following information:

    • What's the maximum number of voice messages that you plan to send per day?

    • What will be the average length of each call that you send?

    • How do you obtain the phone numbers that you plan to send voice messages to?

    • How many dedicated phone numbers will you use to send your messages? Why did you choose this number?

    • How many calls do you expect to make from each phone number? (1 to X) messages per (day/week/month/other)

    • How do you obtain consent to send voice messages to your customers?

    • How can customers opt out of receiving messages from you? How will you process these requests?

  7. Under Requests, for Region, choose the AWS Region that you use to send voice messages.

  8. For Quota, verify that Production Access is selected.

  9. For New quota value, enter 1.

  10. Under Case description, for Use case description, provide the following details:

    • The website or app of the company or service that will send voice messages.

    • The service that's provided by your website or app, and how your voice messages contribute to that service.

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

  12. When you finish, choose Submit.

The AWS Support team provides an initial response to your request within 24 hours.

To prevent our systems from being used to send unsolicited or malicious content, AWS Support must consider each request carefully. If we’re able to do so, we'll grant your request within this 24-hour period. However, if we need to obtain additional information from you, it might take longer to resolve your request.

We might not be able to grant your request if your use case doesn’t align with AWS Support policies.