复制页面
卫瓴API文档
对接说明
全局异常码
一、获取访问凭据
1.1 获取访问凭据
GET
二、通讯录管理
2.1 获取部门列表
GET
2.2 获取员工列表
GET
2.3 获取员工详情
GET
2.4 根据条件获取员工详情
POST
2.5 获取员工ID列表
GET
2.6 批量获取员工信息
GET
三、企微好友管理
3.1 获取企微好友详情
GET
3.2 批量获取企微好友详情
POST
3.3 通过unionid查询卫瓴企微好友ID
GET
3.4 根据企微external_userid获取企微好友详情
GET
四、联系人🚀🚀🚀
4.1 联系人单条创建
POST
4.2 批量获取联系人详情
POST
4.3 联系人查询
GET
4.4 联系人编辑
POST
4.5 联系人转移
POST
4.6 联系人废弃
POST
4.7 联系人恢复
POST
4.8 联系人退回公海
POST
4.9 公海查询
GET
4.10 根据联络方式查询联系人
POST
五、企业管理🚀🚀🚀
5.1 获取企业列表(即将废弃)
GET
5.1 获取企业列表-新版
GET
5.2 获取企业详情
GET
5.2 获取企业详情-新版
GET
5.3 企业归属人变更
POST
5.4 创建企业
POST
5.5 企业更新
POST
5.6 添加企业外部相关人(即将废弃)
POST
5.6 企业外部相关人添加-新版
POST
5.7 移除企业外部相关人(即将废弃)
POST
5.7 企业外部相关人移除-新版
POST
5.8 添加企业内部协作人
POST
5.9 移除企业内部协作人
POST
5.10 企业公海信息查询
GET
5.11 批量获取企业详情(即将废弃)
POST
5.11 批量获取企业详情-新版
POST
六、智能码
6.1 创建智能码
七、三方ID转换
7.1 三方ID查询卫瓴ID
7.2 新增三方ID
7.3 卫瓴ID查询三方ID
八、跟进记录🚀🚀🚀
8.1 跟进记录创建(即将废弃)
8.2 跟进记录创建-新版
8.2 跟进记录查询(即将废弃)
8.2 跟进记录查询-新版
8.3 跟进记录废弃
8.4 跟进记录ID查询记录
九、旅程动态🚀🚀🚀
获取动态-(history_type)类型枚举
9.1 创建旅程(即将废弃)
9.1 创建旅程-新版
9.2 获取动态(即将废弃)
9.2 旅程查询-新版
十、商机🚀🚀🚀
10.1 获取商机详情(即将废弃)
10.1 商机详情-新版
10.2 商机阶段查询
10.3 商机创建(即将废弃)
10.3 商机新增-新版
10.4 商机更新
10.5 商机变更归属人
10.6 商机作废
10.7 商机外部对接人更新(即将废弃)
10.7 商机外部相关人更新-新版
10.8 商机内部协作人更新
10.9 商机流程&阶段查询
十一、资料库
11.1 资料库获取
11.2 资料访问明细
11.3 微信访客详情
十二、标签管理🚀🚀🚀
12.1 标签库查询
12.2 对象标签更新(即将废弃)
12.2 对象标签更新-新版
12.3 通过标签id查询对象(即将废弃)
12.3 通过标签id查询对象-新版
12.4 新建个人标签
十三、营销组件
13.1 营销组件获客信息查询
13.2 获取员工的营销组件列表
13.3 表单信息查询
13.4 表单填写内容查询
十四、消息推送
14.1 发送企微小微通知
十五、群相关
15.1 获取群列表接口
15.2 获取群详情接口
15.3 群更新接口
十六、对象描述🚀🚀🚀
16.1 获取对象描述接口(将近废弃)
16.1 获取对象描述接口-新版
十七、外呼相关
获取外呼记录详情
十八、个微人脉管理
18.1 获取个微人脉列表
18.2 查询个微人脉详情
十九、活动管理
19.1 活动列表
19.2 活动详情
19.3 活动报名详情
19.4 活动表单详情
二十、企微交互
⾃建应⽤好友id转换
事件回调🚀🚀🚀
事件回调概述
回调事件格式
回调事件类型目录
事件回调示例代码
联系人新增事件🚀
联系人更新事件🚀
手机号线索新增事件
手机号线索更新事件
手机号线索动态新增事件
企业新增事件(即将废弃)
企业新增事件-新版🚀
企业更新事件-新版🚀
企业更新事件(即将废弃)
企业删除事件
企业归属人变更事件
添加企业相关人事件
新版添加企业外部相关人事件
商机新增事件
商机更新事件
商机作废事件
群新增事件
群更新事件
群解散事件
员工新增事件
员工更新事件
部门新增事件
添加企微好友事件
企微好友更新事件
企微好友动态新增事件
跟进记录新增
资料新增事件
对象标签更新事件(即将废弃)
对象标签更新事件-新版🚀
内容留咨事件
活动报名新增事件
活动报名取消事件
活动报名修改事件
活动发布事件
活动表单新增事件
联系人合并
对接说明
复制页面
1.1 接口阅读说明
#
1.
所有的接口需使用HTTPS协议、JSON数据格式、UTF-8编码,POST请求请在HTTP Header中设置 Content-Type:application/json。
2.
访问域名:
https://openapi.weiling.cn
3.
openapi调用接口都有一定的频率限制,当超过此限制时,该企业下所有接口调用受限。每企业调用单个API不可超过500次/分,10000次/小时每ip调用单个API不可超过1000次/分,20000次/小时
4.
返回参数说明:
code:响应码,为0表示成功,非0表示调用失败
msg:响应文本,默认为success
data:具体响应内容
{
"code"
:
0
,
"msg"
:
"success"
,
"data"
:
{
}
}
1.2 对接信息获取
#
需要对接API的租户,管理员在
设置-开放平台
中,可以获得AppId、AppSecret。如有需要,在同一位置可以配置企业接口回调地址。
为了安全考虑,开发者请勿将access_token返回给前端,需要开发者保存在后台,所有访问卫瓴api的请求由后台发起
#
获取access_token是调用API接口的第一步,相当于创建了一个登录凭证,其它的业务API接口,都需要依赖于access_token来鉴权调用者身份。因此开发者,在使用业务接口前,要明确access_token的颁发来源,使用正确的access_token。
修改于
2026-03-27 07:01:27
下一页
全局异常码