**サポート終了通知:** 2026 年 10 月 30 日に、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日を過ぎると、Amazon Pinpoint コンソールまたは Amazon Pinpoint のリソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、「[Amazon Pinpoint のサポート終了](https://docs.aws.amazon.com/console/pinpoint/migration-guide)」を参照してください。**注:** SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Pinpoint を使用してトランザクション SMS メッセージを送信する
Amazon Pinpoint API を使用して、特定の電話番号やエンドポイント ID に SMS メッセージ (テキストメッセージ) を送信できます。このセクションには、AWS SDK を使用して Amazon Pinpoint API を介して SMS メッセージを送信するのに使用できる、完全なコードの例を含みます。アカウントは本番稼働中で、SMS メッセージを送信できるアクティブな送信元 ID を持っている必要があります。
エンドポイント、セグメント、チャネルのコード例の詳細については、「[コード例](https://docs.aws.amazon.com/pinpoint/latest/developerguide/service_code_examples.html)」を参照してください。
------
#### [ C\$1 ]
この例を使用して、[AWS SDK for .NET](https://aws.amazon.com/sdk-for-net/) を使用して SMS メッセージを送信します。この例は、SDK for .NET がすでにインストールされ、設定されていることを前提としています。詳細については、『*AWS SDK for .NET デベロッパーガイド*』の「[使用開始](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config.html)」を参照してください。
この例では、共有認証情報ファイルを使用して、既存の IAM ユーザーのアクセスキーとシークレットアクセスキーを指定することを前提としています。詳細については、『*AWS SDK for .NETデベロッパーガイド*』の「[AWS 認証情報の設定](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/creds-idc.html)」を参照してください。
```
using Amazon;
using Amazon.Pinpoint;
using Amazon.Pinpoint.Model;
using Microsoft.Extensions.Configuration;
namespace SendSmsMessage;
public class SendSmsMessageMainClass
{
public static async Task Main(string[] args)
{
var configuration = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("settings.json") // Load test settings from .json file.
.AddJsonFile("settings.local.json",
true) // Optionally load local settings.
.Build();
// The AWS Region that you want to use to send the message. For a list of
// AWS Regions where the Amazon Pinpoint API is available, see
// https://docs.aws.amazon.com/pinpoint/latest/apireference/
string region = "us-east-1";
// The phone number or short code to send the message from. The phone number
// or short code that you specify has to be associated with your Amazon Pinpoint
// account. For best results, specify long codes in E.164 format.
string originationNumber = configuration["OriginationNumber"]!;
// The recipient's phone number. For best results, you should specify the
// phone number in E.164 format.
string destinationNumber = configuration["DestinationNumber"]!;
// The Pinpoint project/ application ID to use when you send this message.
// Make sure that the SMS channel is enabled for the project or application
// that you choose.
string appId = configuration["AppId"]!;
// The type of SMS message that you want to send. If you plan to send
// time-sensitive content, specify TRANSACTIONAL. If you plan to send
// marketing-related content, specify PROMOTIONAL.
MessageType messageType = MessageType.TRANSACTIONAL;
// The registered keyword associated with the originating short code.
string? registeredKeyword = configuration["RegisteredKeyword"];
// The sender ID to use when sending the message. Support for sender ID
// varies by country or region. For more information, see
// https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-countries.html
string? senderId = configuration["SenderId"];
try
{
var response = await SendSmsMessage(region, appId, destinationNumber,
originationNumber, registeredKeyword, senderId, messageType);
Console.WriteLine($"Message sent to {response.MessageResponse.Result.Count} recipient(s).");
foreach (var messageResultValue in
response.MessageResponse.Result.Select(r => r.Value))
{
Console.WriteLine($"{messageResultValue.MessageId} Status: {messageResultValue.DeliveryStatus}");
}
}
catch (Exception ex)
{
Console.WriteLine("The message wasn't sent. Error message: " + ex.Message);
}
}
public static async Task SendSmsMessage(
string region, string appId, string destinationNumber, string originationNumber,
string? keyword, string? senderId, MessageType messageType)
{
// The content of the SMS message.
string message = "This message was sent through Amazon Pinpoint using" +
" the AWS SDK for .NET. Reply STOP to opt out.";
var client = new AmazonPinpointClient(RegionEndpoint.GetBySystemName(region));
SendMessagesRequest sendRequest = new SendMessagesRequest
{
ApplicationId = appId,
MessageRequest = new MessageRequest
{
Addresses =
new Dictionary
{
{
destinationNumber,
new AddressConfiguration { ChannelType = ChannelType.SMS }
}
},
MessageConfiguration = new DirectMessageConfiguration
{
SMSMessage = new SMSMessage
{
Body = message,
MessageType = MessageType.TRANSACTIONAL,
OriginationNumber = originationNumber,
SenderId = senderId,
Keyword = keyword
}
}
}
};
SendMessagesResponse response = await client.SendMessagesAsync(sendRequest);
return response;
}
}
```
------
#### [ Java ]
この例を使用して、[AWS SDK for Java](https://aws.amazon.com/sdk-for-java/) を使用して SMS メッセージを送信します。この例は、SDK for Java がすでにインストールされ、設定されていることを前提としています。詳細については、『*AWS SDK for Java デベロッパーガイド*』の「[使用開始](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html)」を参照してください。
この例では、共有認証情報ファイルを使用して、既存の IAM ユーザーのアクセスキーとシークレットアクセスキーを指定することを前提としています。詳細については、『*AWS SDK for Java デベロッパーガイド*』の「[デフォルトの認証情報およびリージョンの設定](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup.html#setup-credentials)」を参照してください。
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.DirectMessageConfiguration;
import software.amazon.awssdk.services.pinpoint.model.SMSMessage;
import software.amazon.awssdk.services.pinpoint.model.AddressConfiguration;
import software.amazon.awssdk.services.pinpoint.model.ChannelType;
import software.amazon.awssdk.services.pinpoint.model.MessageRequest;
import software.amazon.awssdk.services.pinpoint.model.SendMessagesRequest;
import software.amazon.awssdk.services.pinpoint.model.SendMessagesResponse;
import software.amazon.awssdk.services.pinpoint.model.MessageResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.HashMap;
import java.util.Map;
```
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.DirectMessageConfiguration;
import software.amazon.awssdk.services.pinpoint.model.SMSMessage;
import software.amazon.awssdk.services.pinpoint.model.AddressConfiguration;
import software.amazon.awssdk.services.pinpoint.model.ChannelType;
import software.amazon.awssdk.services.pinpoint.model.MessageRequest;
import software.amazon.awssdk.services.pinpoint.model.SendMessagesRequest;
import software.amazon.awssdk.services.pinpoint.model.SendMessagesResponse;
import software.amazon.awssdk.services.pinpoint.model.MessageResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.HashMap;
import java.util.Map;
/**
* 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 SendMessage {
// The type of SMS message that you want to send. If you plan to send
// time-sensitive content, specify TRANSACTIONAL. If you plan to send
// marketing-related content, specify PROMOTIONAL.
public static String messageType = "TRANSACTIONAL";
// The registered keyword associated with the originating short code.
public static String registeredKeyword = "myKeyword";
// The sender ID to use when sending the message. Support for sender ID
// varies by country or region. For more information, see
// https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-countries.html
public static String senderId = "MySenderID";
public static void main(String[] args) {
final String usage = """
Usage: \s
Where:
message - The body of the message to send.
appId - The Amazon Pinpoint project/application ID to use when you send this message.
originationNumber - The phone number or short code that you specify has to be associated with your Amazon Pinpoint account. For best results, specify long codes in E.164 format (for example, +1-555-555-5654).
destinationNumber - The recipient's phone number. For best results, you should specify the phone number in E.164 format (for example, +1-555-555-5654).\s
""";
if (args.length != 4) {
System.out.println(usage);
System.exit(1);
}
String message = args[0];
String appId = args[1];
String originationNumber = args[2];
String destinationNumber = args[3];
System.out.println("Sending a message");
PinpointClient pinpoint = PinpointClient.builder()
.region(Region.US_EAST_1)
.build();
sendSMSMessage(pinpoint, message, appId, originationNumber, destinationNumber);
pinpoint.close();
}
public static void sendSMSMessage(PinpointClient pinpoint, String message, String appId,
String originationNumber,
String destinationNumber) {
try {
Map addressMap = new HashMap();
AddressConfiguration addConfig = AddressConfiguration.builder()
.channelType(ChannelType.SMS)
.build();
addressMap.put(destinationNumber, addConfig);
SMSMessage smsMessage = SMSMessage.builder()
.body(message)
.messageType(messageType)
.originationNumber(originationNumber)
.senderId(senderId)
.keyword(registeredKeyword)
.build();
// Create a DirectMessageConfiguration object.
DirectMessageConfiguration direct = DirectMessageConfiguration.builder()
.smsMessage(smsMessage)
.build();
MessageRequest msgReq = MessageRequest.builder()
.addresses(addressMap)
.messageConfiguration(direct)
.build();
// create a SendMessagesRequest object
SendMessagesRequest request = SendMessagesRequest.builder()
.applicationId(appId)
.messageRequest(msgReq)
.build();
SendMessagesResponse response = pinpoint.sendMessages(request);
MessageResponse msg1 = response.messageResponse();
Map map1 = msg1.result();
// Write out the result of sendMessage.
map1.forEach((k, v) -> System.out.println((k + ":" + v)));
} catch (PinpointException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
SDK のサンプルについては、[GitHub](https://github.com/) の「[SendMessage.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/pinpoint/src/main/java/com/example/pinpoint/SendMessage.java/)」を参照してください。
------
#### [ JavaScript (Node.js) ]
この例では、[AWS SDK for JavaScript in Node.js](https://aws.amazon.com/sdk-for-javascript/) を使用して SMS を送信しています。この例では、SDK for JavaScript in Node.js がすでにインストールされ、設定されていることを前提としています。詳細については、『*AWS SDK for JavaScript in Node.js デベロッパーガイド*』の「[使用開始](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-nodejs.html)」を参照してください。
この例では、共有認証情報ファイルを使用して、既存の IAM ユーザーのアクセスキーとシークレットアクセスキーを指定することを前提としています。詳細については、『*AWS SDK for JavaScript in Node.js デベロッパーガイド*』の「[認証情報の設定](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials.html)」を参照してください。
```
"use strict";
var AWS = require("aws-sdk");
// The AWS Region that you want to use to send the message. For a list of
// AWS Regions where the Amazon Pinpoint API is available, see
// https://docs.aws.amazon.com/pinpoint/latest/apireference/.
var aws_region = "us-east-1";
// The phone number or short code to send the message from. The phone number
// or short code that you specify has to be associated with your Amazon Pinpoint
// account. For best results, specify long codes in E.164 format.
var originationNumber = "+12065550199";
// The recipient's phone number. For best results, you should specify the
// phone number in E.164 format.
var destinationNumber = "+14255550142";
// The content of the SMS message.
var message =
"This message was sent through Amazon Pinpoint " +
"using the AWS SDK for JavaScript in Node.js. Reply STOP to " +
"opt out.";
// The Amazon Pinpoint project/application ID to use when you send this message.
// Make sure that the SMS channel is enabled for the project or application
// that you choose.
var applicationId = "ce796be37f32f178af652b26eexample";
// The type of SMS message that you want to send. If you plan to send
// time-sensitive content, specify TRANSACTIONAL. If you plan to send
// marketing-related content, specify PROMOTIONAL.
var messageType = "TRANSACTIONAL";
// The registered keyword associated with the originating short code.
var registeredKeyword = "myKeyword";
// The sender ID to use when sending the message. Support for sender ID
// varies by country or region. For more information, see
// https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-countries.html
var senderId = "MySenderID";
// Specify that you're using a shared credentials file, and optionally specify
// the profile that you want to use.
var credentials = new AWS.SharedIniFileCredentials({ profile: "default" });
AWS.config.credentials = credentials;
// Specify the region.
AWS.config.update({ region: aws_region });
//Create a new Pinpoint object.
var pinpoint = new AWS.Pinpoint();
// Specify the parameters to pass to the API.
var params = {
ApplicationId: applicationId,
MessageRequest: {
Addresses: {
[destinationNumber]: {
ChannelType: "SMS",
},
},
MessageConfiguration: {
SMSMessage: {
Body: message,
Keyword: registeredKeyword,
MessageType: messageType,
OriginationNumber: originationNumber,
SenderId: senderId,
},
},
},
};
//Try to send the message.
pinpoint.sendMessages(params, function (err, data) {
// If something goes wrong, print an error message.
if (err) {
console.log(err.message);
// Otherwise, show the unique ID for the message.
} else {
console.log(
"Message sent! " +
data["MessageResponse"]["Result"][destinationNumber]["StatusMessage"]
);
}
});
```
------
#### [ Python ]
この例を使用して、[AWS SDK for Python (Boto3)](https://aws.amazon.com/sdk-for-python/) を使用して SMS メッセージを送信します。この例は、SDK for Python がすでにインストールされ、設定されていることを前提としています。詳細については、「* AWS SDK for Python (Boto3) Getting Started*」の「[クイックスタート](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)」を参照してください。
```
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
def send_sms_message(
pinpoint_client,
app_id,
origination_number,
destination_number,
message,
message_type,
):
"""
Sends an SMS message with Amazon Pinpoint.
:param pinpoint_client: A Boto3 Pinpoint client.
:param app_id: The Amazon Pinpoint project/application ID to use when you send
this message. The SMS channel must be enabled for the project or
application.
:param destination_number: The recipient's phone number in E.164 format.
:param origination_number: The phone number to send the message from. This phone
number must be associated with your Amazon Pinpoint
account and be in E.164 format.
:param message: The content of the SMS message.
:param message_type: The type of SMS message that you want to send. If you send
time-sensitive content, specify TRANSACTIONAL. If you send
marketing-related content, specify PROMOTIONAL.
:return: The ID of the message.
"""
try:
response = pinpoint_client.send_messages(
ApplicationId=app_id,
MessageRequest={
"Addresses": {destination_number: {"ChannelType": "SMS"}},
"MessageConfiguration": {
"SMSMessage": {
"Body": message,
"MessageType": message_type,
"OriginationNumber": origination_number,
}
},
},
)
except ClientError:
logger.exception("Couldn't send message.")
raise
else:
return response["MessageResponse"]["Result"][destination_number]["MessageId"]
def main():
app_id = "ce796be37f32f178af652b26eexample"
origination_number = "+12065550199"
destination_number = "+14255550142"
message = (
"This is a sample message sent from Amazon Pinpoint by using the AWS SDK for "
"Python (Boto 3)."
)
message_type = "TRANSACTIONAL"
print("Sending SMS message.")
message_id = send_sms_message(
boto3.client("pinpoint"),
app_id,
origination_number,
destination_number,
message,
message_type,
)
print(f"Message sent! Message ID: {message_id}.")
if __name__ == "__main__":
main()
```
次の例のように、メッセージテンプレートを使用して SMS メッセージを送信することもできます。
```
import logging
import boto3
from botocore.exceptions import ClientError
logger = logging.getLogger(__name__)
def send_templated_sms_message(
pinpoint_client,
project_id,
destination_number,
message_type,
origination_number,
template_name,
template_version,
):
"""
Sends an SMS message to a specific phone number using a pre-defined template.
:param pinpoint_client: A Boto3 Pinpoint client.
:param project_id: An Amazon Pinpoint project (application) ID.
:param destination_number: The phone number to send the message to.
:param message_type: The type of SMS message (promotional or transactional).
:param origination_number: The phone number that the message is sent from.
:param template_name: The name of the SMS template to use when sending the message.
:param template_version: The version number of the message template.
:return The ID of the message.
"""
try:
response = pinpoint_client.send_messages(
ApplicationId=project_id,
MessageRequest={
"Addresses": {destination_number: {"ChannelType": "SMS"}},
"MessageConfiguration": {
"SMSMessage": {
"MessageType": message_type,
"OriginationNumber": origination_number,
}
},
"TemplateConfiguration": {
"SMSTemplate": {"Name": template_name, "Version": template_version}
},
},
)
except ClientError:
logger.exception("Couldn't send message.")
raise
else:
return response["MessageResponse"]["Result"][destination_number]["MessageId"]
def main():
region = "us-east-1"
origination_number = "+18555550001"
destination_number = "+14255550142"
project_id = "7353f53e6885409fa32d07cedexample"
message_type = "TRANSACTIONAL"
template_name = "My_SMS_Template"
template_version = "1"
message_id = send_templated_sms_message(
boto3.client("pinpoint", region_name=region),
project_id,
destination_number,
message_type,
origination_number,
template_name,
template_version,
)
print(f"Message sent! Message ID: {message_id}.")
if __name__ == "__main__":
main()
```
これらの例では、共有認証情報ファイルを使用して既存の IAM ユーザーのアクセスキーとシークレットアクセスキーを指定することを前提としています。詳細については、『*AWS SDK for Python (Boto3) API Reference*』の「[認証情報](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html)」を参照してください。
------