Einschränkungen von Kustomer
Im Folgenden finden Sie Einschränkungen oder Hinweise für Kustomer:
Die Entität
Customer Searcheswird nicht unterstützt, da in der Kustomer-API-Dokumentation kein Endpunkt für sie deklariert wurde.Die Filterung und inkrementelle Übertragung auf der Entität
Klasseswird nicht unterstützt.„Sortieren nach“ kann für mehrere zutreffende Felder in einer einzigen Anfrage unterstützt werden.
Jedoch wurde beobachtet, dass sich die „Sortieren nach“-Funktion für mehrere Felder bei einigen Kombinationen auf der SaaS-Seite inkonsistent verhält. Das Verhalten ist unvorhersehbar, da es „n“ Kombinationen geben könnte, die zu falschen Sortierergebnissen führen. Zum Beispiel:
Für die Entität
Customersführt das Sortieren nachprogressiveStatus desc, name ascnicht zum richtigen sortierten Ergebnis. Es wird nur anhand derprogressiveStatus-Reihenfolge sortiert. Wenn ein solches Verhalten beobachtet wird, können Sie ein einzelnes Feld verwenden, nach dem sortiert werden soll.„Sortieren nach“ im Feld „id“ wird nur von den Entitäten
ConversationsundMessagesals Abfrageparameter unterstützt. Beispiel: https://api.kustomerapp.com/v1/conversations?sort=desc (Dadurch werden die Ergebnisse in absteigender Reihenfolge nach „id“ sortiert.)Darüber hinaus wird jeder andere Filter oder jede andere Sortierung nach einem anderen Feld in einen POST-Anfragetext mit dem API-Endpunkt als POST https://api.kustomerapp.com/v1/customers/search übersetzt. Um die Sortierung nach „id“ in
ConversationsundMessageszu unterstützen, sollte entweder nur die Sortierung nach „id“ vorhanden sein oder ein anderer Filter und/oder „Sortieren nach“ für ein anderes anwendbares Feld.Kustomer ermöglicht das Abrufen von maximal 10 000 Datensätzen, unabhängig davon, ob es sich um eine gefilterte oder eine ungefilterte Anfrage handelt. Aufgrund dieser Einschränkung kommt es bei jeder Entität, die mehr als 10 000 Datensätze umfasst, zu Datenverlust. Es gibt zwei mögliche Workarounds, mit denen Sie dieses Problem teilweise beheben können:
Wenden Sie Filter an, um eine bestimmte Gruppe von Datensätzen abzurufen.
Wenn mehr als 10 000 Datensätze mit einem angewendeten Filter vorhanden sind, wenden Sie einen aufeinanderfolgenden Filterwert in einer neuen nachfolgenden Anfrage an oder wenden Sie Bereiche in Filtern an. Zum Beispiel:
Der Filterausdruck der ersten Anfrage:
modifiedAt >= 2022-03-15T05:26:23.000Z and modifiedAt < 2023-03-15T05:26:23.000Z.Gehen Sie davon aus, dass dadurch das Limit von 10 000 Datensätzen ausgeschöpft ist.
Eine weitere Anfrage kann mit diesem Filterausdruck ausgelöst werden:
modifiedAt >= 2023-03-15T05:26:23.000Z.
Als SaaS-Verhalten unterstützt der Operator
CONTAINSin Kustomer nur die Übereinstimmung mit vollständigen Wörtern und keine Teilübereinstimmungen innerhalb eines Wortes. Beispiel: „body CONTAINS ‚test record‘“ findet einen Datensatz, der „test“ im Feld „body“ enthält. „body CONTAINS ‚test‘“ findet jedoch keinen Datensatz, der „testAnotherRecord“ im Feld „body“ enthält.