携帯電話に発行する - Amazon Simple Notification Service

携帯電話に発行する

Amazon SNS を使用して、Amazon SNS トピックに電話番号を登録せずに、SMS メッセージを携帯電話に直接送信できます。

注記

1 つのメッセージを同時に複数の電話番号に送信する場合、電話番号をトピックにサブスクライブすると便利です。SMS メッセージをトピックに発行する方法については、「トピックへ発行する」を参照してください。

メッセージを送信するとき、メッセージがコストまたは信頼性に対して最適化されているかどうかを制御できます。送信者 ID または発信番号を指定することもできます。Amazon SNS API または AWS SDK を使用してメッセージをプログラムによって送信すると、メッセージ配信の上限価格を指定できます。

各 SMS メッセージは最大 140 バイトまで含めることができ、文字限度はエンコーディングスキームによって異なります。例えば、SMS メッセージには以下を含めることができます。

  • 160 GSM 文字

  • 140 ASCII 文字

  • 70 UCS-2 文字

サイズ限度を超えてメッセージを発行する場合は、Amazon SNS により、複数のメッセージとして送信され、それぞれが文字数の限度以内に収められます。メッセージは単語の途中ではなく、単語の境目で切り離されます。1 回の SMS 発行アクションの合計サイズ限度は、1,600 バイトです。

SMS メッセージを送信するときは、E.164 形式を使用して電話番号を指定します。E.164 形式は国際電気通信に使用される標準電話番号付与構造です。この形式に従う電話番号は最大 15 桁を設定でき、プラス記号 (+) および国コードのプレフィックスが付いています。例えば、E.164 形式の米国の電話番号は +1XXX5550100 と表示されます。

メッセージの送信 (コンソール)

  1. Amazon SNS コンソールにサインインします。

  2. コンソールメニューで、AWS SMS メッセージングをサポートしているリージョン を選択します。

  3. ナビゲーションペインで、[テキストメッセージング (SMS)] を選択します。

  4. リポジトリの [モバイルテキストメッセージング (SMS)] ページで、[テキストメッセージの発行]。

  5. リポジトリの [SMS メッセージを発行する] ページ、[メッセージの種類] で、次のいずれかを選択します。

    • プロモーション - マーケティングメッセージなどの非クリティカルなメッセージ。

    • [トランザクション] - 多要素認証のワンタイムパスコードなど、顧客のトランザクションをサポートするクリティカルメッセージ。

    注記

    このメッセージレベルの設定をすると、アカウントレベルのデフォルトメッセージタイプは上書きされます。アカウントレベルのデフォルトのメッセージタイプは、[モバイルテキストメッセージング (SMS)] ページの [テキストメッセージングの優先設定] のセクションで設定できます。

    プロモーションおよびトランザクションメッセージの料金表の詳細については、「世界各地の SMS 料金表」を参照してください。

  6. [送信先電話番号] に、メッセージを送信する電話番号を入力します。

  7. [メッセージ] に、送信するメッセージを入力します。

  8. (オプション) [送信元アイデンティティ] で、受信者を識別する方法を指定します。

    • (オプション) [送信者 ID] に、少なくとも 1 つの文字を含み、スペースは含まない、3~11 文字の英数字のカスタム ID を入力します。送信者 ID は、受信側デバイスにメッセージ送信者として表示されます。例えば、メッセージソースを識別しやすいように、ビジネスブランドを使用できます。

      送信者 ID のサポートについては、国、リージョン、またはその両方によって異なります。例えば、米国の電話番号へ配信されるメッセージは、送信者 ID を表示しません。送信者 ID をサポートする国およびリージョンについては、「サポートされているリージョンおよび国」を参照してください。

      送信者 ID を指定しない場合、次のいずれか 1 つが送信元 ID として表示されます。

      • ロングコードをサポートしている国では、ロングコードが表示されます。

      • 送信者 ID のみがサポートされている国では、「NOTICE」が表示されます。

      このメッセージレベルの送信者 ID は、[テキストメッセージプリファレンス] ページで設定するデフォルトの送信者 ID を上書きします。

    • [送信元番号] を指定するには、受信者のデバイス上で送信者の電話番号として表示する 5~14 の数字の文字列を入力します。この文字列は、送信先の国のお客様の AWS アカウント に設定される送信元番号と一致シている必要があります。発信番号には、10DLC 番号、フリーダイヤル番号、個人間のロングコード、またはショートコードを指定できます。詳細については、「SMS メッセージの送信元アイデンティティ」を参照してください。

      発信番号を指定しない場合、 AWS アカウント 設定に基づき、Amazon SNS は SMS テキストメッセージに使用する送信元番号を選択します。

  9. インドの受取人に SMS メッセージを送信する場合は、[国固有の属性 を展開し、次の属性を指定します。

    • エンティティ ID - インドの受信者に SMS メッセージを送信するためのエンティティ ID または プリンシパルエンティティ (PE) ID。この ID は、1 ~ 50 文字の一意の文字列で、Telecom Regulatory Authority of India (TRAI) が提供する、TRAI に登録したエンティティを識別するものです。

    • テンプレート ID - インドの受信者に SMS メッセージを送信するためのテンプレート ID。この ID は、TRAI に登録したテンプレートを識別する 1 ~ 50 文字の一意の文字列です。テンプレート ID は、メッセージに対して指定した送信者 ID に関連付ける必要があります。

    インドの受信者に SMS メッセージを送信する方法の詳細については、「インドの受信者に SMS メッセージを送信するための特別な要件」を参照してください。

  10. [メッセージの発行] を選択します。

ヒント

送信元番号から SMS メッセージを送信するには、Amazon SNS コンソールのナビゲーションパネルで送信元番号を送信します。[機能] 列で [SMS] 含む送信元番号を選択し、次に [テキストメッセージの発行] を選択します。

メッセージの送信 (AWS SDK)

AWS SDK のいずれかを使用して SMS メッセージを送信するには、Amazon SNS API の Publish リクエストに対応する SDK の API オペレーションを使用します。このリクエストでは、電話番号に SMS メッセージを直接送信できます。次の属性名の値を設定する場合、MessageAttributes パラメータも使用できます。

AWS.SNS.SMS.SenderID

少なくとも 1 つの文字を含み、スペースは含まない、3 ~ 11 文字の英数字のカスタム ID。送信者 ID は、受信デバイスにメッセージ送信者として表示されます。例えば、メッセージ ソースを識別しやすいように、ビジネスブランドを使用できます。

送信者 ID のサポートについては、国またはリージョンによって異なります。例えば、米国の電話番号へ配信されるメッセージは、送信者 ID を表示しません。送信者 ID をサポートする国およびリージョンのリストについては、「サポートされているリージョンおよび国」を参照してください。

送信者 ID を指定しない場合、サポートされている国またはリージョンでは、メッセージは送信者 ID としてロングコードを表示します。アルファベットの送信者 ID を必要とする国またはリージョンでは、送信者 ID は「NOTICE」と表示されます。

このメッセージレベルの属性は、SetSMSAttributes リクエストを使用して設定する、アカウントレベルの属性 DefaultSenderID を上書きします。

AWS.MM.SMS.OriginationNumber

5~14 個の数値のカスタム文字列で、オプションの先頭にプラス記号 (+) を付けられます。この番号文字列は、受信側のデバイスの送信者の電話番号として表示されます。この文字列は、送信先の国のお客様の AWS アカウントに設定される送信元番号と一致シている必要があります。発信番号には、10DLC 番号、フリーダイヤル番号、Person-to-Person (P2P) のロングコード、またはショートコードを指定できます。詳細については、「送信元番号」を参照してください。

送信元番号を指定しない場合、AWS アカウント設定に基づき、Amazon SNS は 送信元番号を選択します。

AWS.SNS.SMS.MaxPrice

SMS メッセージの送信に使用できる上限価格 (USD)。Amazon SNS がメッセージの送信により上限価格を超えるコストが発生すると判断した場合、Amazon SNS はメッセージを送信しません。

過去 1 か月の SMS コストが既に MonthlySpendLimit 属性の限度を超えた場合、この属性は何も実行しません。SetSMSAttributes リクエストを使用して MonthlySpendLimit 属性を設定できます。

Amazon SNS トピックにメッセージを送信する場合、トピックにサブスクライブされている各電話番号への各メッセージの配信に上限価格が適用されます。

AWS.SNS.SMS.SMSType

送信するメッセージのタイプ。

  • Promotional (デフォルト) - マーケティングメッセージなどの非クリティカルなメッセージ。

  • Transactional - 多要素認証のワンタイムパスコードなど、顧客のトランザクションをサポートするクリティカルメッセージ。

このメッセージレベルの属性は、SetSMSAttributes リクエストを使用して設定する、アカウントレベルの属性 DefaultSMSType を上書きします。

AWS.MM.SMS.EntityId

この属性は、インドの受信者に SMS メッセージを送信するときにのみ必要です。

これは、インドの受信者に SMS メッセージを送信するためのエンティティ ID またはプリンシパルエンティティ (PE) ID です。この ID は、1 ~ 50 文字の一意の文字列で、Telecom Regulatory Authority of India (TRAI) が提供する、TRAI に登録したエンティティを識別するものです。

AWS.MM.SMS.TemplateId

この属性は、インドの受信者に SMS メッセージを送信するときにのみ必要です。

これは、インドの受信者に SMS メッセージを送信するためのテンプレートです。この ID は、TRAI に登録したテンプレートを識別する 1 ~ 50 文字の一意の文字列です。テンプレート ID は、メッセージに対して指定した送信者 ID に関連付ける必要があります。

メッセージを送信する

次のコード例は、Amazon SNS を使用して SMS メッセージを発行する方法を示しています。

C++
SDK for C++

/** * Publish SMS: use Amazon SNS to send an SMS text message to a phone number. * Note: This requires additional AWS configuration prior to running example. * * NOTE: When you start using Amazon SNS to send SMS messages, your AWS account is in the SMS sandbox and you can only * use verified destination phone numbers. See https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html. * NOTE: If destination is in the US, you also have an additional restriction that you have use a dedicated * origination ID (phone number). You can request an origination number using Amazon Pinpoint for a fee. * See https://aws.amazon.com/blogs/compute/provisioning-and-using-10dlc-origination-numbers-with-amazon-sns/ * for more information. * * <phone_number_value> input parameter uses E.164 format. * For example, in United States, this input value should be of the form: +12223334444 */ int main(int argc, char ** argv) { if (argc != 3) { std::cout << "Usage: publish_sms <message_value> <phone_number_value> " << std::endl; return 1; } Aws::SDKOptions options; Aws::InitAPI(options); { Aws::SNS::SNSClient sns; Aws::String message = argv[1]; Aws::String phone_number = argv[2]; Aws::SNS::Model::PublishRequest psms_req; psms_req.SetMessage(message); psms_req.SetPhoneNumber(phone_number); auto psms_out = sns.Publish(psms_req); if (psms_out.IsSuccess()) { std::cout << "Message published successfully " << psms_out.GetResult().GetMessageId() << std::endl; } else { std::cout << "Error while publishing message " << psms_out.GetError().GetMessage() << std::endl; } } Aws::ShutdownAPI(options); return 0; }
  • 手順とその他のコードについては GitHub でご確認いただけます。

  • API の詳細については、AWS SDK for C++ API リファレンスの「Publish」を参照してください。

Java
SDK for Java 2.x

public static void pubTextSMS(SnsClient snsClient, String message, String phoneNumber) { try { PublishRequest request = PublishRequest.builder() .message(message) .phoneNumber(phoneNumber) .build(); PublishResponse result = snsClient.publish(request); System.out.println(result.messageId() + " Message sent. Status was " + result.sdkHttpResponse().statusCode()); } catch (SnsException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } }
  • 手順とその他のコードについては GitHub でご確認いただけます。

  • API の詳細については、AWS SDK for Java 2.x API リファレンスの「Publish」を参照してください。

PHP
SDK for PHP

require 'vendor/autoload.php'; use Aws\Sns\SnsClient; use Aws\Exception\AwsException; /** * Sends a a text message (SMS message) directly to a phone number using Amazon SNS. * * This code expects that you have AWS credentials set up per: * https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html */ $SnSclient = new SnsClient([ 'profile' => 'default', 'region' => 'us-east-1', 'version' => '2010-03-31' ]); $message = 'This message is sent from a Amazon SNS code sample.'; $phone = '+1XXX5550100'; try { $result = $SnSclient->publish([ 'Message' => $message, 'PhoneNumber' => $phone, ]); var_dump($result); } catch (AwsException $e) { // output error message if fails error_log($e->getMessage()); }
  • 手順とその他のコードについては GitHub でご確認いただけます。

  • 詳細については、「AWS SDK for PHP デベロッパーガイド」を参照してください。

  • API の詳細については、AWS SDK for PHP API リファレンスの「Publish」を参照してください。

Python
SDK for Python (Boto3)

class SnsWrapper: """Encapsulates Amazon SNS topic and subscription functions.""" def __init__(self, sns_resource): """ :param sns_resource: A Boto3 Amazon SNS resource. """ self.sns_resource = sns_resource def publish_text_message(self, phone_number, message): """ Publishes a text message directly to a phone number without need for a subscription. :param phone_number: The phone number that receives the message. This must be in E.164 format. For example, a United States phone number might be +12065550101. :param message: The message to send. :return: The ID of the message. """ try: response = self.sns_resource.meta.client.publish( PhoneNumber=phone_number, Message=message) message_id = response['MessageId'] logger.info("Published message to %s.", phone_number) except ClientError: logger.exception("Couldn't publish message to %s.", phone_number) raise else: return message_id
  • 手順とその他のコードについては GitHub でご確認いただけます。

  • API の詳細については、AWSSDK for Python (Boto3) API リファレンスの「Publish」を参照してください。