翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon を使用して携帯電話にSMSメッセージを発行する SNS
Amazon を使用してSNS、電話番号を Amazon SNSトピックにサブスクライブしなくても、携帯電話に直接SMSメッセージを送信できます。
メッセージを送信するとき、メッセージがコストまたは信頼性に対して最適化されているかどうかを制御できます。送信者 ID または発信番号を指定することもできます。Amazon SNSAPIまたは を使用してプログラムでメッセージを送信する場合は AWS SDKs、メッセージ配信の上限価格を指定できます。
各SMSメッセージには最大 140 バイトを含めることができ、文字クォータはエンコーディングスキームによって異なります。例えば、SMSメッセージには以下を含めることができます。
-
160 GSM文字
-
140 ASCII文字
-
70UCS~2 文字
サイズクォータを超えるメッセージを発行すると、Amazon はそれを複数のメッセージとしてSNS送信し、各メッセージはサイズクォータ内でフィットします。メッセージは単語の途中ではなく、単語の境目で切り離されます。1 回のSMS発行アクションの合計サイズクォータは 1,600 バイトです。
SMS メッセージを送信するときは、国際通信に使用される標準の電話番号構造である E.164 形式を使用して電話番号を指定します。この形式に従う電話番号は最大 15 桁を設定でき、プラス記号 (+) および国コードのプレフィックスが付いています。例えば、E.164 形式の米国の電話番号は +1XXX5550100 と表示されます。
コンソールを使用したメッセージの送信
Amazon SNSコンソール にサインインします。
-
コンソールメニューで、AWS SMSメッセージング をサポートする リージョンを選択します。
-
ナビゲーションペインで、テキストメッセージ (SMS) を選択します。
-
モバイルテキストメッセージ (SMS) ページで、テキストメッセージの発行 を選択します。
-
メッセージ発行SMSページのメッセージタイプ で、次のいずれかを選択します。
このメッセージレベルの設定をすると、アカウントレベルのデフォルトメッセージタイプは上書きされます。アカウントレベルのデフォルトのメッセージタイプは、モバイルSMSテキストメッセージ () ページのテキストメッセージ設定セクションから設定できます。
プロモーションおよびトランザクションメッセージの料金情報については、「Worldwide SMS Pricing」を参照してください。
-
[送信先電話番号] に、メッセージを送信する電話番号を入力します。
-
[メッセージ] に、送信するメッセージを入力します。
-
(オプション) [送信元アイデンティティ] で、受信者を識別する方法を指定します。
-
(オプション) [送信者 ID] に、少なくとも 1 つの文字を含み、スペースは含まない、3~11 文字の英数字のカスタム ID を入力します。送信者 ID は、受信側デバイスにメッセージ送信者として表示されます。例えば、メッセージソースを識別しやすいように、ビジネスブランドを使用できます。
送信者のサポートIDsは、国や地域によって異なります。例えば、米国の電話番号へ配信されるメッセージは、送信者 ID を表示しません。送信者 をサポートする国と地域についてはIDs、「」を参照してくださいAmazon SNS がサポートする国と地域。
送信者 ID を指定しない場合、次のいずれか 1 つが送信元 ID として表示されます。
このメッセージレベルの送信者 ID は、[テキストメッセージプリファレンス] ページで設定するデフォルトの送信者 ID を上書きします。
-
[送信元番号] を指定するには、受信者のデバイス上で送信者の電話番号として表示する 5~14 の数字の文字列を入力します。この文字列は、 AWS アカウント 送信先の国の で設定されている送信元番号と一致する必要があります。発信元番号は、10DLC 桁の番号、通話料無料番号、 person-to-person ロングコード、ショートコードのいずれかです。詳細については、「Amazon メッセージの送信元 ID SNS SMS 」を参照してください。
発信番号を指定しない場合、Amazon は AWS アカウント 設定に基づいてSMSテキストメッセージに使用する発信番号SNSを選択します。
-
インドの受信者にSMSメッセージを送信する場合は、国固有の属性 を展開し、次の属性を指定します。
-
エンティティ ID – インドの受信者にSMSメッセージを送信するためのエンティティ ID またはプリンシパルエンティティ (PE) ID。この ID は、 に登録したエンティティを識別するためにインド通信規制局 (TRAI) が提供する 1~50 文字の一意の文字列ですTRAI。
-
テンプレート ID – インドの受信者にSMSメッセージを送信するためのテンプレート ID。この ID は、 に登録したテンプレートを識別する TRAIが提供する 1~50 文字の一意の文字列ですTRAI。テンプレート ID は、メッセージに対して指定した送信者 ID に関連付ける必要があります。
インドの受信者にSMSメッセージを送信する方法の詳細については、「」を参照してくださいインドの Amazon SNS 送信者 ID 登録要件。
-
[メッセージの発行] を選択します。
発信元番号からSMSメッセージを送信するには、Amazon SNSコンソールのナビゲーションパネルで発信元番号を選択することもできます。機能 列SMSに含まれる発信元番号を選択し、テキストメッセージの発行 を選択します。
を使用したメッセージの送信 AWS SDKs
のいずれかを使用してSMSメッセージを送信するには AWS SDKs、Amazon の Publish
リクエストSDKに対応する SNS APIオペレーションを使用しますAPI。このリクエストでは、電話番号に直接SMSメッセージを送信できます。次の属性名の値を設定する場合、MessageAttributes
パラメータも使用できます。
AWS.SNS.SMS.SenderID
-
少なくとも 1 つの文字を含み、スペースは含まない、3 ~ 11 文字の英数字のカスタム ID。送信者 ID は、受信デバイスにメッセージ送信者として表示されます。例えば、メッセージ ソースを識別しやすいように、ビジネスブランドを使用できます。
送信者のサポートIDsは、国または地域によって異なります。例えば、米国の電話番号へ配信されるメッセージは、送信者 ID を表示しません。送信者 をサポートする国またはリージョンのリストについてはIDs、「」を参照してくださいAmazon SNS がサポートする国と地域。
送信者 ID を指定しない場合、サポートされている国またはリージョンでは、メッセージは送信者 ID としてロングコードを表示します。アルファベットの送信者 ID を必要とする国またはリージョンの場合、 は送信者 ID としてNOTICE表示されます。
このメッセージレベルの属性は、SetSMSAttributes
リクエストを使用して設定する、アカウントレベルの属性 DefaultSenderID
を上書きします。
AWS.MM.SMS.OriginationNumber
-
5~14 個の数値のカスタム文字列で、オプションの先頭にプラス記号 (+
) を付けられます。この番号文字列は、受信側のデバイスの送信者の電話番号として表示されます。文字列は、送信先の国の AWS アカウントで設定されている送信元番号と一致する必要があります。発信元番号は、10DLC 桁の番号、通話料無料番号、 person-to-person (P2P) ロングコード、またはショートコードです。詳細については、「Amazon の送信元番号について SNS」を参照してください。
発信番号を指定しない場合、Amazon は AWS アカウント設定に基づいて発信番号SNSを選択します。
AWS.SNS.SMS.MaxPrice
-
SMS メッセージを送信するために使用する USD の上限価格。Amazon は、メッセージを送信する際に上限価格を超えるコストが発生するSNSと判断した場合、メッセージを送信しません。
この属性は、コストがMonthlySpendLimit
既に属性に設定されたクォータを超えている場合 month-to-date SMS、効果はありません。SetSMSAttributes
リクエストを使用して MonthlySpendLimit
属性を設定できます。
Amazon SNSトピックにメッセージを送信する場合、トピックにサブスクライブされている各電話番号への各メッセージ配信に上限料金が適用されます。
AWS.SNS.SMS.SMSType
-
送信するメッセージのタイプ。
このメッセージレベルの属性は、SetSMSAttributes
リクエストを使用して設定する、アカウントレベルの属性 DefaultSMSType
を上書きします。
AWS.MM.SMS.EntityId
-
この属性は、インドの受信者にSMSメッセージを送信する場合にのみ必要です。
これは、インドの受信者にSMSメッセージを送信するためのエンティティ ID またはプリンシパルエンティティ (PE) ID です。この ID は、 に登録したエンティティを識別するためにインド通信規制局 (TRAI) が提供する 1~50 文字の一意の文字列ですTRAI。
AWS.MM.SMS.TemplateId
-
この属性は、インドの受信者にSMSメッセージを送信する場合にのみ必要です。
これは、インドの受信者にSMSメッセージを送信するためのテンプレートです。この ID は、 に登録したテンプレートを識別する TRAIが提供する一意の 1~50 文字の文字列ですTRAI。テンプレート ID は、メッセージに対して指定した送信者 ID に関連付ける必要があります。
メッセージを送信する
次のコード例は、Amazon を使用してSMSメッセージを発行する方法を示していますSNS。
- .NET
-
- AWS SDK for .NET
-
については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。
namespace SNSMessageExample
{
using System;
using System.Threading.Tasks;
using Amazon;
using Amazon.SimpleNotificationService;
using Amazon.SimpleNotificationService.Model;
public class SNSMessage
{
private AmazonSimpleNotificationServiceClient snsClient;
/// <summary>
/// Initializes a new instance of the <see cref="SNSMessage"/> class.
/// Constructs a new SNSMessage object initializing the Amazon Simple
/// Notification Service (Amazon SNS) client using the supplied
/// Region endpoint.
/// </summary>
/// <param name="regionEndpoint">The Amazon Region endpoint to use in
/// sending test messages with this object.</param>
public SNSMessage(RegionEndpoint regionEndpoint)
{
snsClient = new AmazonSimpleNotificationServiceClient(regionEndpoint);
}
/// <summary>
/// Sends the SMS message passed in the text parameter to the phone number
/// in phoneNum.
/// </summary>
/// <param name="phoneNum">The ten-digit phone number to which the text
/// message will be sent.</param>
/// <param name="text">The text of the message to send.</param>
/// <returns>Async task.</returns>
public async Task SendTextMessageAsync(string phoneNum, string text)
{
if (string.IsNullOrEmpty(phoneNum) || string.IsNullOrEmpty(text))
{
return;
}
// Now actually send the message.
var request = new PublishRequest
{
Message = text,
PhoneNumber = phoneNum,
};
try
{
var response = await snsClient.PublishAsync(request);
}
catch (Exception ex)
{
Console.WriteLine($"Error sending message: {ex}");
}
}
}
}
- C++
-
- SDK C++ 用
-
については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。
/**
* Publish SMS: use Amazon Simple Notification Service (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
*/
//! Send an SMS text message to a phone number.
/*!
\param message: The message to publish.
\param phoneNumber: The phone number of the recipient in E.164 format.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::SNS::publishSms(const Aws::String &message,
const Aws::String &phoneNumber,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::SNS::SNSClient snsClient(clientConfiguration);
Aws::SNS::Model::PublishRequest request;
request.SetMessage(message);
request.SetPhoneNumber(phoneNumber);
const Aws::SNS::Model::PublishOutcome outcome = snsClient.Publish(request);
if (outcome.IsSuccess()) {
std::cout << "Message published successfully with message id, '"
<< outcome.GetResult().GetMessageId() << "'."
<< std::endl;
}
else {
std::cerr << "Error while publishing message "
<< outcome.GetError().GetMessage()
<< std::endl;
}
return outcome.IsSuccess();
}
- Java
-
- SDK for Java 2.x
-
については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.PublishRequest;
import software.amazon.awssdk.services.sns.model.PublishResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PublishTextSMS {
public static void main(String[] args) {
final String usage = """
Usage: <message> <phoneNumber>
Where:
message - The message text to send.
phoneNumber - The mobile phone number to which a message is sent (for example, +1XXX5550100).\s
""";
if (args.length != 2) {
System.out.println(usage);
System.exit(1);
}
String message = args[0];
String phoneNumber = args[1];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
pubTextSMS(snsClient, message, phoneNumber);
snsClient.close();
}
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);
}
}
}
- Kotlin
-
- SDK Kotlin 用
-
については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。
suspend fun pubTextSMS(
messageVal: String?,
phoneNumberVal: String?,
) {
val request =
PublishRequest {
message = messageVal
phoneNumber = phoneNumberVal
}
SnsClient { region = "us-east-1" }.use { snsClient ->
val result = snsClient.publish(request)
println("${result.messageId} message sent.")
}
}
- PHP
-
- PHP に関する SDK
-
については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;
/**
* Sends 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());
}
- Python
-
- SDK for Python (Boto3)
-
については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリでの設定と実行の方法を確認してください。
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