Bes_Open_API
  1. 企业微信
Bes_Open_API
  • 开发指南
    • 产品概述
    • 通用项&参数说明
    • 更新日志
  • 鉴权模块（新）
    • openapi-获取token
      POST
  • 线索
    • 市场线索列表V2
      POST
    • 新增/编辑线索
      POST
    • 删除线索
      POST
    • 获取备注列表
      POST
    • 获取线索详情
      POST
    • 新增跟进记录
      POST
    • 获取线索行为事件
      POST
    • 获取线索行为记录
      POST
    • 获取线索分值记录
      POST
    • 市场线索-变更归属人
      POST
    • 批量获取线索分值记录
      POST
    • 表单管理列表
      POST
    • 表单提交数据列表
      POST
    • 获取线索来源
      POST
    • 获取接口数据处理状态(API接口数据)
      POST
  • 标签
    • 标签管理-分组列表
      POST
    • 标签管理-分组创建
      POST
    • 标签管理-分组编辑/删除
      POST
    • 标签管理-标签列表
      POST
    • 标签管理-标签创建
      POST
    • 标签管理-标签/编辑/移动
      POST
    • 对象打标签&移除标签
      POST
    • 获取对象和对象标签（对象ID必传）
      POST
    • 获取对象所有打标签流水（打标签时间倒序）
      POST
  • 分组
    • 分组列表
    • 分组下用户列表
    • 获取对象列表
    • 市场线索移入/移出分组
  • 公司
    • 公司列表V2
    • 公司编辑(单字段)
    • 公司创建
    • 获取公司详情
  • 扩展对象（业务机会等）
    • 对象列表
    • 新增/编辑对象
    • 删除对象
    • 记录类型-全部列表
    • 记录类型-根据当前账号权限返回可以的列表
  • 表结构
    • 表结构列表
    • 表结构详情
  • 潜在客户
    • 新增/编辑客群数据（仅支持外部数据源）
    • 获取客群对象列表（微信/外部数据源/企微外部联系人）
    • 获取客群列表数据-V2（企微外部联系人，外部数据源、留资客户、访客、潜在客户）
    • 客群字段列表（外部数据源）
  • 行为（新）
    • 新增应用
    • 获取应用
    • 添加事件
    • 获取事件
    • 添加事件属性
    • 获取事件属性
    • 添加属性选项值
    • 添加用户行为
    • 事件关联事件属性
    • 获取所有自定义事件属性
    • 获取浏览访客行为记录
  • 应用中心
    • 公众号管理
      • 获取微信授权链接
      • 根据微信code获取粉丝信息
      • 根据open_id,批量获取粉丝信息
      • 获取微信公众号列表
      • 获取粉丝信息
      • 获取取关粉丝信息
  • 系统管理
    • 获取某个用户信息
    • 获取组织信息
    • 自定义渠道-渠道列表
    • 获取管理员列表
    • 删除管理员
    • 启信宝-模糊查询公司名称
  • 资料下载
    • 资料下载-列表
  • 会议管理
    • 会议管理-列表数据
    • 会议管理-获取报名数据
    • 会议管理-获取签到参会数据
    • 获取分类列表（支持会议管理&资料下载）
    • 会议管理-会议报名
    • 会议管理-会议签到
    • 会议管理-获取会议详情
  • 内容中心
    • 获取内容分类
    • 获取内容列表
    • 获取内容详情
  • 会员管理
    • 会员管理-获取基础信息
    • 会员管理-获取自定义字段
    • 会员管理-变更积分
    • 根据会员id或会员手机号获取会员详细信息
    • 会员/员工(注册/更新)
    • 根据地区名称查询地区id
    • 获取会员/员工列表
    • 根据openid获取会员/员工信息
    • 会员管理-删除会员
  • 企业微信
    • 绑定外部联系人手机&邮箱&unionid
      POST
    • 修改外部联系人首要提醒人
      POST
    • 查询线索关联的外部联系人
      POST
    • 查询外部联系人关联的线索
      POST
    • 获取外部联系人基础信息
      POST
    • 编辑企微客户对象数据
      POST
  • 其他
    • 错误码
  • 自动化工作流
    • 关闭工作流
    • 工作流列表
  1. 企业微信

获取外部联系人基础信息

测试中
POST
/leads/open-api/contact-list
最后修改时间：2025-07-22 02:32:20

接口描述#

获取外部联系人基本信息（id,名称）
接口返回 code=0 表示获取成功，msg里为详细信息，code非0 表示接口调用失败

请求参数说明#

通用参数 access_token （使用 鉴权模块-获取token接口 获取）

返回码说明#

参数名称说明
0成功

请求参数

Query 参数
access_token
string 
可选
示例值:
{{access_token}}
Body 参数application/json
contact_id
string 
外部联系人id
必需
wx_external_userid
string 
外部联系人企微id
必需
page
integer 
必需
page_size
integer 
必需
示例
{
    "contact_id": "",
    "wx_external_userid": "",
    "page": 1,
    "page_size": 20
}

示例代码

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 'https://openapi.beschannels.com/leads/open-api/contact-list?access_token=uURA1lnYsBr22I6UYoLZH0s9y3HU2Xsn7UHA4dIDgHN_67Z5EZskh4YMcymD5enS4GGjWpOERwQtug3Y4AGwvbvLB_A3TwKBpb_J4z0MUm6oaNQmqA-3Ef9Q-PHbVPk3' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contact_id": "",
    "wx_external_userid": "",
    "page": 1,
    "page_size": 20
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
msg
string 
必需
data
array [object {8}] 
必需
id
integer 
外部联系人自增id
必需
wx_external_userid
string 
外部联系人企微id
必需
name
string 
昵称
必需
WeComExternalContactMobile
string 
关联手机号
必需
email
string 
关联邮箱
必需
open_id
string 
关联open_id
必需
unionid
string 
关联unionid
必需
user_owner
array [object {3}] 
添加人
必需
示例
{
    "code": 0,
    "msg": "成功",
    "data": [
        {
            "id": 145869,
            "wx_external_userid": "wm2myABgAAkLFmGdgeSEzmUQYdUHOLuw",
            "name": "風の恋",
            "WeComExternalContactMobile": "",
            "email": "",
            "open_id": "",
            "unionid": "",
            "user_owner": [
                {
                    "id": 6352,
                    "employee_user_id": "wo2myABgAA9gdgFKRYYkIL6TP5eEraxQ",
                    "name": "王凤建"
                }
            ]
        },
        {
            "id": 145868,
            "wx_external_userid": "wm2myABgAANkW2JTkZnH0U5tBRT1vuaA",
            "name": "倔强",
            "WeComExternalContactMobile": "12344444444",
            "email": "111@qq.com",
            "open_id": "",
            "unionid": "",
            "user_owner": [
                {
                    "id": 6333,
                    "employee_user_id": "wo2myABgAAuZ7mU7CD28WwVkrwAIDarg",
                    "name": "陈松华"
                }
            ]
        },
        {
            "id": 145863,
            "wx_external_userid": "wm2myABgAAI_fynCXGePlKbw-xjrf2-Q",
            "name": "浵彤💞",
            "WeComExternalContactMobile": "",
            "email": "",
            "open_id": "",
            "unionid": "",
            "user_owner": [
                {
                    "id": 6337,
                    "employee_user_id": "wo2myABgAA13H05SKTbL22WYaLLSTuYw",
                    "name": "王彩燕"
                }
            ]
        }
    ]
}
修改于 2025-07-22 02:32:20
上一页
查询外部联系人关联的线索
下一页
编辑企微客户对象数据
Built with