注册送短信

素材上传事件

关键参数参数类型参数描述
eventstring事件类型,此处为Media
filestring文件URL,此参数的值为5G消息中素材使用的链接
filesizeint素材文件大小,此参数为5G消息中素材使用的文件大小
statusstring文件审核状态,0为审核通过,1为审核不通过
expiredstring素材过期时间,素材有消息目前为固定7天
timestampstring事件触发事件

数据示例

{
  "event":"Media",
  "file":"https://ftnj01.xnq.r.10086.cn:10099/s/003032024040311atT7rLLdSyn050FD.png",
  "filesize":1259515,
  "status":"0",
  "expired":"2024-04-10T11:45:33Z",
  "timestamp":"2024-04-03 09:42:50"
}

模板审核事件

关键参数参数类型参数描述
eventstring事件类型,此处为Template
templateIDstring模板ID
statusstring模板审核状态,0为审核通过,1为审核不通过
timestampstring事件触发事件

数据示例

{
  "event":"Template",
  "templateID":"S49Ecf",
  "status":"0",
  "timestamp":"2024-04-03 09:42:50"
}

消息发送事件

关键参数参数类型参数描述
eventstring事件类型,此处为Message
sendIDstring消息发送标识
tostring收件人号码
statusstring消息发送状态,状态的值包括:
DeliveryImpossible:发送失败<br/>DeliveredToTerminal:成功下发5G消息<br/>SMS:成功下发并回落为短信<br/>MMS:成功下发并回落为彩信
timestampstring事件触发事件

数据示例

{
  "event":"Message",
  "sendID":"4ee9be3058004b7f6a945558d580f4ce",
  "to":"15288888888",
  "status":"SMS",
  "timestamp":"2024-04-03 09:42:50"
}

消息撤回事件

关键参数参数类型参数描述
eventstring事件类型,此处为Invoke
sendIDstring消息发送标识
tostring收件人号码
statusstring消息发送状态,状态的值包括:
Revoked:撤回成功<br/>RevokeFailed:撤回失败
timestampstring事件触发事件

数据示例

{
  "event":"Invoke",
  "sendID":"4ee9be3058004b7f6a945558d580f4ce",
  "to":"15288888888",
  "status":"Revoked",
  "timestamp":"2024-04-03 09:42:50"
}

消息上行事件

关键参数参数类型参数描述
eventstring事件类型,此处为Mo
sendIDstring消息发送标识
conversationIDstring会话标识,终端点击下行消息中的建议操作或建议回复按钮,触发上行消息携带的conversationID将填写该下行消息的conversationID值;终端主动上行的消息携带的conversationID填写新生成的值。
contributionIDstring消息标识,终端点击下行消息中的建议操作或建议回复按钮触发的上行消息、主动上行的消息携带的contributionID均填写新生成的值。
inReplyToContributionIDstring标识是对另一条消息的回复,值是一条下行消息的contributionID。终端点击下行消息中的建议操作或建议回复按钮,触发上行消息携带的inReplyToContributionID将填写该下行消息的contributionID值;终端主动上行的消息不携带此字段。
tostring收件人号码
contentTypestring消息类型
bodyTextstring消息内容

数据示例

{
  "event":"Mo",
  "sendID":"4ee9be3058004b7f6a945558d580f4ce",
  "conversationID":"4ee9be3058004b7f6a945558d580f4ce",
  "contributionID":"4ee9be3058004b7f6a945558d580f4ce",
  "inReplyToContributionID":"4ee9be3058004b7f6a945558d580f4ce",
  "to":"15288888888",
  "contentType":"application/vnd.gsma.botsuggestion.response.v1.0+json",
  "bodyText":"{\"response\":{\"reply\":{\"displayText\":\"回复按钮\",\"postback\":\"data\":\"reply_btn\"}}}}",
  "timestamp":"2024-04-03 09:42:50"
}