sms_callback

自定义短信通道回调对接说明

对接流程概述

一、配置请求


xxxxxxxxxx
   如需使用自定义短信通道发送直播相关短信，并自定义短信文案，需按以下规范提供对应的API接口并提供给CC技术支持进行账号级配置。否则以下短信将会默认使用CC短信通道及短信文案。

二、可自定义配置功能


xxxxxxxxxx
1）报名观看验证码（预约、登录）
2）报名审核通过通知短信
3）直播开播提醒短信
4）表单收集验证码
按需自定义配置某个或多个对应的功能。

三、地址验证


xxxxxxxxxx
当有相关短信功能发送时CC系统会回调该接口进行短信发送，该接口客户自行实现短信发送及自定义相关内容。
CC服务采用 POST 请求方式并以 application/json 格式发送数据，从而触发回调通知(备注：回调接口要求3秒以内处理完成)。

四、回调短信接口参数说明

1、报名观看验证码回调参数说明

名称	说明	是否必须	父节点
type	类型 1@为报名观看验证码2@表单手机短信验证码3@报名审核短信4@开播提醒短信	是
code	验证码	是
mobiles	手机号信息，仅有1条	是
countryCode	区号	是	mobiles
mobile	手机号码	是	mobiles
example	发送短信的示例，可以直接按照此示例配置到短信平台	是

请求体示例：


xxxxxxxxxx
{
  "code": "687119",
  "mobiles": [
    {
      "countryCode": "+86",
      "mobile": "19930130810"
    }
  ],
  "type": 1,
  "example": "您的短信验证码为“${code}“，5分钟内有效，请在页面中输入以完成验证"
}

2、表单收集验证码回调参数说明

名称	说明	是否必须	父节点
type	类型 1@为报名观看验证码2@表单手机短信验证码3@报名审核短信4@开播提醒短信	是
code	验证码	是
mobiles	手机号信息，仅有1条	是
countryCode	区号	是	mobiles
mobile	手机号码	是	mobiles
example	发送短信的示例，可以直接按照此示例配置到短信平台	是

请求体示例：


xxxxxxxxxx
{
  "code": "687119",
  "mobiles": [
    {
      "countryCode": "+86",
      "mobile": "19930130810"
    }
  ],
  "type": 2,
  "example": "您的短信验证码为“${code}“，5分钟内有效，请在页面中输入以完成验证"
}

3、开播提醒短信回调参数说明（批量发送mobiles每次最大100 条数据）

名称	说明	是否必须	父节点
type	类型 1@为报名观看验证码2@表单手机短信验证码3@报名审核短信4@开播提醒短信	是
title	直播间标题	是
watchUrl	观看链接	是
time	开播时间，格式为：yyyy年MM月dd日HH:MM:ss	是
mobiles	批量手机号信息，最大不超过100条	是
countryCode	区号	是	mobiles
mobile	手机号码	是	mobiles
example	发送短信的示例，可以直接按照此示例配置到短信平台	是

请求体示例：


xxxxxxxxxx
{
  "type": 4,
  "title": "自定义短信通道验证",
  "mobiles": [
    {
      "mobile": "19010000000",
      "countryCode": "+86"
    },  {
      "mobile": "19010000001",
      "countryCode": "+86"
    }
  ],
  "watchUrl": "https://view.csslcloud.net/api/view/index?roomid=1D9BB51B493A903B&userid=8E30D832E73CDA069C33DC5901307461",
  "time": "2025年05月30日14:26:00",
  "example": "您预约的“${title}”将在“${time}”开播，观看链接：“${watchUrl}”"}

4、报名审核通过短信回调参数说明（批量发送mobiles每次最大100 条数据）

名称	说明	是否必须	父节点
type	类型 1@为报名观看验证码2@表单手机短信验证码3@报名审核短信4@开播提醒短信	是
title	直播间标题	是
mobiles	批量手机号信息，最大不超过100条	是
countryCode	区号	是	mobiles
mobile	手机号码	是	mobiles
example	发送短信的示例，可以直接按照此示例配置到短信平台	是

请求体示例：


{
  "type": 3,
  "title": "自定义短信通道验证",
  "mobiles": [
    {
      "mobile": "19000100000",
      "countryCode": "+86"
    },
    {
      "mobile": "19000200000",
      "countryCode": "+86"
    }
  ],
  "example": "您预约的直播“${title}”审核已通过"}