跳至主要內容

客户关系

大约 4 分钟

客户关系

批量置空客户负责人接口

  • 描述

    批量置空客户负责人

  • URI

    /wscrm-bus-api/open/customer/setPrincipalAsNull

  • 请求方式

    POST、Content-Type: application/json

  • 请求参数说明

参数名类型是否必填备注
tenantIdLong公司id
userNameString管理员账号
dataList格式[111,222],详细如下(数量 0-50 条)
tokenStringtoken
createTimeString创建时间

data参数说明

参数名类型是否必填备注
-String好友 whatsapp

请求示例:

{
  "tenantId": 1223,
  "userName": "yangkun",
  "token": "417a22f7713bdaca425a23e7958b51b7",
  "createTime": "2023-01-11 13:48:33",
  "data": [919161506154]
}
  • 响应参数说明

    参数名类型是否必填示例值备注
    codeint200状态码
    messageString成功描述
    dataString[]数据

    data参数说明

    参数名类型是否必填示例值备注
    isAllOkBoolean是否全部更新成功
    totalintwhatsId 总数
    successWhatsIdsList<String>成功 whatsId
    failWhatsIdsList<String>失败 whatsId
  • 响应示例

{
  "code": 200,
  "message": "Success",
  "data": {
    "isAllOk": true,
    "total": 1,
    "successWhatsIds": ["919161506154"],
    "failWhatsIds": []
  }
}

删除客户

  • 描述

    客户删除

    全部删除删除时间取决于数据量的多少,所需删除数据量越大,耗时越久。 删除期间,如果存在数据操作,可能会导致数据丢失,请谨慎使用。

  • URI

    /wscrm-bus-api/open/customer/del

  • 请求方式

    POST、Content-Type: application/json

  • 请求参数说明

参数名类型是否必填备注
tenantIdLong公司id
userNameString管理员账号
tokenStringtoken
createTimeString创建时间
typeint所需删除数据的类型 1 全部 2 坐席 3 客户
itemarray取决于上述type当type为1的时候,此值可为空,当type为1的时候,item为所需删除负责人的账号(坐席账号),当type为3的时候,item里边的值为所需删除whatsapp号码的数据

请求示例:

{
  "tenantId": 1223,
  "userName": "yangkun",
  "token": "417a22f7713bdaca425a23e7958b51b7",
  "createTime": "2023-01-11 13:48:33",
  "type":1,
  "item":[
    "moppo00001"
  ]
}
  • 响应参数说明

    参数名类型是否必填示例值备注
    codeint200状态码
    messageString成功描述
    dataString[]数据
  • 响应示例

{
  "code": 200,
  "message": "Success",
  "data":""
}

客户标签

删除客户标签

  • 描述

    删除客户标签

  • URI

    /wscrm-bus-api/open/customer/delTag

  • 请求方式

    POST、Content-Type: application/json

  • 请求参数说明

参数名类型是否必填备注
whatsIdListList客户wa号码
tagNameString标签名称

请求示例:

{
  "whatsIdList": [
        "86172722772727",
        "86122626262662"
  ],
  "tagName": "ball",
}
  • 响应参数说明

    参数名类型是否必填示例值备注
    codeint200状态码
    messageString成功描述
    dataString[]数据
  • 响应示例

{
  "code": 200,
  "message": "Success",
  "data":""
}

删除客户全部标签

  • 描述

    删除客户全部标签

  • URI

    /wscrm-bus-api/open/customer/delTags

  • 请求方式

    POST、Content-Type: application/json

  • 请求参数说明

参数名类型是否必填备注
whatsIdListList客户wa账号

请求示例:

{
  "whatsIdList":[
         "8271722772727",
         "8626262626262"
  ]
}
  • 响应参数说明

    参数名类型是否必填示例值备注
    codeint200状态码
    messageString成功描述
    dataString[]数据
  • 响应示例

{
  "code": 200,
  "message": "Success",
  "data":""
}

删除好友联系人接口

  • 描述

    删除好友联系人

  • URI

    /wscrm-bus-api/open/customer/delFriendsContacts

  • 请求方式

    POST、Content-Type: application/json

  • 请求参数说明

参数名类型是否必填备注
tenantIdLong公司id
userNameString管理员账号
infoObject请求条件参数
tokenStringtoken
createTimeString创建时间

info参数说明

参数名类型是否必填备注
friendWhatsIdString好友 whatsapp
whatsIdString客服号
agentAccountString坐席账号

请求示例:

{
  "info":{
    "friendWhatsId": "8801833524358",
    "whatsId": "",
    "agentAccount": ""
  },
  "tenantId": 520274,
  "userName":"testlsl001",
  "token": "ac747960637f554d8ac8e87542fe8ff6",
  "createTime":"2025-03-31 13:48:33"
}
  • 响应参数说明

    参数名类型是否必填示例值备注
    codeint200状态码
    messageString成功描述
    dataString数据
  • 响应示例

{
  "code": 200,
  "message": "Success ",
  "data": ""
}

查询删除好友联系人记录接口

  • 描述

    查询删除好友联系人记录

  • URI

    /wscrm-bus-api/open/customer/queryDelCustomerInfo

  • 请求方式

    POST、Content-Type: application/json

  • 请求参数说明

参数名类型是否必填备注
tenantIdLong公司id
userNameString管理员账号
infoObject条件参数
tokenStringtoken
createTimeString创建时间
currentInteger当前页
pageSizeInteger每页数量

info参数说明

参数名类型是否必填备注
friendWhatsIdString好友 whatsapp
whatsIdString客服号
agentAccountString坐席账号
delFlagInteger删除标识 0未删除 1已删除

请求示例:

{
  "info":{
    "friendWhatsId": "8801833524358",
    "whatsId": "",
    "agentAccount": "",
    "delFlag": 1
  },
  "tenantId": 520274,
  "userName":"testlsl001",
  "token": "ac747960637f554d8ac8e87542fe8ff6",
  "createTime":"2025-03-31 13:48:33",
  "current":1,
  "pageSize":2
}
  • 响应参数说明

    参数名类型是否必填示例值备注
    codeint200状态码
    messageString成功描述
    dataStringObject数据
    totalInteger1总页数
  • data参数说明

    参数名类型是否必填备注
    recordslistrecords
  • records参数说明

    参数名类型是否必填备注
    whatsIdStringwhatsId
    friendWhatsIdStringfriendWhatsId
    delFlagInteger删除标识 0未删除 1已删除
    deleteTimeString删除时间
  • 响应示例
{
  "code": 200,
  "message": "Success ",
  "data": {
    "records": [
      {
        "whatsId": "67074807576",
        "friendWhatsId": "8801833524358",
        "delFlag": 1,
        "deleteTime": "2025-04-02 21:01:28"
      }
    ],
    "total": 1
  }
}
上次编辑于:
贡献者: 罗英杰,kubrick,罗英杰,zhangzhuangzhuang