企业内部开发 服务端API 客户联系 变更回调 概述
概述

目录

  • 关于接收客户变更事件
  • 设置接收事件服务器
  • 接收变更事件
  • 变更事件的格式
  • 关于接收客户变更事件

    企业可以通过获取成员的客户列表接口来获知成员添加了哪些客户,为了提高实时性,企业可设置外部联系人变更回调,成员添加和删除客户时将以事件的形式推送到指定URL,企业接收到外部联系人变更事件后,响应处理后即可保证获取到的企业客户列表是及时更新的列表。

    设置接收事件服务器

    在企业微信管理后台的“客户联系-客户”页面,点开“API”小按钮,再点击“接收事件服务器”配置,进入配置页面,要求填写URL、Token、EncodingAESKey三个参数。

    • URL是企业后台接收企业微信推送请求的访问协议和地址,支持http或https协议(建议使用https)。
    • Token可由企业任意填写,用于生成签名。
    • EncodingAESKey用于消息体的加密,是AES密钥的Base64编码。

    这三个参数的用处在加解密方案说明章节会详细介绍,此处暂不展开。

    当点击“保存”提交以上信息时,企业微信会发送一条验证消息到填写的URL,以验证URL的有效性。具体请参见“验证URL有效性”。

     

    接收变更事件

    接收外部联系人变更事件,实现方法与接收应用消息是一样的,请开发者仔细阅读“接收应用消息的说明”。
    注意,如配置了“可调用应用”列表并且相关应用设置了API接收消息,则相关事件也会回调给此应用(相关成员需要在应用可见范围内)。

    变更事件的格式

    当开发者完成了接收消息与事件的开发,将企业微信回调的事件解密后,可以得到具体的变更事件。请开发者仔细阅读“事件格式”。

    上一篇
    获取「群聊数据统计」数据
    下一篇
    事件格式