AWS End User Messaging SMS を使用して MMS メッセージを送信する例
共有リソースを使用している場合は、リソースの完全な Amazon リソースネーム (ARN) を使用する必要があります。AWS CLI または AWS End User Messaging SMS および音声 v2 API を使用して、顧客に MMS メッセージを送信できます。
send-media-message AWS CLI コマンドを使用して MMS メッセージを送信します。AWS CLI の設定の詳細は、AWS Command Line Interfaceユーザーガイドの「AWS CLI の設定」を参照してください。
重要
MMS 機能は、一部の国でのみ使用できます。SMS および MMS をサポートしている国の詳細については、「AWS End User Messaging SMS を使用した SMS メッセージングでサポートされている国と地域」および「AWS End User Messaging SMS を使用した MMS メッセージングでサポートされている国と地域」を参照してください。
発信元 ID が MMS 対応かどうかを確認するには、「AWS End User Messaging SMS で電話番号のステータスと機能を表示する」を参照してください。
共有リソースを使用するには、完全な Amazon リソースネーム (ARN) を使用する必要があります。
前提条件
開始するには、以下の前提条件を満たす必要があります。
-
MMS メッセージの送信をサポートする発信元 ID が必要です。
-
MMS 対応の送信元 ID と同じ AWS リージョンにある Amazon S3 バケットにメディアファイルをアップロードする必要があります。「MMS ファイル用 Amazon S3 バケットのセットアップ」を参照してください。
各 MMS ファイルの S3 URI。
send-media-messageを呼び出すために使用される ID には、メディアファイルを含む Amazon S3 バケットへの読み取りアクセスが必要です。読み取りアクセスの設定の詳細は、Amazon S3 ユーザーガイドの「Amazon S3 のアイデンティティベースのポリシー例」を参照してください。
AWS CLI を使用して MMS を送信する
send-media-message に必要なパラメータは destination-phone-number と origination-identity のみです。media-urls パラメータを省略することにより、テキストのみのメッセージを送信できます。message-body パラメータを省略することにより、メディアファイルのみのメッセージを送信することもできます。
MMS メッセージを送信するには
-
コマンドラインで以下のコマンドを入力します。
aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number+12065550150--origination-identity+14255550120--message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'上のコマンドに、以下の変更を加えます。
-
us-east-1を、発信元 ID が保存されている AWS リージョン に置き換えます。 -
+12065550150を送信先電話番号に置き換えます。 -
+14255550120を発信元 ID に置き換えます。発信元 ID はACTIVEで、送信先電話番号に送信できる必要があります。 -
text bodyをテキストメッセージに置き換えます。 -
s3://s3-bucket/media_file.jpgを MMS ファイルの S3 URI に置き換えます。サポートされているメディアファイル形式は、「MMS ファイルの種類、サイズ、文字数の制限」に記載されています。S3 バケットの作成とオブジェクトの管理の詳細については、MMS ファイル用 Amazon S3 バケットのセットアップ または Amazon S3 ユーザーガイドの「バケットの作成」および「オブジェクトのアップロード」を参照してください。
-
AWS End User Messaging SMS がコマンドを受け入れると、MessageID を受け取ります。これは、コマンドが正常に受信されただけで、送信先デバイスがメッセージを受信したわけではありません。エラーコードのリストは、「SendMediaMessage エラー」を参照してください。
{
"MessageId": "string"
}
MMS ファイル用 Amazon S3 バケットのセットアップ
MMS ファイルは Amazon S3 バケットに保存する必要があります。Amazon S3 バケットは、MMS 対応の送信元 ID と同じ AWS アカウントおよび AWS リージョンにある必要があります。ここでは、Amazon S3 バケットの作成方法、ファイルのアップロード方法、および URI をファイルに構築する方法を説明しています。Amazon S3 コマンドの詳細は、「AWS CLI で高レベル (s3) コマンドを使用する」を参照してください。AWS CLI の設定の詳細は、AWS Command Line Interfaceユーザーガイドの「AWS CLI の設定」を参照してください。
Amazon S3 バケットを作成するには、create-bucket
aws s3api create-bucket --region 'us-east-1' --bucketBucketName
上記のコマンドでは:
-
us-east-1を、MMS 対応の発信元 ID がある AWS リージョンに置き換えます。 BucketNameを新しいバケット名に置き換えます。
Amazon S3 バケットにファイルをコピーするには、cp AWS CLI コマンドを使用します。コマンドラインで以下のコマンドを入力します。
aws s3 cpSourceFilePathAndNames3://BucketName/FileName
上記のコマンドでは:
SourceFilePathAndNameをコピーするファイルパスと名前に置き換えます。BucketNameをバケット名に置き換えます。FileNameをファイルに使用する名前に置き換えます。
送信時に使用する URI は次のとおりです。
s3://BucketName/FileName