页面历史记录

1、自建应用-营销活动-勾选活动信息回调

2、审核成功后配置第三方回调地址

当活动发布成功后，会推送活动信息给第三方

3、活动接口调用

1）当活动发布成功后，会推送活动信息给第三方3、活动接口调用 1）获取活动列表

/api/integrate/activity/getActivityList

请求方式 POST

consumes ["application/json"]

produces ["*application/*json"]

入参说明

参数名称	参数说明	请求类型	参数类型	是否必须	描述

signature

X-Token

接口签名

自建应用访问token

header

string

可用于第三方鉴权，加密方式参考签名鉴权

nonce

6位随机字符串

	true
activityName	活动标题	body	string	false
activityStatus	活动状态	body	string

timestamp时间戳

	false	活动状态：0未发布,1发布申请中,2已发布,3已发布有修改,4修改申请中,5已下线,10未开始,11进行中,12已过期
deptIds	归属部门	body	string

当前时间戳（毫秒）userInfo用户身份bodyList<userInfo> "userInfo":[{
"identityType":"openid", //身份类型
"identityValue":"obeXk1E7Vlt4YH5" //身份值

},{

"identityType":"phone", //身份类型
"identityValue":"13776529876" //身份值

}]

pushTitle通知标题bodystringcontent通知的消息内容bodystringpic图片地址bodystring可为空toUrl点通知后的跳转地址bodystring可为空，url携带参数pageType=app时表示跳转App原生页面；pageType=h5时表示跳转App内嵌H5页面msgId消息Idbodylong当响应是异步时会传递，同步则不会传extras额外参数bodymap可自定义 key/value 信息，以供业务使用

paramInfo

自定义参数body

List<ParamInfo>

"paramInfo":[{

"paramKey":"en", //对应系统集成的英文key

"paramValue":"值" // 如果是多项就是逗号分隔

},{

"paramKey":"en", //对应系统集成的英文key

"paramValue":"值" // 如果是多项就是逗号分隔

}]

请求示例

无格式

{
    "nonce":"XZTEKT",
    "timestamp":"1638011171354",
    "userInfo":[{
        "identityType":"openid",
        "identityValue":"obeXk1E7Vlt4YH5Sy1ILz_WR8lbN"
    }],
	"paramInfo":[{
        "paramKey":"en", //对应系统集成的英文key
        "paramValue":"value"  // 如果是多项就是逗号分隔 
	}],
    "pushTitle":"我是标题",
    "content":"我是内容",
    "toUrl":null,
    "msgId":914230644929216512,
    "pic":null
}

4、返回触达结果

1）同步返回

...

	false
pageNo	页码	body	int	false	默认值为1
pageSize	每页记录数	body	int	false	默认值为5

出参说明

参数名称	参数说明	参数类型	描述
activityId	活动Id	long
activityName	活动标题	string
activityCode	活动编号	string
beginTime	活动开始时间	date
endTime	活动结束时间	date
orgId	企业Id	string
activityIntroduction	活动简介	string
totalBudget	总预算	decimal
activityStatus	活动状态	int	活动状态：0未发布,1发布申请中,2已发布,3已发布有修改,4修改申请中,5已下线
approveStatus	审批状态	int	0空,1待提交审批,2发布审批中,3发布审批通过,4发布审批驳回,5发布审批撤销,6下线审批中,7下线审批通过, 8下线审批驳回,9下线审批撤销,10删除审批中,11删除审批驳回,12删除审批撤销
createUserId	创建人用户Id	string
deptRelVo	归属部门信息	object	{ "deptRelVo":{ "deptId":"872871040115032064", // 部门Id "deptName":"兔展智能科技/企业微信应用消息" // 部门名称全路径 } }
create_time	创建时间	date
update_time	更新时间	date

2）获取活动详情

/api/integrate/activity/getActivityDetail

请求方式 GET

入参说明

参数名称	参数说明	请求类型	参数类型	是否必须	描述
X-Token	自建应用访问token	header	string	true
activityId	活动Id	body	long	true

出参说明

参数名称	参数说明	参数类型	描述
activityId	活动Id	long
activityName	活动标题	string
activityCode	活动编号	string
beginTime	活动开始时间	date
endTime	活动结束时间	date
deptId	所属部门	long
activityIntroduction	活动简介	string
totalBudget	总预算	decimal
activityStatus	活动状态	int	活动状态：0未发布,1发布申请中,2已发布,3已发布有修改,4修改申请中,5已下线
approveStatus	审批状态	int	0空,1待提交审批,2发布审批中,3发布审批通过,4发布审批驳回,5发布审批撤销,6下线审批中,7下线审批通过, 8下线审批驳回,9下线审批撤销,10删除审批中,11删除审批驳回,12删除审批撤销
awardVoList	权益列表	list	{ "id":"984150119322968064", //权益Id "awardName":"One Piece", //权益名称 "costPrice":9.9, // 成本单价 "totalStock":0, // 奖品总数 "budgetPrice":0, //预算小计 "extraMultiple":0, // 额外倍数 "awardType":"PRIZE" // PRIZE=奖品 , COUPON=优惠券 , POINT=积分 , REDPACKET=红包 }
activityItemBudgetVoList	预算列表	list	{ "activityId":"978343893456105472", // 活动Id "orgId":"487aa4e1-cc06-4758-85e5-600705a05a94", // 企业Id "budgetName":"微信红包预算", // 预算名称 "usedBudget":1.2, // 已使用预算 "consumeCost":0, // 已消耗成本 "remainBudget":1.2, //剩余预算 "type":"REDPACKET" // PRIZE=奖品 , COUPON=优惠券 , POINT=积分 , REDPACKET=红包， CUSTOM=自定义 }
appContentVoList	作品列表	list	{ "appId":"c3a8e5dc-185d-4ad8-ae38-ef64deedcb4e", //作品Id "orgId":"487aa4e1-cc06-4758-85e5-600705a05a94", //企业Id "userId":"9c36b6e7-8c4c-4d78-94a8-41aad63ded78",// 创建人Id "appName":"我的兔展作品", // 作品名称 "appDesc":"我用兔展做了一个超炫酷的H5,快来看看吧！", // 描述 "shortUrl":"FrWpVqdvTgF", // 短链 "appTags":[ "942476802029531136", //标签id "935542501048463360" ], "publish":1, // 是否发布；1 是；0否 "deleteFlag":0, //是否删除；1 是；0否, "contentPlayVoList":{ "componentId":135, "pluginName":"玩法001", "prizeInfoDtos":[ { "prizeId":"奖品Id", "interestId":"权益Id", "thirdAwardId":"第三方奖品Id", "awardName":"奖品名称", "awardLevel":"奖品等级", "awardNum":888 } ] } }

4、活动变更推送信息

参数名称	参数说明	请求类型	参数类型	描述
signature	接口签名	header	string	可用于第三方鉴权，加密方式参考签名鉴权
nonce	6位随机字符串	body	string
timestamp	时间戳	body	string	当前时间戳（毫秒）
activityId	活动Id	body	long
activityCode	活动编码	body	string
activityName	活动名称	body	string
beginTime	活动开始时间	body	date
endTime	活动结束时间	body	date
activityIntroduction	活动简介	body	string
deptId	所属部门	body	long
createUserId	创建人	body	string
orgId	企业Id	body	string
totalBudget	总预算	body	decimal
activityStatus	活动状态	body	int	活动状态：0未发布,1发布申请中,2已发布,3已发布有修改,4修改申请中,5已下线
approveStatus	审批状态	body	int	0空,1待提交审批,2发布审批中,3发布审批通过,4发布审批驳回,5发布审批撤销,6下线审批中,7下线审批通过, 8下线审批驳回,9下线审批撤销,10删除审批中,11删除审批驳回,12删除审批撤销
create_time	创建时间	body	date
update_time	更新时间	body	date
awardVoList	权益列表	body	list	{ "id":"984150119322968064", //权益Id "awardName":"One Piece", //权益名称 "costPrice":9.9, // 成本单价 "totalStock":0, // 奖品总数 "budgetPrice":0, //预算小计 "extraMultiple":0, // 额外倍数 "awardType":"PRIZE" // PRIZE=奖品 , COUPON=优惠券 , POINT=积分 , REDPACKET=红包 }
activityItemBudgetVoList	预算列表	body	list	{ "budgetName":"微信红包预算", // 预算名称 "usedBudget":1.2, // 已使用预算 "consumeCost":0, // 已消耗成本 "remainBudget":1.2, //剩余预算 "type":"REDPACKET" // PRIZE=奖品 , COUPON=优惠券 , POINT=积分 , REDPACKET=红包， CUSTOM=自定义 }
appContentVoList	作品列表	body	list	{ "appId":"c3a8e5dc-185d-4ad8-ae38-ef64deedcb4e", //作品Id "orgId":"487aa4e1-cc06-4758-85e5-600705a05a94", //企业Id "userId":"9c36b6e7-8c4c-4d78-94a8-41aad63ded78",// 创建人Id "appName":"我的兔展作品", // 作品名称 "appDesc":"我用兔展做了一个超炫酷的H5,快来看看吧！", // 描述 "shortUrl":"FrWpVqdvTgF", // 短链 "appTags":[ "942476802029531136", //标签id "935542501048463360" ], "publish":1, // 是否发布；1 是；0否 "deleteFlag":0, //是否删除；1 是；0否, "contentPlayVoList":{ "componentId":135, "pluginName":"玩法001", "prizeInfoDtos":[ { "prizeId":"奖品Id", "interestId":"权益Id", "thirdAwardId":"第三方奖品Id", "awardName":"奖品名称", "awardLevel":"奖品等级", "awardNum":888 } ] } }

2) 异步返回调用工作台接口

接口地址 /api/integrate/callback/getMessage

请求方式 POST

consumes ["application/json"]

produces ["application/json"]

接口描述 企业级接口，hearer必须携带X-Token

入参说明

参数名称参数说明请求类型参数类型是否必须X-Token自建应用访问tokenheadertruetrue

msgId

消息Idbodylongtrueresult触达结果bodyinttruetimestamp时间戳，触达用户的时间bodylong

false

msg触达失败原因bodystringfalse

页面树结构

版本比较

旧版本 2

新版本当前版本

标识

页面树结构

页面历史记录

版本比较

旧版本 2

新版本 当前版本

标识

新版本当前版本