View a markdown version of this page

发送 RCS 短信 - AWS 最终用户消息 SMS

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

发送 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数组支持六种操作类型:ReplyOpenUrlDialPhoneShowLocationRequestLocation、和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指定备用信道(SMSMMS)、备用邮件正文和发件人身份(电话号码或发件人 ID),用于备用消息。

回退是可选的。如果省略FallbackConfiguration并且收件人无法收到 RCS,则消息不会送达。

有关配置回退行为的更多信息,请参阅发送丰富的 RCS 消息

短信限制

资源 限制 注意
消息正文 (Body) 3,072 个字符 () UTF-8 必需。必须包含至少 1 个字符。
每条留言的建议 11 回复和操作的总数。
建议显示文本 (Text) 25 个字符 适用于所有建议类型。
回发数据 () PostbackData 2,048 个字符 所有建议类型均为必填项。

何时使用短信

TextMessage于:

  • 订单确认、配送更新和预约提醒等通知。

  • One-time 密码和验证码。

  • 对话提示提供回复选项作为建议芯片,无需自由文本输入即可实现引导式互动。

  • 简短的状态更新,其中内容不需要图像或结构化布局。

对于需要图片、视频或带有标题和描述的结构化布局的消息,请改用丰富的卡片或轮播。请参阅发送丰富的 RCS 消息