卫瓴API文档
  1. 事件回调🚀🚀🚀
卫瓴API文档
  • 对接说明
  • 全局异常码
  • 联系人合并接口迁移说明
  • 一、获取访问凭据
    • 1.1 获取访问凭据
  • 二、通讯录管理
    • 2.1 获取部门列表
    • 2.2 获取员工列表
    • 2.3 获取员工详情
    • 2.4 根据条件获取员工详情
    • 2.5 获取员工ID列表
    • 2.6 批量获取员工信息
  • 三、企微好友管理🚀🚀🚀
    • 3.1 获取企微好友列表
    • 3.2 获取企微好友详情
    • 3.4 根据企微external_userid获取企微好友详情
    • 3.5 通过unionid查询卫瓴企微好友ID
    • 3.3 企微好友更新（即将废弃）
    • 3.6 批量获取企微好友详情
  • 四、线索管理（即将废弃）
    • 4.1 创建手机号线索
    • 4.2 获取手机号线索列表
    • 4.3 获取手机号线索详情
    • 4.4 公海信息查询
    • 4.5 手机号线索转移接口
    • 4.6 手机号线索废弃
    • 4.7 手机号线索更新
    • 4.8 手机号线索退回公海
    • 4.9 手机号线索恢复
  • 五、企业管理🚀🚀🚀
    • 5.1 获取企业列表（即将废弃）
    • 5.1 获取企业列表-新版
    • 5.2 获取企业详情
    • 5.2 获取企业详情-新版
    • 5.3 企业归属人变更
    • 5.4 创建企业
    • 5.5 企业更新
    • 5.6 添加企业外部相关人（即将废弃）
    • 5.6 企业外部相关人添加-新版
    • 5.7 移除企业外部相关人（即将废弃）
    • 5.7 企业外部相关人移除-新版
    • 5.8 添加企业内部协作人
    • 5.9 移除企业内部协作人
    • 5.10 企业公海信息查询
    • 5.11 批量获取企业详情（即将废弃）
    • 5.11 批量获取企业详情-新版
  • 六、智能码
    • 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查询对象-新版
  • 十三、营销组件
    • 13.1 营销组件获客信息查询
    • 13.2 获取员工的营销组件列表
    • 13.3 表单信息查询
  • 十四、消息推送
    • 14.1 发送企微小微通知
  • 十五、群相关
    • 15.1 获取群列表接口
    • 15.2 获取群详情接口
    • 15.3 群更新接口
  • 十六、自定义字段🚀🚀🚀
    • 16.1 获取对象描述接口（将近废弃）
    • 16.1 获取对象描述接口-新版
  • 十七、外呼相关
    • 获取外呼记录详情
  • 十八、个微人脉管理
    • 18.1 获取个微人脉列表
    • 18.2 查询个微人脉详情
  • 十九、联系人🚀🚀🚀
    • 19.1 联系人创建
    • 19.2 联系人批量详情
    • 19.3 联系人查询
    • 19.4 联系人编辑
    • 19.5 联系人转移
    • 19.6 联系人废弃
    • 19.7 联系人恢复
    • 19.8 联系人退回公海
    • 19.9 联系人公海列表
  • 二十、活动管理
    • 20.1 活动列表
    • 20.2 活动详情
    • 20.3 活动报名详情
  • 事件回调🚀🚀🚀
    • 事件回调概述
    • 回调事件格式
    • 回调事件类型目录
    • 服务示例
    • 解密示例
    • 员工新增、更新事件
      POST
    • 添加企微好友事件
      POST
    • 企微好友更新事件
      POST
    • 企微好友动态新增事件
      POST
    • 手机号线索动态新增事件
      POST
    • 手机号线索新增事件
      POST
    • 手机号线索更新事件
      POST
    • 跟进记录新增
      POST
    • 企业新增事件（即将废弃）
      POST
    • 企业新增事件-新版🚀
      POST
    • 企业更新事件（即将废弃）
      POST
    • 企业更新事件-新版🚀
      POST
    • 添加企业相关人事件
      POST
    • 新版添加企业外部相关人回调
      POST
    • 商机新增事件
      POST
    • 商机更新事件
      POST
    • 商机作废事件
      POST
    • 资料新增事件
      POST
    • 群新增事件
      POST
    • 群更新事件
      POST
    • 群解散事件
      POST
    • 对象标签更新事件（即将废弃）
      POST
    • 对象标签更新事件-新版🚀
      POST
    • 发送客户朋友圈事件
      POST
    • 部门新增事件
      POST
    • 企业删除事件
      POST
    • 企业归属人变更事件
      POST
    • 联系人新增事件🚀
      POST
    • 联系人更新事件🚀
      POST
  1. 事件回调🚀🚀🚀

员工新增、更新事件

POST
{{接收回调的地址}}

请求参数

Body 参数application/json
userid
string 
员工id
可选
name
string 
员工姓名
可选
mobile
string 
手机号
可选
position
string 
职位
可选
gender
integer 
可选
性别： 0-未选择 1-男 2-女
email
string 
邮箱
可选
avatar
string 
头像url
可选
telephone
string 
座机
可选
alias
string 
别名
可选
status
integer 
可选
状态：1=已激活，2=已禁用，4-未激活，5=退出企业
saas_status
integer 
可选
saas平台状态 0-禁用 1-正常
示例
{
  "userid": "53",
  "name": "式着节列意因",
  "alias": "aliqua magna",
  "telephone": "18154448251",
  "position": "commodo ea",
  "saas_status": 13,
  "email": "c.eyvfq@qq.com",
  "mobile": "18172742631",
  "gender": 85,
  "status": 36,
  "avatar": "http://dummyimage.com/100x100"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{接收回调的地址}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "53",
    "name": "式着节列意因",
    "alias": "aliqua magna",
    "telephone": "18154448251",
    "position": "commodo ea",
    "saas_status": 13,
    "email": "c.eyvfq@qq.com",
    "mobile": "18172742631",
    "gender": 85,
    "status": 36,
    "avatar": "http://dummyimage.com/100x100"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
    "header": {
        "event_type": "user_update", // 新增为user_insert
        "time_stamp": "1611580672000",
        "to_app": "wloa4376fe67dc041d474a79513ed70ae3db"
    },
    "event": {
        "userid": "suyore",
        "name": "张三",
        "mobile": "15517101234",
        "position": "",
        "gender": 1,
        "email": "abc@gmail.com",
        "avatar": "http://xxx.jpg",
        "telephone": "",
        "alias": "",
        "status": 1,
        "saas_status": 1
    }
}
修改于 2022-10-19 11:26:25
上一页
解密示例
下一页
添加企微好友事件
Built with