# 邀请推广员

商家向平台声明推广员后,可通过以下两种方式邀请推广员前往【认证小程序】完成绑定操作: a)半屏跳转(推荐):

  • Step 1: 小程序开发者完成「小程序推广员」的功能开通后,可申请【认证小程序】(appid:wx97537671f13cd770)的半屏拉起权限(开发者可在 小程序管理后台「设置」-「第三方设置」-「半屏小程序管理」板块发起申请,最多可以申请10个小程序),内测期间申请后请通知行业经理Sue审核通过权限
  • Step 2: 在商户小程序内调用https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.openEmbeddedMiniProgram.html接口配置半屏跳转至对应【认证小程序】path(详情参考https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html) path的格式为:/pages/bindPromoter/bindPromoter?appid=%s&role=%u&openType=2 其中appid为声明推广员身份所用的小程序,role为声明推广员时传入的role_id
  • Step 3: 商户引导推广员在商家小程序中半屏打开【认证小程序】(即“小程序推广员”)完成授权绑定操作。

b)分发素材: Step 1: 商户通过接口(文档如下)获取邀请海报、tag等【认证小程序】素材; Step 2: 商户在社群、短信、app等场景引导推广员通过邀请素材进入【认证小程序】邀请确认页面,完成授权绑定操作。

# 一、获取推广员邀请素材

# 请求地址

POST https://api.weixin.qq.com/promoter/getinvitationmaterial?access_token=ACCESS_TOKEN

# 请求参数

参数 类型 是否必填 说明
role_id uint32 角色id,role_id需调「查询角色」接口查询
invitation_type uint32 0:海报 1:小程序码 2:短链(默认返回海报)

# 请求示例

{
  "role_id": 1,
  "invitation_type": 0
}

# 返回值

属性 类型 说明
poster string 海报(图片base64)
qrcode string 小程序码(图片base64)
tag string 短链
errcode int32 错误码
errmsg string 错误信息

# 返回数据示例

{
  "poster": "xxxxx",
  "qrcode": "xxxxx",
  "tag": "xxxxx",
  "errcode": 0,
  "errmsg": "OK"
}

注:poster、qrcode、tag只会返回其中一个。邀请素材的有效期为30天,失效后请重新获取素材。