About the SMS/MMS and Voice sandbox - Amazon Pinpoint SMS

About the SMS/MMS and Voice sandbox

New Amazon Pinpoint SMS accounts are placed into an SMS/MMS 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/MMS 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. To send an MMS message must use the SendMediaMessage 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 have a monthly MMS spending limit of $1.00 (USD).

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

  • The rules and restrictions for sending SMS and MMS messages to each destination country apply. For example, 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 and MMS messages only to verified destination numbers. For more information about how to add a verified destination phone number, see Add a verified destination.

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

Note

If your account is observed to be sending suspicious SMS/MMS traffic, your account's ability to send messages may be paused. If this occurs, please follow the steps in Moving from the SMS/MMS sandbox to production to gain production access.

Moving from the SMS/MMS sandbox to production

After fully testing your SMS/MMS environment in the SMS/MMS sandbox, you can request to move to production. Moving from the SMS sandbox to production also applies to MMS capability.

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 Support Center Console at https://console.aws.amazon.com/support/home.

  2. In the left hand navigation choose Your support cases.

  3. Choose Create case.

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

  5. In the Looking for service quota increases? window choose Create a case instead.

  6. On the Service Quota increase page, 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/MMS 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 AWS Region that you will 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.

  7. Under Requests, complete the following sections:

    • For the Region, choose the AWS Regions from which you will 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.

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

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

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

  11. 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.

  • For more information on how to add a verified destination phone number, see Add a verified destination.

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/MMS 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.

While in the sandbox, you are required to verify the destination numbers you're sending messages to. For more information on how to add a verified destination phone number, see Add a verified destination.

To request production access
  1. Open the Support Center Console at https://console.aws.amazon.com/support/home.

  2. In the left hand navigation choose Your support cases.

  3. Choose Create case.

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

  5. In the Looking for service quota increases? window choose Create a case instead.

  6. For Service, choose Pinpoint Voice.

  7. (Optional) Answer 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?

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

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

  10. For New quota value, enter 1.

  11. 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.

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

  13. 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.