3.2 获取企微好友详情
GET
https://openapi.weiling.cn/openapi/customer/get请求参数
Query 参数
access_token
string
调用接口凭证
customer_id
string
企微好友id
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
必需
msg
string
必需
data
object
必需
customer_id
string
必需
外部联系人的userid
external_userid
string
必需
企微的外部联系人id
name
string
外部联系人的名称
avatar
string
外部联系人头像
type
integer
必需
外部联系人的类型,1表示该外部联系人是微信用户,2表示该外部联系人是企业微信用户
gender
integer
可选
外部联系人性别 0-未知 1-男性 2-女性
position
string
可选
外部联系人的职位,如果外部企业或用户选择隐藏职位,则不返回
corp_name
string
可选
外部联系人所在企业的简称
corp_full_name
string
可选
外部联系人所在企业的主体名称(企微改版后同简称一致)
customer_stage
string
客户阶段
latest_progress_id
string
可选
最新一次跟进记录id
first_progress_time
number
可选
首次跟进时间(13位时间戳)
remark_mobiles
array[string]
可选
员工对此企微好友备注的手机号码,数组格式
lost_state
boolean
可选
企微好友是否流失, false未流失 true 已流失
unionid
string
可选
企微好友自建应用的union_id
follow_users
array [object {14}]
必需
员工同此企微好友的关系
company_list
array [object {2}]
可选
企微好友所在企业列表
business_list
array [object {2}]
商机列表
clue_list
array [object {1}]
关联线索列表
示例
{
"code": 0,
"msg": "ok",
"data": {
"customer_id": "ocjvujojkvbhyj",
"external_userid": "wmWAFzDwAA04t0V_f4jnJRkTQAQ",
"name": "张三",
"avatar": "",
"type": 1,
"gender": 1,
"position": "研发",
"corp_name": "上海卫瓴科技",
"corp_full_name": "",
"remark_mobiles": [],
"customer_stage": "xxx",
"latest_progress_id": "xxx",
"first_progress_time": 1629098403000,
"lost_state": 0,
"unionid": "xxxxxxxx",
"follow_users": [
{
"userid": "lkjcjvjkfjkljj",
"remark_corp_name": "",
"add_way": 1,
"description": "dsfafergreg",
"remark": "张三",
"lost_state": 1,
"add_source": {
"type": 1,
"id": "r8Q5kL9KeVBfGlkm664vRDL9vkWQUwx7cYRWfoEjL_k",
"name": "官网智能码"
},
"customer_custom_field": {},
"create_time": 1629098403000,
"tags": [
{
"group_id": "r8Q5kL9KeVBfGlkm664vRDL9vkWQUwx7cYRWfoEjL_k",
"group_name": "标签分组名称",
"tag_id": "etAJ2GCAAAXtWyujaWJHDDGi0mACHAAA",
"tag_name": "标签名称",
"type": 1
},
{
"group_id": "r8Q5kL9KeVBfGlkm664vRDL9vkWQUwx7cYRWfoEjL_k",
"group_name": "标签分组名称",
"tag_id": "etAJ2GCAAAXtWyujaJJJKLJKLii0mACHBVD",
"tag_name": "标签名称",
"type": 2
}
]
}
],
"company_list": [
{
"company_id": "sbpfPAn6Q5kxLWTvk29Gi88eywDHXMA9hmYqMxyCmlk",
"company_name": "北京同一人基业投资管理有限公司"
},
{
"company_id": "YeOrweB8SEOW1UAVa5o26fBfr85e0sIpYfyXQ_UtZDw",
"company_name": "上海如呀信息咨询中心"
},
{
"company_id": "YWZSC-sfQuJ6YnSKIhkgklrEDR1iRNXHm7kZwUXXfCk",
"company_name": "深圳市微领科技有限公司"
},
{
"company_id": "ugLA-FEUNn1DfYO9e3D0tRDmIvlo-pibhsv3XdstdK8",
"company_name": "宁波宇涵教育科技有限公司"
},
{
"company_id": "VcDV6cgIFZuUi-JdiO8SCGpLYJT23ytdAPtXYYV_B_E",
"company_name": "中国船舶集团有限公司"
}
]
}
}
最后修改时间: 10 个月前