本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
发送 RCS 短信
A TextMessage 是您可以通过 SendRcsMessage API 发送的最简单的内容类型。它由纯文本正文(最多 3,072 个字符)和可选的建议芯片组成,这些提示片作为交互式按钮显示在消息下方。
RCS 短信与短信有何不同
通过发送的短信SendRcsMessage与通过SendTextMessage(SMS)发送的短信在两个方面有所不同:
-
建议筹码:您最多可以在 RCS 短信中附上 11 个建议筹码。使用这些芯片,收件人只需一步即可回复、打开 URL、拨打电话号码、共享位置或创建日历活动。短信不支持建议。
-
Single-message 传送:无论长度如何(最多 3,072 个字符),RCS 短信都作为一条消息到达。运营商将长度超过 160 个字符的 SMS 消息分成多个分段,这些分段可能会混乱或在分段之间出现延迟。
有关所有可用建议类型及其参数的详细信息,请参阅配置 RCS 建议。
RcsMessageContent 短信的结构
调用时SendRcsMessage,将消息负载作为RcsMessageContent参数传递。对于短信,请将该Content字段设置为包含Body字符串的TextMessage对象。要包含建议筹码,请添加一个Suggestions数组作为的顶级兄弟数Content组。
以下 JSON 片段显示了带有建议的RcsMessageContent短信的结构:
{ "Content": { "TextMessage": { "Body": "What would you like to do?" } }, "Suggestions": [ { "Reply": { "Text": "Check order status", "PostbackData": "action=check_order" } }, { "OpenUrl": { "Text": "View details", "PostbackData": "action=view", "Url": "https://example.com/orders/1234" } } ] }
在本示例中:
-
Content.TextMessage.Body包含消息文本(必填字符,1 到 3,072 个字符)。 -
Suggestions是一个顶级数组(可选,最多 11 个项目)。每条建议都需要一个字Text段(最多 25 个字符)和一个字PostbackData段(最多 2,048 个字符)。
该Suggestions数组支持六种操作类型:ReplyOpenUrl、DialPhone、ShowLocation、RequestLocation、和CreateCalendarEvent。您可以在一条消息中混合使用不同的建议类型。有关每种类型的完整详细信息,请参阅配置 RCS 建议。
发送短信
要发送 RCS 短信,请SendRcsMessage使用以下必需参数进行调用:
-
DestinationPhoneNumber: E.164格式为收件人的电话号码。 -
OriginationIdentity:发送消息的池 ID 或 AWS RCS 代理。 -
RcsMessageContent: 包含ContentTextMessage对象的 JSON 字符串。
您可以使用 AWS CLI (aws pinpoint-sms-voice-v2 send-rcs-message) 或 AWS 软件开发工具包(例如 boto3 pinpoint-sms-voice-v2 客户端)调用 API。
短信或彩信后备
如果收件人的设备不支持 RCS 或者在 RCS 频道上暂时无法访问,则可以将消息配置为回退到短信或彩信。要启用后备功能,请在SendRcsMessage请求中包含一个FallbackConfiguration对象。FallbackConfiguration指定备用信道(SMS或MMS)、备用邮件正文和发件人身份(电话号码或发件人 ID),用于备用消息。
回退是可选的。如果省略FallbackConfiguration并且收件人无法收到 RCS,则消息不会送达。
有关配置回退行为的更多信息,请参阅发送丰富的 RCS 消息。
短信限制
| 资源 | 限制 | 注意 |
|---|---|---|
消息正文 (Body) |
3,072 个字符 () UTF-8 | 必需。必须包含至少 1 个字符。 |
| 每条留言的建议 | 11 | 回复和操作的总数。 |
建议显示文本 (Text) |
25 个字符 | 适用于所有建议类型。 |
回发数据 () PostbackData |
2,048 个字符 | 所有建议类型均为必填项。 |
何时使用短信
用TextMessage于:
-
订单确认、配送更新和预约提醒等通知。
-
One-time 密码和验证码。
-
对话提示提供回复选项作为建议芯片,无需自由文本输入即可实现引导式互动。
-
简短的状态更新,其中内容不需要图像或结构化布局。
对于需要图片、视频或带有标题和描述的结构化布局的消息,请改用丰富的卡片或轮播。请参阅发送丰富的 RCS 消息。