Restrictions de Kustomer
Les restrictions ou remarques suivantes concernent Kustomer :
L’entité
Customer Searchesn’est pas prise en charge, car la documentation de l’API Kustomer n’a déclaré aucun point de terminaison pour elle.La prise en charge de la filtration et du transfert incrémentiel sur l’entité
Klassesn’est pas prise en charge.Order by peut être prise en charge sur plusieurs champs applicables dans une seule demande.
Cependant, il a été observé sur plusieurs champs que la fonctionnalité Order by se comportait de manière incohérente du côté de SaaS pour certaines combinaisons. Elle est imprévisible, car il peut y avoir « n » combinaisons susceptibles d’afficher des résultats de tri incorrects. Par exemple :
Pour l’entité
Customers, Order byprogressiveStatus desc, name ascne donne pas le résultat de tri correct. Le tri se fait uniquement en fonction de l’ordreprogressiveStatus. Si un tel comportement est observé, vous pouvez utiliser un seul champ pour effectuer le tri.La fonctionnalité Order by sur le champ « id » n’est prise en charge que par les entités
ConversationsetMessagesen tant que paramètre de requête. Par exemple : https://api.kustomerapp.com/v1/conversations?sort=desc (Cela permet de trier les résultats par « id » dans l’ordre décroissant.)De plus, tout autre filtre ou ordre sur un autre champ est traduit dans un corps de demande POST dont le point de terminaison de l’API est POST https://api.kustomerapp.com/v1/customers/search. Pour permettre la prise en charge du tri par « id » dans
ConversationsetMessages, soit seul Order by id doit être présent, soit tout autre filtre et/ou Order by doit être présent sur tout autre champ applicable.Kustomer permet de récupérer un maximum de 10 000 enregistrements, qu’il s’agisse d’une demande filtrée ou non filtrée. En raison de cette restriction, toute entité détenant plus de 10 000 enregistrements subira une perte de données. Il existe deux solutions possibles pour atténuer partiellement ce problème :
Appliquez des filtres pour récupérer un ensemble d’enregistrements spécifique.
Si un filtre est appliqué à plus de 10 000 enregistrements, appliquez une valeur de filtre successive dans une nouvelle demande ultérieure ou appliquez des plages dans les filtres. Par exemple :
filterExpression de la première demande :
modifiedAt >= 2022-03-15T05:26:23.000Z and modifiedAt < 2023-03-15T05:26:23.000ZSupposons que la limite de 10 000 enregistrements est dépassée.
Une autre requête peut être déclenchée avec filterExpression :
modifiedAt >= 2023-03-15T05:26:23.000Z
En tant que comportement SaaS, l’opérateur
CONTAINSde Kustomer prend en charge la mise en correspondance uniquement sur des mots complets et non sur des correspondances partielles au sein d’un mot. Par exemple : « body CONTAINS ’test record’ » correspondra à un enregistrement ayant « test » dans le champ « body ». Cependant, « body CONTAINS ’test’ » ne correspondra pas à un enregistrement ayant « testAnotherRecord » dans le champ « body ».