Skip to content

Search Contact Evaluations

connect_search_contact_evaluations R Documentation

Searches contact evaluations in an Connect Customer instance, with optional filtering

Description

Searches contact evaluations in an Connect Customer instance, with optional filtering.

Use cases

Following are common uses cases for this API:

  • Find contact evaluations by using specific search criteria.

  • Find contact evaluations that are tagged with a specific set of tags.

Important things to know

  • A Search operation, unlike a List operation, takes time to index changes to resource (create, update or delete). If you don't see updated information for recently changed contact evaluations, try calling the API again in a few seconds.

Endpoints: See Connect Customer endpoints and quotas.

Usage

connect_search_contact_evaluations(InstanceId, NextToken, MaxResults,
  SearchCriteria, SearchFilter)

Arguments

InstanceId

[required] The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
NextToken

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
MaxResults

The maximum number of results to return per page.
SearchCriteria

The search criteria to be used to return contact evaluations.
SearchFilter

Filters to be applied to search results.

Value

A list with the following syntax:

list(
  EvaluationSearchSummaryList = list(
    list(
      EvaluationId = "string",
      EvaluationArn = "string",
      EvaluationFormId = "string",
      EvaluationFormVersion = 123,
      EvaluationFormTitle = "string",
      Metadata = list(
        ContactId = "string",
        EvaluatorArn = "string",
        ContactAgentId = "string",
        CalibrationSessionId = "string",
        ScorePercentage = 123.0,
        ScoreAutomaticFail = TRUE|FALSE,
        ScoreNotApplicable = TRUE|FALSE,
        AutoEvaluationEnabled = TRUE|FALSE,
        AutoEvaluationStatus = "IN_PROGRESS"|"FAILED"|"SUCCEEDED",
        AcknowledgedTime = as.POSIXct(
          "2015-01-01"
        ),
        AcknowledgedBy = "string",
        AcknowledgerComment = "string",
        SamplingJobId = "string",
        ReviewId = "string",
        ContactParticipantRole = "AGENT"|"SYSTEM"|"CUSTOM_BOT"|"CUSTOMER",
        ContactParticipantId = "string"
      ),
      Status = "DRAFT"|"SUBMITTED"|"REVIEW_REQUESTED"|"UNDER_REVIEW",
      EvaluationType = "STANDARD"|"CALIBRATION",
      CreatedTime = as.POSIXct(
        "2015-01-01"
      ),
      LastModifiedTime = as.POSIXct(
        "2015-01-01"
      ),
      Tags = list(
        "string"
      )
    )
  ),
  NextToken = "string",
  ApproximateTotalCount = 123
)

Request syntax

svc$search_contact_evaluations(
  InstanceId = "string",
  NextToken = "string",
  MaxResults = 123,
  SearchCriteria = list(
    OrConditions = list(
      list()
    ),
    AndConditions = list(
      list()
    ),
    StringCondition = list(
      FieldName = "string",
      Value = "string",
      ComparisonType = "STARTS_WITH"|"CONTAINS"|"EXACT"
    ),
    NumberCondition = list(
      FieldName = "string",
      MinValue = 123,
      MaxValue = 123,
      ComparisonType = "GREATER_OR_EQUAL"|"GREATER"|"LESSER_OR_EQUAL"|"LESSER"|"EQUAL"|"NOT_EQUAL"|"RANGE"
    ),
    BooleanCondition = list(
      FieldName = "string",
      ComparisonType = "IS_TRUE"|"IS_FALSE"
    ),
    DateTimeCondition = list(
      FieldName = "string",
      MinValue = "string",
      MaxValue = "string",
      ComparisonType = "GREATER_THAN"|"LESS_THAN"|"GREATER_THAN_OR_EQUAL_TO"|"LESS_THAN_OR_EQUAL_TO"|"EQUAL_TO"|"RANGE"
    ),
    DecimalCondition = list(
      FieldName = "string",
      MinValue = 123.0,
      MaxValue = 123.0,
      ComparisonType = "GREATER_OR_EQUAL"|"GREATER"|"LESSER_OR_EQUAL"|"LESSER"|"EQUAL"|"NOT_EQUAL"|"RANGE"
    )
  ),
  SearchFilter = list(
    AttributeFilter = list(
      OrConditions = list(
        list(
          TagConditions = list(
            list(
              TagKey = "string",
              TagValue = "string"
            )
          )
        )
      ),
      AndCondition = list(
        TagConditions = list(
          list(
            TagKey = "string",
            TagValue = "string"
          )
        )
      ),
      TagCondition = list(
        TagKey = "string",
        TagValue = "string"
      )
    )
  )
)