企业微信服务商开发(六)
服务商如何获得企业通讯录的编辑权限,这需要企业登录企业微信后台,在管理工具>通讯录
同步中设置。
权限设置
点击进入通讯录同步里可以看到如下页面:
在权限栏>选择API编辑通讯录
选项可通过API接口读取及编辑企业微信通讯录。
接收通讯录变更事件
关于接收通讯录变更事件
当企业通过API编辑通讯录时,通讯录默认只能通过API来编辑,无法直接在管理后台手动编辑。若企业需要同时在管理后台手动编辑通讯录,可在管理后台“管理工具-通讯录同步-权限”处开启手动编辑。
当管理员在管理后台手动编辑通讯录,或成员自行修改个人信息时,为保证手动编辑产生的通讯录变更能与API源数据同步,避免两边通讯录不一致,可设置通讯录变更回调,手动编辑的信息将以事件的形式推送到指定URL,企业接收到通讯录变更事件后,响应处理后即可保证两边通讯录同步。
设置接收事件服务器
在企业微信管理后台的“管理工具-通讯录同步-设置接收事件服务器”处,进入配置页面,要求填写通讯录同步助手的URL、Token、EncodingAESKey三个参数。
- URL是企业后台接收企业微信推送请求的访问协议和地址,支持http或https协议—-这个url由服务商提供。
- Token可由企业任意填写,用于生成签名
- EncodingAESKey用于消息体的加密,是AES密钥的Base64编码。
这三个参数的用处在加解密方案说明章节会详细介绍,此处暂不展开。
当点击“保存”提交以上信息时,企业微信会发送一条验证消息到填写的URL,以验证URL的有效性。具体请参见“验证URL有效性”。
此处的token
、aesKey
需要提供给服务商,在验证URL有有效性用得到。
接收通讯录变更事件
接收通讯录变更事件,实现方法与接收应用消息是一样的,请开发者仔细阅读“接收应用消息的说明”。
通讯录变更事件的格式
当开发者完成了接收消息与事件的开发,将企业微信回调的事件解密后,可以得到具体的通讯录变更事件。请开发者仔细阅读“事件格式之通讯录变更事件”。
由通讯录同步助手调用接口触发的变更事件不回调通讯录同步助手本身。
第三方通讯录应用的通讯录变更事件参见第三方回调协议
到此企业微信服务商开发基本完成,若有不明白的地方可以留言一起讨论,有不对的地方请指教。希望该系列文章对您有所帮助。
获取示例源码
请关注微信公众号:「特想学英语」并回复:企业微信
原文作者: dgb8901,yinxing
原文链接: https://www.itwork.club/2019/03/02/corp-develop-6/
版权声明: 转载请注明出处
为您推荐
体验小程序「简易记账」
关注公众号「特想学英语」