# Invite a promoter
After the merchant declares the promoter to the platform, it can invite the promoter to [authentication Weixin Mini Program] to complete the binding operation in the following two ways: A) Half screen jump (recommended):
- Step 1: Weixin Mini Program Developers can apply for AppID:wx97537671f13cd770)'s half-screen tilt permissions (developers can initiate an application in the Settings - Third Party Settings - Half-screen Widget Management in the Widget Management back-end. Up to 10 widgets can be applied for). Please notify Industry Manager Sue after applying during the preview to verify permission
- Step 2: In the merchant Weixin Mini Program call https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.openEmbeddedMiniProgram.html interface configuration half screen jump to the corresponding [[authentication Mini Program] path (details refer tohttps://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html) The format of the path is: / pages / bindPromoter / bindPromoter? AppID =%s&role=%u&openType=2 Where AppID is the Weixin Mini Program used to declare the identity of the promoter, and role is the role_id passed in when declaring the promoter
- Step 3: The merchant guides the promotion staff in the merchant Weixin Mini Program half screen opens [authentication Mini Program] (namely "Mini Program promotion staff") to complete the authorization binding operation.
(b) Distribution of materials: Step 1: Merchants through the interface (document below) to obtain the invitation poster, tag and other [certification Weixin Mini Program] materials; Step 2: Merchants in the community, SMS, app and other scenarios to guide the promotion staff by inviting material into the Weixin Mini Program invitation confirmation page to complete the authorization binding operation.
# I. Get promotional invitation material
# Request address
POST https://api.weixin.qq.com/promoter/getinvitationmaterial?access_token=ACCESS_TOKEN
# Request parameters
parameter | type | Is it compulsory? | Introductions |
---|---|---|---|
role_id | uint32 | yes | Role id, role_id need to adjust the "query role" interface query |
invitation_type | uint32 | no | 0: Poster 1: Weixin Mini Program Code 2: Short chain (default returns poster) |
# Example Requests
{
"role_id": 1,
"invitation_type": 0
}
# Return value
attribute | type | Introductions |
---|---|---|
poster | string | Poster (image base64) |
qrcode | string | Weixin Mini Program code (image base64) |
tag | string | Short Chains |
errcode | int32 | Error code |
errmsg | string | Error message |
# Return data example
{
"poster": "xxxxx",
"qrcode": "xxxxx",
"tag": "xxxxx",
"errcode": 0,
"errmsg": "OK"
}
Note: poster, qrcode, tag will only return one of them. The invitation material is valid for 30 days. Please re-access the material when it expires.