修改客户备注信息

POST

http://127.0.0.1/cgi-bin/externalcontact/get

第三方应用开发/客户联系/客户管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

企业可通过此接口修改指定用户添加的客户的备注信息。

remark_company只在此外部联系人为微信用户时有效。
remark，description，remark_company，remark_mobiles和remark_pic_mediaid不可同时为空。
如果填写了remark_mobiles，将会覆盖旧的备注手机号。
如果要清除所有备注手机号,请在remark_mobiles填写一个空字符串(“”)。
remark_pic_mediaid可以通过素材管理接口获得。

权限说明:

企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。
第三方应用需具有“企业客户权限->客户基础信息”权限

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

{accesstoken}}

external_userid

string

必需

外部联系人的userid，注意不是企业成员的帐号

示例值:

cursor

string

可选

上次请求返回的next_cursor

示例值:

Body 参数application/json

userid

string

必需

企业成员的userid

external_userid

string

必需

外部联系人userid

remark

string

可选

此用户对外部联系人的备注，最多20个字符

description

string

可选

此用户对外部联系人的描述，最多150个字符

remark_company

string

可选

此用户对外部联系人备注的所属公司名称，最多20个字符

remark_mobiles

array[string]

可选

此用户对外部联系人备注的手机号

remark_pic_mediaid

string

可选

备注图片的mediaid，

示例

{
  "userid": "zhangsan",
  "external_userid": "woAJ2GCAAAd1asdasdjO4wKmE8Aabj9AAA",
  "remark": "备注信息",
  "description": "描述信息",
  "remark_company": "腾讯科技",
  "remark_mobiles": [
    "13800000001",
    "13800000002"
  ],
  "remark_pic_mediaid": "MEDIAID"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/externalcontact/get?access_token={accesstoken}}&external_userid={{EXTERNAL_USERID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "zhangsan",
    "external_userid": "woAJ2GCAAAd1asdasdjO4wKmE8Aabj9AAA",
    "remark": "备注信息",
    "description": "描述信息",
    "remark_company": "腾讯科技",
    "remark_mobiles": [
        "13800000001",
        "13800000002"
    ],
    "remark_pic_mediaid": "MEDIAID"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

可选

errmsg

string

可选

示例

{
  "errcode": 0,
  "errmsg": "string"
}

修改于 2022-08-30 03:03:36

获取客户列表

批量获取客户详情