3.2 获取企微好友详情

请求参数

Query 参数

access_token

string

调用接口凭证

必需

customer_id

string

企微好友id

必需

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

返回响应

🟢200成功

application/json

Body

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": "中国船舶集团有限公司"
      }
    ]
  }
}