本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
以下是 Kustomer 的限制或備註:
不支援
Customer Searches
實體,因為 Kustomer API 文件尚未宣告其任何端點。不支援對
Klasses
實體進行篩選和增量傳輸。單一請求中的多個適用欄位可支援 的排序。
不過,已觀察到多個欄位的功能順序與某些組合的 SaaS 結尾的行為不一致。它無法預測,因為可能有 'n' 組合可能顯示不正確的排序結果。例如:
對於
Customers
實體,依 排序progressiveStatus desc, name asc
不會產生正確的排序結果。它只會根據progressiveStatus
順序排序。如果觀察到這類行為,您可以使用要排序的單一欄位。欄位 'id' 上的 排序僅支援
Conversations
和Messages
實體做為查詢參數。例如:https://api.kustomerapp.com/v1/conversations?sort=desc (這會依 'id' 遞減順序排序結果。)此外,任何其他欄位上的篩選條件或排序會轉譯為具有 API 端點做為 POST 的 POST 請求內文 https://api.kustomerapp.com/v1/customers/search:// 若要允許在
Conversations
和 中支援 'id' 排序Messages
,則應該只存在 ID 的順序,或任何其他適用欄位上的篩選條件和/或順序。無論篩選或未篩選的請求為何,Kustomer 最多允許擷取 10K 筆記錄。由於此限制,任何持有超過 10K 筆記錄的實體都會遺失資料。您可以執行兩種可能的解決方法,以部分緩解這種情況:
套用篩選條件來擷取特定記錄集。
如果已套用篩選條件的記錄超過 10K 筆,請在新的後續請求中套用連續篩選條件值,或在篩選條件中套用範圍。例如:
第一個請求的 filterExpression:
modifiedAt >= 2022-03-15T05:26:23.000Z and modifiedAt < 2023-03-15T05:26:23.000Z
假設這會耗盡 10K 記錄限制。
另一個請求可以使用 filterExpression 觸發:
modifiedAt >= 2023-03-15T05:26:23.000Z
作為 SaaS 行為,Kustomer 中的
CONTAINS
運算子僅支援對完整單字進行比對,而不是對單字進行部分比對。例如:「body CONTAINS 'test record」將比對 'body' 欄位中具有 'test' 的記錄。不過,「body CONTAINS 'test'」不會符合 'body' 欄位中具有 'testAnotherRecord' 的記錄。