微信企业号开发--企业微信资料整理

微信企业号资料整理

目前(20180105)企业号已经有腾讯公司升级成企业微信这个单独的app应用;
但是可以通过企业微信后台的管理操作中的微信插件来关联微信和企业微信；

1.接口网站

http://qydev.weixin.qq.com/wiki/index.php?title=首页
http://qydev.weixin.qq.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5

2.市场定位

为企业用户提供的移动应用入口：微信企业号的市场定位包含两层意思，一是面向企业用户；二是提供移动应用入口，其中移动应用入口也暗示了微信不为企业提供深度的行业应用，而是以微信为入口。

3.产品定位

广泛并有效的连接：帮助企业、政府机关、学校、医院等事业单位和非政府组织建立与员工、上下游合作伙伴及内部IT系统间的连接，并能有效地简化管理流程、提高信息的沟通和协同效率、提升对一线员工的服务及管理能力。

4.功能特点

对于企业号，有以下一些特点：
–只有企业通讯录的成员才能关注企业号，分级管理员、保密消息等各种特性确保企业内部信息的安全[3] 。
应用可配置[4]
–企业可自行在企业号中配置多个服务号，可以连接不同的企业应用系统，只有授权的企业成员才能使用相应的服务号。
消息无限制
–发送消息无限制，并提供完善的管理接口及微信原生能力，以适应企业复杂、个性化的应用场景。
使用更便捷
–企业号在微信中有统一的消息入口，用户可以更方便地管理企业号消息。微信通讯录也可以直接访问企业号中的应用。

5.使用场景

对于企业号使用的场景，微信企业号有“四个适宜”：

适宜于办公室员工出差在外的移动办公应用场景。
适宜于企业与上下游合作伙伴、供应商的订单管理、工作协同。
适宜于以移动办公为主场景的一线员工，如一线销售、行销代理、售后服务、巡检巡店、安保后勤等人员的工作管理与支撑
适宜于政府机关、学校医院等事业单位，以及社会组织同样可以通过企业号简化管理流程，提高信息发布与触及的效率，提升组织协同运作效率。

此外，企业号可以建立企业任何内部IT 系统或硬件物理设备与员工微信的连接，实现企业系统的移动化的同时，实现端到端的流程闭环。以前，传统IT 很难做到的，如今，基于微信，利用企业号，一切皆有可能。

6.微信企业号与服务号的区别

企业号是微信为企业客户提供的移动应用入口，它主要帮助企业、政府事业单位及组织实现生产、协作及运营的移动化。它提供了一系列新的能力和特性以满足企业灵活、复杂以及高安全性的要求：如应用可定制、仅通讯录成员能关注、无限制的主动群发消息，开放且权限控制的接口，保密消息，应用快速部署、消息提醒更精确等

7.如何开通

企业号的注册流程跟订阅号/服务号一致，在公众平台官网注册帐号、登记信息即可开通。需要提供运营者的身份证明、企业的营业执照或组织机构代码证、及运营授权等信息。企业、政府及事业单位、社会化组织均可申请。具体分为四步：

企业到微信官网申请开通；
开通后，企业在企业号管理后台导入成员，发布二维码；
企业调用企业号api 与企业自有系统对接开发；

员工关注并使用。

8.接口文档中的特别提醒

开发对接相关接口： 开发测试应用，对接企业号接口，接口文档qydev.weixin.qq.com

如果你在开发对接自己的企业号、或在定制化开发对接客户的企业号，那么你不需要关心SaaS套件接口；（我们主要的目的是给企业号推送告警信息，所以用不到sass套件接口）

9 接口的主动调用

主动调用（其意义是主动推送信息到企业号，即发送各种信息到企业号中）

主动调用是最基本的连接模式，当你的应用调用企业号时，需使用Https协议、Json数据格式、UTF8编码，访问域名为https://qyapi.weixin.qq.com，数据包不需要加密。

在每次主动调用企业号接口时需要带上AccessToken参数。AccessToken参数由CorpID和Secret换取。

CorpID是企业号的标识，每个企业号拥有一个唯一的CorpID；Secret是管理组凭证密钥。

系统管理员可通过管理端的权限管理功能创建管理组，分配管理组对应用、通讯录的访问权限。完成后，管理组即可获得唯一的secret。系统管理员可通过权限管理查看所有管理组的secret，其他管理员可通过设置中的开发者凭据查看。

当企业应用调用企业号接口时，企业号后台为根据此次访问的AccessToken,校验访问的合法性以及所对应的管理组的管理权限以返回相应的结果。

注：你应该审慎配置管理组的权限，够用即好，权限过大会增加误操作可能性及信息安全隐患。
获取AccessToken

AccessToken是企业号的全局唯一票据，调用接口时需携带AccessToken。

AccessToken需要用CorpID和Secret来换取，不同的Secret会返回不同的AccessToken。正常情况下AccessToken有效期为7200秒，有效期内重复获取返回相同结果。access_token至少保留512字节的存储空间。企业号可能会出于运营需要，提前使accesstoken失效，企业开发者也应实现accesstoken失效时重试获取的逻辑。

请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect

参数说明

参数 必须 说明
corpid 是 企业Id
corpsecret 是 管理组的凭证密钥

权限说明

每个secret代表了对应用、通讯录的不同权限；不同的管理组拥有不同的secret。

返回说明

a)正确的Json返回结果:

{
“access_token”: “accesstoken000001”,
“expires_in”: 7200
}

参数 说明
access_token 获取到的凭证。长度为64至512个字节
expires_in 凭证的有效时间（秒）

注：企业号融合过程中该接口输出参数可能略有不同，以下情况均视作获取token成功：

1、能获取到access_token，接口无返回errcode

2、能获取到access_token，接口返回errcode为0， errmsg为空或者”ok”

b)错误的Json返回示例:

{
“errcode”: 43003,
“errmsg”: “require https”
}

主动调用的频率限制

当你获取到AccessToken时，你的应用就可以成功调用企业号后台所提供的各种接口以管理或访问企业号后台的资源或给企业号成员发消息。

为了防止企业应用的程序错误而引发企业号服务器负载异常，默认情况下，每个企业号调用接口都有一定的频率限制，当超过此限制时，调用对应接口会收到相应错误码。

以下是当前默认的频率限制，企业号后台可能会根据运营情况调整此阈值：

基础频率

每企业调用单个cgi/api不可超过1000次/分，30000次/小时

每企业调用接口的并发数不可超过300

企业每ip调用接口不可超过20000次/分，600000次/小时

第三方应用提供商每ip调用接口不可超过40000次/分，1200000次/小时

发消息频率

每企业不可超过帐号上限数*30人次/天，发消息频率不计入基础频率

创建帐号频率

每企业创建帐号数不可超过帐号上限数*3/月

创建应用频率

每企业最大应用数限制为30个，创建应用次数不可超过30*3/月

创建群聊频率

每个企业成员（群的创建者）创建群聊个数不可超过500/天

发会话消息频率

每个企业成员发送的会话消息条数不可超过100/分

*以上所有频率，按天拦截则被屏蔽一天（自然天），按月拦截则屏蔽一个月（30天，非自然月），按分钟拦截则被屏蔽60秒，按小时拦截则被屏蔽60分钟。

注：身份验证接口的”根据code获取成员信息/user/getuserinfo”，若code合法则不受上述频率限制。

10 回调模式

回调模式注
1.随机数字串(nonce)，长度值范围是[0, 2^32)
2.获取请求中的字符串使用，request.getParameter(“xxxx”),不要使用接收请求参数整体request.getQueryString()之后自己做处理；

自定义菜单

企业号的每个消息型应用都可以拥有自己的菜单，企业可以调用接口来创建、删除、获取应用菜单。
在操作应用的菜单时，应用必须处于回调模式；菜单最多为两级，一级菜单最多为3个，二级菜单最多为5个。
创建应用菜单
目前自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多8个汉字，多出来的部分将会以“…”代替。请注意，创建自定义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注企业号后再次关注，则可以看到创建后的效果。
请注意，除click和view外所有事件，仅支持微信iPhone5.4.1/Android5.4以上版本，旧版本微信成员点击后将没有回应，开发者也不能正常接收到事件推送。
企业号通讯录具备完全开放的接口，你的应用可以调用这些接口管理部门、成员和标签。
你的应用也可以使用部门、成员、标签发消息，或更改应用的可见范围。
注意，部门的最大层级为15层；部门总数不能超过3万个；每个部门下的节点不能超过3万个。标签总数不能超过3000个；每个标签下的节点不能超过3万个。

11 企业认证

认证前人数最多只支持1000人，认证后可提高企业的使用人数。不同认证方式对应的具体人数不同，如下：
1）全新认证：
填写人数后需要提交相应的人数证明材料，之后由第三方审核公司进行审核，审核通过后人数满足企业的实际需要。
2）已是企业号认证：
企业微信将同步对应企业号的人数上限。
3）已是订阅号、服务号认证：
1000人以下不需要提交人数证明；1000人以上需要提交人数证明；
2、后续可使用更多功能，提高企业运作效率

12 域名

设置可信域名频率
每企业设置的可信域名数不可超过20/月

域名会用到：身份验证接口及jssdk
如果只是发送消息或者接收消息时，也可以配置ip；

13 企业认证差别

未认证的企业号，除了支付及发票接口会受到认证限制，人数上限达1000人，其他的没有限制；