View a markdown version of this page

使用发送彩信的示例 AWS 最终用户消息 SMS - AWS 最终用户消息 SMS
先决条件使用... 发送彩信 AWS CLI设置 Amazon S3 存储桶

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用发送彩信的示例 AWS 最终用户消息 SMS

如果您使用的是共享资源，则必须使用该资源的完整 Amazon 资源名称（ARN）。您可以使用 AWS CLI 或 AWS 最终用户消息 SMS 和语音 v2 API 向您的客户发送彩信。

使用 send-media-messag AWS CLI e 命令发送彩信。有关配置的更多信息 AWS CLI，请参阅AWS Command Line Interface 用户指南中的配置 AWS CLI 。

重要

彩信功能仅在部分国家/地区可用。有关支持短信和彩信服务的国家/地区的更多信息，请参阅支持使用以下地址发送短信的国家和地区 AWS 最终用户消息 SMS和支持发送彩信的国家和地区 AWS 最终用户消息 SMS。

要检查您的发起身份是否支持彩信功能，请参阅在中查看电话号码的状态和功能 AWS 最终用户消息 SMS。

要使用共享资源，必须使用完整的 Amazon 资源名称（ARN）。

先决条件

在您开始之前，必须满足以下先决条件：

  • 您必须拥有支持发送彩信的发起身份。

  • 您必须将媒体文件上传到与您的彩信发起 AWS 区域 身份相同的 Amazon S3 存储桶，请参阅。为彩信文件设置 Amazon S3 存储桶

    有关支持的文件类型和大小列表，请参阅。

  • 每个彩信文件的 S3 URI。

  • 用于调用 send-media-message 的身份必须拥有对包含您的媒体文件的 Amazon S3 存储桶的读取访问权限。有关设置读取访问权限的更多信息，请参阅 Amazon S3 用户指南中的 A mazon S3 Identity-based 策略示例。

使用... 发送彩信 AWS CLI

send-media-message 仅需两个必需参数：destination-phone-number 和 origination-identity。您可以通过省略 media-urls 参数来发送仅包含文本的消息。您可以通过省略 message-body 参数来发送仅包含媒体文件的消息。

发送彩信

  • 在命令行输入以下命令：

    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'

    在前面的命令中，进行以下更改：

如果 AWS 最终用户消息 SMS 接受该命令，您将收到MessageID. 这仅表示命令已成功接收，并不意味着目标设备已收到消息。有关错误代码的列表，请参阅SendMediaMessage 错误。

{
   "MessageId": "string"
}

为彩信文件设置 Amazon S3 存储桶

您的彩信文件必须存储在 Amazon S3 存储桶中。Amazon S3 存储桶必须与您具有彩信功能的发起 AWS 区域 身份相同 AWS 账户 且与您的发起身份相同。这些说明展示了如何创建 Amazon S3 存储桶、上传文件以及构建文件的 URI。有关 Amazon S3 命令的更多信息，请参阅通过 AWS CLI 使用高级别（s3）命令。有关配置的更多信息 AWS CLI，请参阅AWS Command Line Interface 用户指南中的配置 AWS CLI 。

要创建 Amazon S3 存储桶，请使用 create-bucket 命令 AWS CLI 。在命令行输入以下命令：

aws s3api create-bucket --region 'us-east-1' --bucket BucketName

在上述命令中：

  • 替换为 AWS 区域 您us-east-1具有彩信功能的原始身份信息。

  • BucketName替换为新存储桶的名称。

要将文件复制到 Amazon S3 存储桶，请使用 cp AWS CLI 命令。在命令行输入以下命令：

aws s3 cp SourceFilePathAndName s3://BucketName/FileName

在上述命令中：

  • SourceFilePathAndName替换为要复制的文件的文件路径和名称。

  • 将 BucketName 替换为存储桶名称。

  • FileName替换为用于该文件的名称。

发送时要使用的 URI 为：

s3://BucketName/FileName