# 邀请推广员
商家向平台声明推广员后,可通过以下两种方式邀请推广员前往【认证小程序】完成绑定操作: 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天,失效后请重新获取素材。