获取联系人列表

最后更新：2025/04/17

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/crm3/contact/page

Query参数：

参数	类型	必填	说明
access_token	string	是	调用接口凭证

Body参数：

{
  "contact_name": "",
  "owner_ids": ["wovvCXcAAAXio3fEwulPCVHqUnRlT5iw"],
  "create_start_time": 1638785104,
  "create_end_time": 1638785104,
  "company_phases": [],
  "company_levels": [],
  "tag_ids": [],
  "access_customer_channel": [],
  "mobile_phone": "",
  "email": "",
  "external_user_ids": [],
  "field_map": {},
  "current_index": 1,
  "page_size": 10
}

参数	类型	必填	说明
contact_name	string	否	联系人名称
owner_ids	string[]	否	负责人ID
create_start_time	long	否	联系人创建起始时间（单位：秒）
create_end_time	long	否	联系人创建结束时间（单位：秒）
tag_ids	string[]	否	标签ID
access_customer_channel	string[]	否	获客渠道筛选,多选ID集
mobile_phone	string	否	手机号码
email	string	否	邮箱
external_user_ids	string[]	否	客户ID集
field_map	map	否	自定义字段筛选
current_index	int	是	页码。默认值为1
page_size	int	是	列表返回长度。默认值为20，最大值为100

返回值：


{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 1,
    "records": [
       {
         "contact_id": 1631517114528779266,
         "contact_name": "联系人名称",
         "uin_contact_id": "",
         "corp_tag_ids": [],
         "business_tag_ids": [],
         "company_id": 1531517114528779266,
         "external_user_id": "",
         "mobile_phone": "",
         "access_customer_channel": [
           {
             "name": "渠道1",
             "id": "1831517114528779266"
           }
         ],
         "remark": "",
         "owner_id": "wovvCXcAAAXio3fEwulPCVHqUnRlT5iw",
         "create_user_id": "wovvCXcAAAXio3fEwulPCVHqUnRlT5iw",
         "create_time": 1638785104,
         "last_follow_time": 1638785104,
         "last_follow": "",
         "relate_customer_time": null,
         "add_friend_status": 0,
         "owner_change_time": 1653993589
      }
    ]
  }
}

参数说明：

参数	类型	说明
code	int	返回码
msg	string	对返回码的文本描述内容
data	obj
total	int	商机数量
record	obj[]	结果集
contact_id	long	联系人ID
contact_name	string	联系人名称
uin_contact_id	string	第三方联系人ID
corp_tag_ids	string[]	企业标签ID
business_tag_ids	string[]	业务标签ID
company_id	long	企业ID
external_user_id	string	企微客户ID
mobile_phone	string	手机号
access_customer_channel	object[]	渠道
name	string	渠道名称
id	string	渠道自定义ID
remark	string	备注
owner_id	string	负责人ID
create_user_id	string	创建人
create_time	long	联系人创建时间
last_follow_time	long	联系人最后跟进时间
last_follow	string	联系人最后跟进内容
owner_change_time	long	负责人变更时间
field_map	map	自定义字段

获取联系人列表

获取联系人列表

results matching ""

No results matching ""