设置企业号应用
来自企业号开发者接口文档
- 接口说明
该API用于设置企业应用的选项设置信息,如:地理位置上报等。第三方服务商不能调用该接口设置授权的主页型应用。
- 请求说明
Https请求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/agent/set?access_token=ACCESS_TOKEN
- 请求示例
{ "agentid": "5", "report_location_flag": "0", "logo_mediaid": "xxxxx", "name": "NAME", "description": "DESC", "redirect_domain": "xxxxxx", "isreportuser":0, "isreportenter":0, "home_url":"http://www.qq.com", "chat_extension_url":"http://www.qq.com" }
- 参数说明
参数 | 说明 |
---|---|
access_token | 调用接口凭证 |
agentid | 企业应用的id |
report_location_flag | 企业应用是否打开地理位置上报 0:不上报;1:进入会话上报;2:持续上报 |
logo_mediaid | 企业应用头像的mediaid,通过多媒体接口上传图片获得mediaid,上传后会自动裁剪成方形和圆形两个头像 |
name | 企业应用名称 |
description | 企业应用详情 |
redirect_domain | 企业应用可信域名 |
isreportuser | 是否接收用户变更通知。0:不接收;1:接收。 |
isreportenter | 是否上报用户进入应用事件。0:不接收;1:接收。 |
home_url | 主页型应用url。url必须以http或者https开头。消息型应用无需该参数 |
chat_extension_url | 关联会话url。设置该字段后,企业会话"+"号将出现该应用,点击应用可直接跳转到此url,支持jsapi向当前会话发送消息。 |
- 权限说明
管理组须拥有指定应用的配置权限。
- 返回说明
{ "errcode":"0", "errmsg":"ok" }