How do I troubleshoot sender ID issues when I send SMS messages in Amazon SNS?

Resolution

To resolve sender ID related issues when you send SMS messages in Amazon SNS, use one of the following resolutions for the specific issue that you experienced.

Note: To see a list of countries that support sender IDs, see Supported countries and regions for SMS messaging with AWS End User Messaging SMS.

The sender ID is different from the one you configured

You must request a sender ID in the country that you send messages to.

The sender ID delivered as NOTICE to SMS message recipients

If you don't specify a sender ID when you send SMS messages to countries that require one, then NOTICE appears as the originating identity. To specify a sender ID in your publish request, use the Amazon SNS console or AWS SDKs.

The sender ID delivered as NOTICE or UNVERIFIED to SMS message recipients without a resource-based policy

Sender IDs created after August 2024 must have a resource-based policy that allows SNS to use the Sender ID to send messages.

The following example resource-based policy allows Amazon SNS to send SMS messages with the specified sender ID:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": [
        "sms-voice:SendTextMessage"
      ],
      "Resource": "arn:Partition:sms-voice:Region:Account:sender-id/Senderid/Countrycode",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "Account"
        }
      }
    }
  ]
}

SMS messages fail or don't reach recipients when you use a sender ID

If your SMS messages fail or a carrier blocks them when you use a sender ID, then take the following actions:

• Make sure that your messages comply with laws, regulations, and carrier requirements of the country that you send messages to.
• Confirm whether the country that you send messages to requires a preregistered message template.
  Note: If you send SMS messages to India, then you must preregister your sender ID and message templates with the Telecom Regulatory Authority of India (TRAI).
• Make sure that your sender ID identifies only a brand or trademark that you own.

If your messages still fail to send, then see How do I troubleshoot mobile text message (SMS) failures in Amazon SNS?

Note: Mobile phone carriers regularly audit bulk SMS message senders and can block messages if the messages don't comply with local laws and regulations. AWS also prohibits SMS spoofing, where a sender uses the sender ID to impersonate another person, company, or product. For more information, see Best practices for Amazon SNS SMS messaging.

The sender ID doesn't work in specific countries

If your sender ID doesn't work in specific countries, then take the following actions:

• Confirm that the country that you send messages to supports sender IDs. If the country doesn't support sender IDs, then Amazon SNS uses one of the other supported origination numbers to deliver your messages.
• Check that the country that you send messages to requires a preregistered sender ID or message templates. To register your sender ID or message templates, see Request a sender ID in AWS End User Messaging SMS.
  Note: Not all countries and AWS Regions support sender IDs. In countries and Regions that don't support sender IDs, Amazon SNS uses person-to-person (P2P) long codes or other supported origination numbers to deliver SMS messages.