Kustomer 제한 사항 - AWS Glue

Kustomer 제한 사항

다음은 Kustomer의 제한 사항 또는 참고 사항입니다.

  • Kustomer API 설명서에서 어떠한 엔드포인트도 선언하지 않았으므로 Customer Searches 엔터티는 지원되지 않습니다.

  • Klasses 엔터티에 대한 필터링 및 증분 전송은 지원되지 않습니다.

  • 순서 기준은 단일 요청의 여러 적용 가능한 필드에서 지원될 수 있습니다.

    하지만 여러 필드의 기능별 순서는 일부 조합에 대해 SaaS 종단에서 일관되지 않게 작동하는 것으로 관찰되었습니다. 잘못된 정렬 결과를 표시할 수 있는 ‘n’개의 조합이 있을 수 있으므로 예측할 수 없습니다. 예시:

    Customers 엔터티의 경우 progressiveStatus desc, name asc를 기준으로 정렬해도 정렬된 결과가 정확하지 않습니다. progressiveStatus 순서만을 기반으로 하여 정렬됩니다. 이러한 동작이 관찰되면 단일 필드를 사용하여 순서를 정할 수 있습니다.

  • ‘id’ 필드의 순서 기준은 ConversationsMessages 엔터티에서만 쿼리 파라미터로 지원됩니다. 예: https://api.kustomerapp.com/v1/conversations?sort=desc(‘id’를 기준으로 결과를 내림차순으로 정렬)

    추가로 다른 필드의 다른 필터 또는 순서는 API 엔드포인트가 POST인 POST 요청 본문으로 변환됩니다(https://api.kustomerapp.com/v1/customers/search). ConversationsMessages에서 ‘id’에 의한 순서 지정 지원을 허용하려면 id에 의한 순서만 존재하거나 다른 적용 가능한 필드에 대한에 의한 다른 필터 및/또는 순서가 있어야 합니다.

  • Kustomer는 필터링된 요청 또는 필터링되지 않은 요청과 무관하게 최대 10,000개의 레코드를 가져올 수 있습니다. 이러한 제한으로 인해 10,000개 이상의 레코드를 보유한 엔터티에 대한 데이터 손실이 발생합니다. 이 문제를 어느 정도 완화하기 위해 수행할 수 있는 두 가지 해결 방법이 있습니다.

    • 필터를 적용하여 특정 레코드 세트를 가져옵니다.

    • 필터가 적용된 레코드가 10,000개를 초과하는 경우 후속 신규 요청에 연속 필터 값을 적용하거나 필터에 범위를 적용합니다. 예시:

      첫 번째 요청의 filterExpression: modifiedAt >= 2022-03-15T05:26:23.000Z and modifiedAt < 2023-03-15T05:26:23.000Z

      이로 인해 10,000개 레코드 제한이 소진된다고 가정합니다.

      filterExpression modifiedAt >= 2023-03-15T05:26:23.000Z를 사용하여 다른 요청을 트리거할 수 있습니다.

  • SaaS 동작으로 Kustomer의 CONTAINS 연산자는 단어 내에서 부분 일치가 아닌 전체 단어 일치만 지원합니다. 예: “body CONTAINS ‘test record’”는 ‘body’ 필드에 ‘test’가 있는 레코드와 일치합니다. 하지만 “body CONTAINS ‘test’”는 ‘body’ 필드에 ‘testAnotherRecord’가 있는 레코드와는 일치하지 않습니다.