

# Kustomer 限制
<a name="kustomer-connection-limitations"></a>

以下是 Kustomer 的限制或说明：
+ 由于 Kustomer API 文档尚未为 `Customer Searches` 实体声明任何端点，因此不支持该实体。
+ 不支持对 `Klasses` 实体进行筛选和增量传输。
+ 在单个请求中，支持对多个适用字段应用排序依据。

  然而，据观察，对于某些组合，多个字段的排序依据功能在 SaaS 端表现不一致。这是不可预测的，因为可能存在“n”种组合，因而会显示错误的排序结果。例如：

  对于 `Customers` 实体，按 `progressiveStatus desc, name asc` 排序无法产生正确的排序结果。只会根据 `progressiveStatus` 依据进行排序。如果出现这种情况，可对单个字段进行排序。
+ 只有 `Conversations` 和 `Messages` 实体支持将字段“id”作为查询参数进行排序。例如：https://api.kustomerapp.com/v1/conversations?sort=desc（将根据“id”对结果降序排序。）

  此外，任何其他筛选条件或对任何其他字段的排序都会转换为 POST 请求正文，对应的 API 端点为 POST https://api.kustomerapp.com/v1/customers/search。若要支持在 `Conversations` 和 `Messages` 中按“id”排序，则只能按 id 排序，或者对任何其他适用字段应用任何其他筛选条件和/或排序。
+ 无论请求是经过筛选还是未经过筛选，Kustomer 允许获取最多 1 万条记录。由于此限制，任何持有超过 1 万条记录的实体都会存在数据丢失。您可以采取两种可能的解决方法来部分改善这种情况：
  + 应用筛选条件，获取一组特定的记录。
  + 如果应用筛选条件的记录超过 1 万条，请在后续新请求中继续应用筛选条件值或在筛选条件中指定范围。例如：

    第一个请求的 filterExpression：`modifiedAt >= 2022-03-15T05:26:23.000Z and modifiedAt < 2023-03-15T05:26:23.000Z`

    假设其已达到 1 万条记录限制。

    可用 filterExpression `modifiedAt >= 2023-03-15T05:26:23.000Z` 触发另一个请求
+ 基于 SaaS 行为，Kustomer 中的 `CONTAINS` 运算符仅支持匹配完整的单词，而不支持对单词中的部分内容进行匹配。例如：“body CONTAINS 'test record'”将匹配“body”字段中包含“test”的记录。但是，“body CONTAINS 'test'”不会匹配“body”字段中含有“testAnotherRecord”的记录。