发送 RCS 消息
异步受理 RCS/彩信消息批次，返回 HTTP 200 与逐条受理结果；支持 API Key 或 CheckSum 鉴权。
请求示例
先选择验签方法，再选择消息类型；<YOUR_API_KEY> 替换为实际 API KEY，JSON 请求体即 -d 单引号内的内容。
推荐方式：仅 Authorization: Bearer <YOUR_API_KEY> 一个鉴权头，无需签名。
TEXT 文本消息，带一个 REPLY 建议按钮。
curl -X POST "https://rcsapi.tig253.com/inter-rcs/v3/rcs/message/send" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json; charset=UTF-8" \
-d '{
"productKey": "rcs_otp",
"channel": "RCS",
"sender": "BrandName",
"uid": "demo_batch_20260814_001",
"destinations": [
发送 RCS 消息
curl -X POST "https://rcsapi.tig253.com/inter-rcs/v3/rcs/message/send" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"uid": "demo_batch_20260814_008",
"channel": "RCS",
"message": {
"mms": {
"media": {
"file": {
"url": "https://example.com/img/midautumn.jpg"
}
},
"title": "中秋礼遇",
"description": "全场礼盒 8 折，限时 3 天"
},
"type": "MMS"
},
"productKey": "mms_market",
"destinations": [
{
"to": "<PHONE>"
}
],
"sender": "YOUR_SENDER"
}'批次受理成功（HTTP 200）。
{
"code": "000000",
"data": {
"uid": "demo_batch_20260814_010",
"messages": [
{
"mobile": "8613482734980",
"status": "000000",
"messageId": "msg-2c4f8e1a-a1b2c3d4e5f60718293a4b5c",
"description": "Submitted success"
},
{
"mobile": "12345",
"status": "010003",
"messageId": null,
"description": "Wrong format of phone number"
}
]
},
"message": "success",
"traceId": "d87a93e50af0437ebcc0c80774126842",
"timestamp": "2026-11-11T03:00:01.000Z"
}来自当前规范的响应示例，不是真实请求结果。
提交 RCS 或彩信消息，成功受理返回 HTTP 200 和 code=000000，不代表最终送达。支持 Bearer 或 CheckSum 鉴权；受理code码见错误码介绍页。
使用 InnoPaaS AppKey 作为 Bearer Token。可在 Console 的 API 密钥页面创建或管理密钥。 查看密钥指南
授权
Authorizationstring<bearer>必填请求头参数
X-Custom-TraceIdstring可选Optional customer trace ID, recommended globally unique; forwarded to webhook payloads (customTraceId) and NOT echoed in the send response.
256请求主体
application/jsonuidstring可选客户自定义批次号，最长 64 字符，超长返回 010003。未传时系统回填 batchId；透传至回执推送报文，并在发送响应 data.uid 回显。
64senderstring必填发送方 sender。TEXT / FILE / CARD / CAROUSEL 消息必填，留空返回 010002；TEMPLATE / MMS 消息可空（模板消息用模板配置 sender 兜底）。
channelstring必填渠道，固定传 RCS（本期仅透传 + 日志，不参与路由）。
messageobject必填消息内容对象，由 type 决定必填的消息体字段。
展开子字段
mmsobject可选彩信消息体，type=MMS 时必填，与 mms_notify / mms_market 产品配合使用。
展开子字段
typestring可选内容类型，固定 MMS，可省略。
mediaobject必填媒体对象。
展开子字段
fileobject必填主媒体文件资源对象。
展开子字段
urlstring必填文件 URL，http/https 开头，1-1000 字符，文件 ≤100 MB。
1最大长度1000heightstring可选高度档位：SHORT / MEDIUM / TALL。
thumbnailobject可选视频缩略图对象，仅视频文件有效。
展开子字段
urlstring必填缩略图 URL，建议 ≤1 MB。
titlestring必填彩信标题。
descriptionstring可选彩信文本描述。
fileobject可选文件消息体，type=FILE 时必填。
展开子字段
fileobject必填文件资源对象。
展开子字段
urlstring必填文件 URL，http/https 开头，1-1000 字符，文件 ≤100 MB。
1最大长度1000typestring可选内容类型，固定 FILE，可省略。
thumbnailobject可选视频缩略图，仅视频文件有效。
展开子字段
urlstring必填缩略图 URL，建议 ≤1 MB。
suggestionsarray<object>可选按钮数组，最多 11 个。
展开子字段
urlstring可选OPEN_URL：目标链接，必填，必须以 http:// 或 https:// 开头，1-2048 字符。
1最大长度2048textstring可选按钮文字（用户可见），1-25 字符。
1最大长度25typestring可选按钮类型：REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT。
labelstring可选SHOW_LOCATION：位置标签，可选。
100titlestring可选CREATE_CALENDAR_EVENT：事件标题，必填，1-100 字符。
100endTimestring可选CREATE_CALENDAR_EVENT：结束时间，必填，须晚于开始时间，格式同 startTime。
latitudenumber可选SHOW_LOCATION：纬度，必填，范围 -90~90。
longitudenumber可选SHOW_LOCATION：经度，必填，范围 -180~180。
startTimestring可选CREATE_CALENDAR_EVENT：开始时间，必填，格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
applicationstring可选OPEN_URL：打开方式，BROWSER（默认）或 WEBVIEW；可选，仅透传不校验。
descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，可选，最长 500 字符。
500fallbackUrlstring可选REQUEST_LOCATION / CREATE_CALENDAR_EVENT：可选兜底链接，不校验。
phoneNumberstring可选DIAL_PHONE：拨打号码，必填，需带国家码并通过格式校验。
postbackDatastring可选点击后原样回传的数据，必填，1-2048 字符。
1最大长度2048webviewViewModestring可选OPEN_URL 且 WEBVIEW 时：FULL / HALF / TALL；可选，仅透传不校验。
typestring必填消息类型：TEXT / FILE / CARD / CAROUSEL / TEMPLATE / MMS。
cardMsgobject可选单卡片消息体，type=CARD 时必填。
展开子字段
typestring可选内容类型，固定 CARD，可省略。
contentobject必填卡片内容对象。
展开子字段
mediaobject可选卡片媒体对象，与 title 至少二选一。
展开子字段
fileobject必填主媒体文件资源对象。
展开子字段
urlstring必填文件 URL，http/https 开头，1-1000 字符，文件 ≤100 MB。
1最大长度1000heightstring可选高度档位：SHORT / MEDIUM / TALL。
thumbnailobject可选视频缩略图对象，仅视频文件有效。
展开子字段
urlstring必填缩略图 URL，建议 ≤1 MB。
titlestring可选卡片标题，1-200 字符，与 media 至少二选一。
1最大长度200descriptionstring可选卡片描述，1-2000 字符。
1最大长度2000suggestionsarray<object>可选卡片内按钮数组，最多 4 个。
展开子字段
urlstring可选OPEN_URL：目标链接，必填，必须以 http:// 或 https:// 开头，1-2048 字符。
1最大长度2048textstring可选按钮文字（用户可见），1-25 字符。
1最大长度25typestring可选按钮类型：REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT。
labelstring可选SHOW_LOCATION：位置标签，可选。
100titlestring可选CREATE_CALENDAR_EVENT：事件标题，必填，1-100 字符。
100endTimestring可选CREATE_CALENDAR_EVENT：结束时间，必填，须晚于开始时间，格式同 startTime。
latitudenumber可选SHOW_LOCATION：纬度，必填，范围 -90~90。
longitudenumber可选SHOW_LOCATION：经度，必填，范围 -180~180。
startTimestring可选CREATE_CALENDAR_EVENT：开始时间，必填，格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
applicationstring可选OPEN_URL：打开方式，BROWSER（默认）或 WEBVIEW；可选，仅透传不校验。
descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，可选，最长 500 字符。
500fallbackUrlstring可选REQUEST_LOCATION / CREATE_CALENDAR_EVENT：可选兜底链接，不校验。
phoneNumberstring可选DIAL_PHONE：拨打号码，必填，需带国家码并通过格式校验。
postbackDatastring可选点击后原样回传的数据，必填，1-2048 字符。
1最大长度2048webviewViewModestring可选OPEN_URL 且 WEBVIEW 时：FULL / HALF / TALL；可选，仅透传不校验。
alignmentstring必填图片对齐：LEFT / RIGHT。校验强制必传（VERTICAL 时也需携带）。
orientationstring必填卡片方向：HORIZONTAL（图左/右）/ VERTICAL（图上/下）。
suggestionsarray<object>可选卡片外按钮数组，最多 11 个。
展开子字段
urlstring可选OPEN_URL：目标链接，必填，必须以 http:// 或 https:// 开头，1-2048 字符。
1最大长度2048textstring可选按钮文字（用户可见），1-25 字符。
1最大长度25typestring可选按钮类型：REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT。
labelstring可选SHOW_LOCATION：位置标签，可选。
100titlestring可选CREATE_CALENDAR_EVENT：事件标题，必填，1-100 字符。
100endTimestring可选CREATE_CALENDAR_EVENT：结束时间，必填，须晚于开始时间，格式同 startTime。
latitudenumber可选SHOW_LOCATION：纬度，必填，范围 -90~90。
longitudenumber可选SHOW_LOCATION：经度，必填，范围 -180~180。
startTimestring可选CREATE_CALENDAR_EVENT：开始时间，必填，格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
applicationstring可选OPEN_URL：打开方式，BROWSER（默认）或 WEBVIEW；可选，仅透传不校验。
descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，可选，最长 500 字符。
500fallbackUrlstring可选REQUEST_LOCATION / CREATE_CALENDAR_EVENT：可选兜底链接，不校验。
phoneNumberstring可选DIAL_PHONE：拨打号码，必填，需带国家码并通过格式校验。
postbackDatastring可选点击后原样回传的数据，必填，1-2048 字符。
1最大长度2048webviewViewModestring可选OPEN_URL 且 WEBVIEW 时：FULL / HALF / TALL；可选，仅透传不校验。
textMsgobject可选文本消息体，type=TEXT 时必填。
展开子字段
textstring必填纯文本消息正文，0-3072 字符。
3072typestring可选内容类型，固定 TEXT，可省略。
suggestionsarray<object>可选按钮数组，最多 11 个。
展开子字段
urlstring可选OPEN_URL：目标链接，必填，必须以 http:// 或 https:// 开头，1-2048 字符。
1最大长度2048textstring可选按钮文字（用户可见），1-25 字符。
1最大长度25typestring可选按钮类型：REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT。
labelstring可选SHOW_LOCATION：位置标签，可选。
100titlestring可选CREATE_CALENDAR_EVENT：事件标题，必填，1-100 字符。
100endTimestring可选CREATE_CALENDAR_EVENT：结束时间，必填，须晚于开始时间，格式同 startTime。
latitudenumber可选SHOW_LOCATION：纬度，必填，范围 -90~90。
longitudenumber可选SHOW_LOCATION：经度，必填，范围 -180~180。
startTimestring可选CREATE_CALENDAR_EVENT：开始时间，必填，格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
applicationstring可选OPEN_URL：打开方式，BROWSER（默认）或 WEBVIEW；可选，仅透传不校验。
descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，可选，最长 500 字符。
500fallbackUrlstring可选REQUEST_LOCATION / CREATE_CALENDAR_EVENT：可选兜底链接，不校验。
phoneNumberstring可选DIAL_PHONE：拨打号码，必填，需带国家码并通过格式校验。
postbackDatastring可选点击后原样回传的数据，必填，1-2048 字符。
1最大长度2048webviewViewModestring可选OPEN_URL 且 WEBVIEW 时：FULL / HALF / TALL；可选，仅透传不校验。
templateobject可选模板消息体，type=TEMPLATE 时必填。模板需预先创建并审核通过；实际下发类型由模板配置决定（支持 RCS 与彩信）。
展开子字段
typestring可选内容类型，固定 TEMPLATE，可省略。
parametersarray<object>可选模板参数数组；变量模板必填，缺参返回 150002。
展开子字段
namestring必填参数名，对应模板中的 {{name}} 占位符。
valuestring必填参数值。
templateIdstring必填模板 ID（控制台审核通过），不存在返回 010005，未审核通过返回 150008。
carouselMsgobject可选轮播卡片消息体，type=CAROUSEL 时必填。
展开子字段
typestring可选内容类型，固定 CAROUSEL，可省略。
contentsarray<object>必填子卡片数组，2-10 张，每张结构同卡片内容。
展开子字段
mediaobject可选媒体对象：主文件、可选视频缩略图、可选高度档位。
展开子字段
fileobject必填主媒体文件资源对象。
展开子字段
urlstring必填文件 URL，http/https 开头，1-1000 字符，文件 ≤100 MB。
1最大长度1000heightstring可选高度档位：SHORT / MEDIUM / TALL。
thumbnailobject可选视频缩略图对象，仅视频文件有效。
展开子字段
urlstring必填缩略图 URL，建议 ≤1 MB。
titlestring可选CREATE_CALENDAR_EVENT：事件标题，1-100 字符。
1最大长度200descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，1-500 字符。
1最大长度2000suggestionsarray<object>可选该子卡片内按钮数组，最多 4 个。
展开子字段
urlstring可选OPEN_URL：目标链接，必填，必须以 http:// 或 https:// 开头，1-2048 字符。
1最大长度2048textstring可选按钮文字（用户可见），1-25 字符。
1最大长度25typestring可选按钮类型：REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT。
labelstring可选SHOW_LOCATION：位置标签，可选。
100titlestring可选CREATE_CALENDAR_EVENT：事件标题，必填，1-100 字符。
100endTimestring可选CREATE_CALENDAR_EVENT：结束时间，必填，须晚于开始时间，格式同 startTime。
latitudenumber可选SHOW_LOCATION：纬度，必填，范围 -90~90。
longitudenumber可选SHOW_LOCATION：经度，必填，范围 -180~180。
startTimestring可选CREATE_CALENDAR_EVENT：开始时间，必填，格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
applicationstring可选OPEN_URL：打开方式，BROWSER（默认）或 WEBVIEW；可选，仅透传不校验。
descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，可选，最长 500 字符。
500fallbackUrlstring可选REQUEST_LOCATION / CREATE_CALENDAR_EVENT：可选兜底链接，不校验。
phoneNumberstring可选DIAL_PHONE：拨打号码，必填，需带国家码并通过格式校验。
postbackDatastring可选点击后原样回传的数据，必填，1-2048 字符。
1最大长度2048webviewViewModestring可选OPEN_URL 且 WEBVIEW 时：FULL / HALF / TALL；可选，仅透传不校验。
cardWidthstring必填卡片宽度档位：SMALL / MEDIUM。
suggestionsarray<object>可选轮播外按钮数组，最多 11 个。
展开子字段
urlstring可选OPEN_URL：目标链接，必填，必须以 http:// 或 https:// 开头，1-2048 字符。
1最大长度2048textstring可选按钮文字（用户可见），1-25 字符。
1最大长度25typestring可选按钮类型：REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT。
labelstring可选SHOW_LOCATION：位置标签，可选。
100titlestring可选CREATE_CALENDAR_EVENT：事件标题，必填，1-100 字符。
100endTimestring可选CREATE_CALENDAR_EVENT：结束时间，必填，须晚于开始时间，格式同 startTime。
latitudenumber可选SHOW_LOCATION：纬度，必填，范围 -90~90。
longitudenumber可选SHOW_LOCATION：经度，必填，范围 -180~180。
startTimestring可选CREATE_CALENDAR_EVENT：开始时间，必填，格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
applicationstring可选OPEN_URL：打开方式，BROWSER（默认）或 WEBVIEW；可选，仅透传不校验。
descriptionstring可选CREATE_CALENDAR_EVENT：事件描述，可选，最长 500 字符。
500fallbackUrlstring可选REQUEST_LOCATION / CREATE_CALENDAR_EVENT：可选兜底链接，不校验。
phoneNumberstring可选DIAL_PHONE：拨打号码，必填，需带国家码并通过格式校验。
postbackDatastring可选点击后原样回传的数据，必填，1-2048 字符。
1最大长度2048webviewViewModestring可选OPEN_URL 且 WEBVIEW 时：FULL / HALF / TALL；可选，仅透传不校验。
productKeystring必填产品 key：rcs_otp（验证码）/ rcs_notify（通知）/ rcs_market（营销）/ mms_notify（彩信通知）/ mms_market（彩信营销）。模板消息发送时以模板配置为准（服务端按 templateId 回填），传入值在该场景被忽略。
smsFailoverobject可选RCS 发送失败时回落到文本短信的配置。
展开子字段
textstring必填回落短信文本内容。
senderstring必填回落短信的发送 sender。
destinationsarray<object>必填接收方列表，至少 1 个；条目数超过单次请求上限返回 010012。
展开子字段
tostring必填手机号，国际格式（带国家码，纯数字），例：8613482734980。
响应
application/json批次受理成功（HTTP 200）。
codestring必填六位数字字符串响应码，000000 表示本次接口操作成功。
dataobject必填业务结果：批次号 uid 与逐条受理结果 messages；请求整体失败时为 null。
展开子字段
uidstring必填批次号：传入 uid 原样回显，未传返回系统回填的 batchId，与回执推送报文一致。
messagesarray<object>必填逐条受理结果。
展开子字段
mobilestring必填提交手机号。
statusstring必填单条受理结果：000000 该条成功；其他值为该条六位错误码。
messageIdstringnull可选消息 ID（成功时返回，用于关联回执推送；失败条目为 null）。
descriptionstring必填描述（英文）：成功提示或该条失败原因；单一字段，不设 enDescription。
messagestring必填供人阅读的英文描述，不得作为程序判断依据；成功固定为 success。
traceIdstring必填平台生成的排查凭证（32 位十六进制），与请求头 X-Custom-TraceId 相互独立。
timestampstring必填响应生成时间，UTC ISO 8601 格式，毫秒精度，Z 结尾。
{
"code": "000000",
"data": {
"uid": "demo_batch_20260814_010",
"messages": [
{
"mobile": "8613482734980",
"status": "000000",
"messageId": "msg-2c4f8e1a-a1b2c3d4e5f60718293a4b5c",
"description": "Submitted success"
},
{
"mobile": "12345",
"status": "010003",
"messageId": null,
"description": "Wrong format of phone number"
}
]
},
"message": "success",
"traceId": "d87a93e50af0437ebcc0c80774126842",
"timestamp": "2026-11-11T03:00:01.000Z"
}来自当前规范的响应示例，不是真实请求结果。