卫瓴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 活动报名详情
  • 事件回调🚀🚀🚀
    • 事件回调概述
    • 回调事件格式
    • 服务示例
    • 解密示例
    • 回调事件类型目录
    • 联系人新增事件🚀
    • 联系人更新事件🚀
    • 手机号线索新增事件
    • 手机号线索更新事件
    • 手机号线索动态新增事件
    • 企业新增事件(即将废弃)
    • 企业新增事件-新版🚀
    • 企业更新事件-新版🚀
    • 企业更新事件(即将废弃)
    • 企业删除事件
    • 企业归属人变更事件
    • 添加企业相关人事件
    • 新版添加企业外部相关人事件
    • 商机新增事件
    • 商机更新事件
    • 商机作废事件
    • 群新增事件
    • 群更新事件
    • 群解散事件
    • 员工新增事件
    • 员工更新事件
    • 部门新增事件
    • 添加企微好友事件
    • 企微好友更新事件
    • 企微好友动态新增事件
    • 跟进记录新增
    • 资料新增事件
    • 对象标签更新事件(即将废弃)
    • 对象标签更新事件-新版🚀
    • 发送客户朋友圈事件
  1. 事件回调🚀🚀🚀

联系人更新事件🚀

联系人更新时,推送该联系人更新后的基础信息

回调示例#

{
  "event": {
    "gender": 0,
    "status": 1,
    "owner_id": "Hf-otGwUPFeP5FkxmVwyVJ9Y7S_l653Hf6F2PgGIzvc",
    "is_repeat": false,
    "user_name": "suzumiya haruhi",
    "claim_time": 1745825244000,
    "contact_id": "eFrT6MMCNLiJ-4NkQm8AGlDq3whIUAbHhFT4XalQolU",
    "is_useless": false,
    "change_type": "change_content",
    "create_time": 1745825244000,
    "contact_ways": [
      {
        "type": 1,
        "contact_way": "10099999999"
      }
    ],
    "contact_source": {
      "type": 0
    },
    "create_user_id": "Hf-otGwUPFeP5FkxmVwyVJ9Y7S_l653Hf6F2PgGIzvc",
    "tag_group_list": [
      {
        "type": "1",
        "group_id": 1561576192748970000,
        "tag_info": [
          {
            "type": "1",
            "tag_id": 1676845747632406500,
            "tag_name": "报名表-001",
            "create_time": 1745825514000,
            "tag_user_id": 1906950685154865200
          }
        ],
        "group_name": "新标签组",
        "create_time": 1661143751000
      }
    ],
    "last_follow_time": 1745825514000,
    "from_channel_name": "其他-销售导入",
    "latest_progress_id": "1916757248634093568",
    "first_progress_time": 1745825514000
  },
  "header": {
    "to_app": "wloa00ca3a0adfab5aec8d145f3aef2994c2",
    "event_type": "contact_update",
    "time_stamp": "1745825514604"
  }
}

回调字段说明#

名称类型说明
» event回调事件具体内容
»» genderinteger性别
»» statusinteger状态
»» owner_idstring归属人
»» is_repeatboolean是否重复
»» user_namestring名称
»» claim_timenumber线索领取时间,13位时间戳,精确到秒
»» contact_idstring员工id
»» is_uselessboolean是否废弃
»» change_typestring变更内容
»» create_timenumber创建时间
»» contact_ways[object]联络方式
»»» typeinteger联络方式类型(1-手机号 2-座机 3-邮箱 4-注册加微)
»»» contact_waystring联络方式具体信息
»» contact_sourceobject来源
»»» typeinteger来源类型
»» create_user_idstring创建人
»» tag_group_list[object]线索标签列表
»»» typestring标签分组类型 1-企微企业,3-卫瓴个人标签分组
»»» group_idstring标签分组id
»»» tag_info[object]标签列表
»»»» typestring标签类型 1-企微企业,3-卫瓴个人标签
»»»» tag_idstring标签id
»»»» tag_namestring标签名称
»»»» create_timenumber标签创建时间
»»»» tag_user_idstring打标签人员工id
»»» group_namestring推广组
»»» create_timenumber标签组创建时间
»» last_follow_timenumber最新一条跟进时间,13位时间戳,精确到秒
»» from_channel_namestring渠道
»» latest_progress_idstring最新一条跟进记录id
»» first_progress_timenumber首次填写跟进记录时间,13位时间戳,精确到秒
» header回调参数头
»» to_appstring回调应用的appid
»» event_typestring事件类型
»» time_stamplong回调时间,13位时间戳,精确到毫秒
上一页
联系人新增事件🚀
下一页
手机号线索新增事件
Built with