This email was sent using the " + "\n Amazon Pinpoint API " + "\n using the AWS SDK for .NET" + "\n
" + "\n" + "\n"; // The character encoding the you want to use for the subject line and // message body of the email. string charset = "UTF-8"; var sendRequest = new SendMessagesRequest { ApplicationId = appId, MessageRequest = new MessageRequest { Addresses = new DictionaryThis email was sent with the Amazon Pinpoint API using the AWS SDK for JavaScript in Node.js.
`; // The character encoding the you want to use for the subject line and // message body of the email. var charset = "UTF-8"; // Specify that you're using a shared credentials file. 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: appId, MessageRequest: { Addresses: { [toAddress]: { ChannelType: "EMAIL", }, }, MessageConfiguration: { EmailMessage: { FromAddress: senderAddress, SimpleEmail: { Subject: { Charset: charset, Data: subject, }, HtmlPart: { Charset: charset, Data: body_html, }, TextPart: { Charset: charset, Data: body_text, }, }, }, }, }, }; //Try to send the email. pinpoint.sendMessages(params, function (err, data) { // If something goes wrong, print an error message. if (err) { console.log(err.message); } else { console.log( "Email sent! Message ID: ", data["MessageResponse"]["Result"][toAddress]["MessageId"] ); } }); ``` ------ #### [ Python ] この例を使用して、[AWS SDK for Python (Boto3)](https://aws.amazon.com/sdk-for-python/) を使用して E メールを送信します。この例は、SDK for Python (Boto3) がすでにインストールされ、設定されていることを前提としています。詳細については、「*AWS SDK for Python (Boto3) API リファレンス*」の「[クイックスタート](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_email_message( pinpoint_client, app_id, sender, to_addresses, char_set, subject, html_message, text_message, ): """ Sends an email message with HTML and plain text versions. :param pinpoint_client: A Boto3 Pinpoint client. :param app_id: The Amazon Pinpoint project ID to use when you send this message. :param sender: The "From" address. This address must be verified in Amazon Pinpoint in the AWS Region you're using to send email. :param to_addresses: The addresses on the "To" line. If your Amazon Pinpoint account is in the sandbox, these addresses must be verified. :param char_set: The character encoding to use for the subject line and message body of the email. :param subject: The subject line of the email. :param html_message: The body of the email for recipients whose email clients can display HTML content. :param text_message: The body of the email for recipients whose email clients don't support HTML content. :return: A dict of to_addresses and their message IDs. """ try: response = pinpoint_client.send_messages( ApplicationId=app_id, MessageRequest={ "Addresses": { to_address: {"ChannelType": "EMAIL"} for to_address in to_addresses }, "MessageConfiguration": { "EmailMessage": { "FromAddress": sender, "SimpleEmail": { "Subject": {"Charset": char_set, "Data": subject}, "HtmlPart": {"Charset": char_set, "Data": html_message}, "TextPart": {"Charset": char_set, "Data": text_message}, }, } }, }, ) except ClientError: logger.exception("Couldn't send email.") raise else: return { to_address: message["MessageId"] for to_address, message in response["MessageResponse"]["Result"].items() } def main(): app_id = "ce796be37f32f178af652b26eexample" sender = "sender@example.com" to_address = "recipient@example.com" char_set = "UTF-8" subject = "Amazon Pinpoint Test (SDK for Python (Boto3))" text_message = """Amazon Pinpoint Test (SDK for Python) ------------------------------------- This email was sent with Amazon Pinpoint using the AWS SDK for Python (Boto3). For more information, see https://aws.amazon.com/sdk-for-python/ """ html_message = """This email was sent with Amazon Pinpoint using the AWS SDK for Python (Boto3).
""" print("Sending email.") message_ids = send_email_message( boto3.client("pinpoint"), app_id, sender, [to_address], char_set, subject, html_message, text_message, ) print(f"Message sent! Message IDs: {message_ids}") if __name__ == "__main__": main() ``` 次の例のように、メッセージテンプレートを使用して E メールメッセージを送信することもできます。 ``` import logging import boto3 from botocore.exceptions import ClientError logger = logging.getLogger(__name__) def send_templated_email_message( pinpoint_client, project_id, sender, to_addresses, template_name, template_version ): """ Sends an email message with HTML and plain text versions. :param pinpoint_client: A Boto3 Pinpoint client. :param project_id: The Amazon Pinpoint project ID to use when you send this message. :param sender: The "From" address. This address must be verified in Amazon Pinpoint in the AWS Region you're using to send email. :param to_addresses: The addresses on the "To" line. If your Amazon Pinpoint account is in the sandbox, these addresses must be verified. :param template_name: The name of the email template to use when sending the message. :param template_version: The version number of the message template. :return: A dict of to_addresses and their message IDs. """ try: response = pinpoint_client.send_messages( ApplicationId=project_id, MessageRequest={ "Addresses": { to_address: {"ChannelType": "EMAIL"} for to_address in to_addresses }, "MessageConfiguration": {"EmailMessage": {"FromAddress": sender}}, "TemplateConfiguration": { "EmailTemplate": { "Name": template_name, "Version": template_version, } }, }, ) except ClientError: logger.exception("Couldn't send email.") raise else: return { to_address: message["MessageId"] for to_address, message in response["MessageResponse"]["Result"].items() } def main(): project_id = "296b04b342374fceb661bf494example" sender = "sender@example.com" to_addresses = ["recipient@example.com"] template_name = "My_Email_Template" template_version = "1" print("Sending email.") message_ids = send_templated_email_message( boto3.client("pinpoint"), project_id, sender, to_addresses, template_name, template_version, ) print(f"Message sent! Message IDs: {message_ids}") if __name__ == "__main__": main() ``` これらの例では、共有認証情報ファイルを使用して既存のユーザーのアクセスキーとシークレットアクセスキーを指定することを前提としています。詳細については、『*AWS SDK for Python (Boto3) API Reference*』の「[認証情報](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html)」を参照してください。 ------ # Amazon Pinpoint を使用して E メールにサブスクリプション解除ヘッダーを追加する **注記** E メールヘッダーを使用する前に、キャンペーンまたはジャーニーから E メールを送信する場合は、E メールオーケストレーション送信ロールを設定する必要があります。直接送信 E メールの場合は、`ses:SendEmail` と `ses:SendRawEmail` のアクセス許可が必要です。詳細については、「[Amazon Pinpoint ユーザーガイド](https://docs.aws.amazon.com/pinpoint/latest/userguide/)」の「[E メールオーケストレーション送信ロールの作成](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-orchestration-sending-role.html)」を参照してください。 E メールに登録解除リンクを含めることはベストプラクティスであり、一部の国ではそれが法的要件となっています。ワンクリックサブスクリプション解除リンクを追加するには、次のヘッダーを追加します。 1. ヘッダーの **[名前]** を `List-Unsubscribe` に設定し、**[値]** をサブスクリプション解除リンクに設定します。リンクは、受信者のサブスクリプション解除リクエストを処理するための HTTP POST リクエストをサポートしている必要があります。 1. ヘッダーの **[名前]** を `List-Unsubscribe-Post` に設定し、**[値]** を `List-Unsubscribe=One-Click` に設定します。 E メールメッセージには最大 15 個のヘッダーを追加できます。サポートされているヘッダーのリストについては、「[Amazon Simple Email Service デベロッパーガイド](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/)」の「[Amazon SES ヘッダーフィールド](https://docs.aws.amazon.com/ses/latest/dg/header-fields.html)」を参照してください。 次の例は、 AWS Command Line Interfaceを使用してサブスクリプション解除ヘッダーを含む E メールメッセージを送信する方法を示しています。の設定の詳細については AWS CLI、 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)の[「 の設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)」を参照してください。 次のコマンドを使用するには、次の操作を行います。 + *AppId* をアプリケーション ID に置き換えます。 + *richard\$1roe@example.com* を受信者の E メールアドレスに置き換えます。 + *https://example.com/unsub* をサブスクリプション解除リンクに置き換えます。 + *example123456* を受信者の一意の識別子に置き換えます。 ``` aws pinpoint send-messages --application-id AppId --message-request '{ "Addresses": { "richard_roe@example.com": { "ChannelType": "EMAIL" } }, "MessageConfiguration": { "EmailMessage": { "Substitutions": { "url": [ "https://example.com/unsub" ], "id1": [ "/example123456" ] }, "SimpleEmail": { "TextPart": { "Data": "Sample email message with an subscribe header", "Charset": "UTF-8" }, "Subject": { "Data": "Hello", "Charset": "UTF-8" }, "Headers": [ { "Name": "List-Unsubscribe", "Value": "{{url}}{{id1}}" }, { "Name": "List-Unsubscribe-Post", "Value": "List-Unsubscribe=One-Click" } ] } } } }' ``` # 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* For more information, see the following documentation topic: *
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SendVoiceMessage {
// The Amazon Polly voice that you want to use to send the message. For a list
// of voices, see https://docs.aws.amazon.com/polly/latest/dg/voicelist.html
static final String voiceName = "Matthew";
// The language to use when sending the message. For a list of supported
// languages, see
// https://docs.aws.amazon.com/polly/latest/dg/SupportedLanguage.html
static final String languageCode = "en-US";
// The content of the message. This example uses SSML to customize and control
// certain aspects of the message, such as by adding pauses and changing
// phonation. The message can't contain any line breaks.
static final String ssmlMessage = "