企业可通过此接口修改指定用户添加的客户的备注信息。
请求方式: POST(HTTP)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/remark?access_token=ACCESS_TOKEN
请求示例
{
"userid":"zhangsan",
"external_userid":"woAJ2GCAAAd1asdasdjO4wKmE8Aabj9AAA",
"remark":"备注信息",
"description":"描述信息",
"remark_company":"腾讯科技",
"remark_mobiles":[
"13800000001",
"13800000002"
],
"remark_pic_mediaid":"MEDIAID"
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
userid | 是 | 企业成员的userid |
external_userid | 是 | 外部联系人userid |
remark | 否 | 此用户对外部联系人的备注,最多20个字符 |
description | 否 | 此用户对外部联系人的描述,最多150个字符 |
remark_company | 否 | 此用户对外部联系人备注的所属公司名称,最多20个字符 |
remark_mobiles | 否 | 此用户对外部联系人备注的手机号 |
remark_pic_mediaid | 否 | 备注图片的mediaid, |
remark_company只在此外部联系人为微信用户时有效。
remark,description,remark_company,remark_mobiles和remark_pic_mediaid不可同时为空。
如果填写了remark_mobiles,将会覆盖旧的备注手机号。
如果要清除所有备注手机号,请在remark_mobiles填写一个空字符串("")。
remark_pic_mediaid可以通过素材管理接口获得。
权限说明:
调用接口的应用需要满足如下的权限:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「客户联系 可调用接口的应用」中 |
代开发应用 | 具有「客户基础信息」权限 |
第三方应用 | 具有「客户基础信息」权限 |
应用仅可编辑可见范围内的成员添加的企业客户备注信息。
返回结果:
{
"errcode": 0,
"errmsg": "ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |