Skip to content

小程序第三方身份接入 ​

接入状态

此功能待上线。接入时间请以诺云通知为准。

客户用户从自有微信小程序进入诺云直播间后,可将客户侧的用户 ID 关联到当前诺云登录用户。支持该字段的消息推送可携带这个 ID。

接入流程图 ​

  1. 客户服务端取得当前用户的 third_uuid,申请跳转凭证
  2. 客户小程序用户点击后,携带 ticket 跳转至诺云小程序
  3. 诺云小程序用户登录后完成身份关联,再进入直播间
  4. 客户服务端接收已有事件推送,读取客户用户 ID

小程序跳转示例 ​

用户点击时调用 wx.navigateToMiniProgram。extraData 传对象,凭证放在顶层的 ticket 字段,值取自签发响应的 data.ticket。

javascript
wx.navigateToMiniProgram({
  appId: nuoyunAppId,
  path: 'pages/video/pages/video_load/load?scene=123456',
  extraData: {
    ticket: launchTicket
  }
})

launchTicket 是客户服务端转交的字符串凭证。nuoyunAppId 为目标诺云小程序的 AppID,示例中的 123456 替换为签发时的 room_id。

诺云小程序的既有跳转参数位于 referrerInfo.extraData。已有对接使用 third_param 时,按原约定保留该字段,ticket 与它同级。ticket 的接收需在本功能上线后使用。

消息推送中的客户用户 ID ​

已有推送继续使用 data.third_user_info.third_uuid,例如:

按对应事件文档处理推送。事件用户已建立关联时,可从这个字段读取客户侧用户 ID。请兼容 third_user_info 缺失或没有有效 third_uuid 的情况。推送读取当前用户关联,订单创建时不另存身份快照。

接入注意事项 ​

  • third_uuid 按字符串传递,例如 "000123",保留前导零。
  • 跳转凭证有效期为 5 分钟。每次跳转使用本次申请的凭证,避免把凭证写入分享链接、二维码或日志。分享接收人通过自己的身份重新申请凭证。
  • 当前用户与客户 ID 已经关联时可复用。身份关联有冲突时,需要先核实归属。