1.1 接口说明

第三方系统调用此接口编辑客户信息。

1.2 调用形式

https://ykf.uincall.com/openapi/customer/update?tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx&access_token=5526f0d1a30626b3bd2c9298fa2xxxxx

1.3 调用方式

PUT

1.4 传入参数

非必填参数，调用接口时请传递参数名，参数值可为空

序号 名称 类型 是否必填 说明
1 id String 是 更新客户的Id
2 agent_num String 否 归属座席编号
3 truename String 是 客户姓名 （最大值100）
4 nickname String 否 呢称信息 （最大值20）
5 level_title String 否 客户状态
6 mobile String 否 手机 （最大值20）
7 mobileDesc String 否 手机备注 （最大值20）
8 mail String 否 邮箱 （最大值100）
9 mailDesc String 否 邮箱备注 （最大值20）
10 wechat String 否 微信 （最大值20）
11 wechatDesc String 否 微信备注 （最大值20）
12 province String 否 省 （最大值20）
13 city String 否 市 （最大值20）
14 district String 否 区 （最大值20）
15 address String 否 地址 （最大值100）
16 summary String 否 备注 （最大值200）
17 source_title String 否 数据来源
18 tracker_id String 否 关联访客ID （最大值130）
19 attachments JSONObject 否 附件
20 website String 否 网站 （最大值100）
21 customer_fields JSONObject 否 自定义字段
1.自定义多行文本换行用\n
2.跟字典相关的字段传字典选项id，字典选项id通过7.1字典数据查询接口获取，查询租户已启用自定义字段（kind=4，下拉列表为关联字典查场景demo，参考6.12 查询客户自定义字段报文样例；
(1)、此种场景请确认value数组中各id值为字典正确顺序，若传入id与实际字典id不匹配或id顺序不匹配，则该自定义字段值如入库；例如{“name”: “下拉框-多级字典”,”value”: [“208e64bd96e9491ca8b92c0de6f7543b”,”f88baa61acf44829aa14b0f16444fb2c”,”d5ac5c75eab24f0a9740fc8a8c184277”]}

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Number 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明

1.6 使用样例

调用：

url：https://ykf.uincall.com/openapi/customer/update?tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx&access_token=5526f0d1a30626b3bd2c9298fa2xxxxx

PUT数据：

{
"id": "f42800bac835d587e2ae0b71XXXXXXXX",
    "agent_num": "1006",
    "truename": "以逸待劳",
    "nickname": "以逸待劳",
    "level_title": "",
    "mobile": "19000000000",
    "mobileDesc": "",
    "mail": "11@11.com",
    "mailDesc": "",
    "wechat": "789",
    "wechatDesc": "",
    "province": "434",
    "city": "嘎嘎嘎",
    "district": "342323",
    "address": "123号街区",
    "summary": "beizhu",
    "source_title": "",
    "tracker_id": "1212",
    "attachments": {
        "files": []
    },
    "website": "我是网站",
    "customer_fields": {
        "rows": [
            {
                "name": "自定义单行文本",
                "value": "自定义单行文本内容"
            },
            {
                "name": "自定义多行文本",
                "value": "我是多行文本1\n我是多行文本2\n我是多行文本3"
            },
            {
                "name": "单选-人口",
                "value": "三口之家"
            },
            {
                "name": "自定义多选",
                "value": [
                    "套餐一",
                    "套餐二",
                    "套餐三"
                ]
            },
            {
                "name": "不关联字典下拉框",
                "value": "不关联字典选项1"
            },
            {
                "name": "下拉框-多级字典",
                "value": [
                    "208e64bd96e9491ca8b92c0dxxxxxxxx",
                    "f88baa61acf44829aa14b0f1xxxxxxxx",
                    "d5ac5c75eab24f0a9740fc8axxxxxxxx"
                ]
            },
            {
                "name": "自定义日期",
                "value": "2023/12/2"
            },
            {
                "name": "自定义日期时间",
                "value": "2021-12-23 20:15:45"
            },
            {
                "name": "自定义数字",
                "value": 66
            }
        ]
    }
}

响应：

{
    "errcode": 0,
    "errmsg": "success"
}
文档更新时间: 2024-03-25 15:20   作者：admin