Connect / Client / start_contact_evaluation

start_contact_evaluation#

Connect.Client.start_contact_evaluation(**kwargs)#

Starts an empty evaluation in the specified Amazon Connect instance, using the given evaluation form for the particular contact. The evaluation form version used for the contact evaluation corresponds to the currently activated version. If no version is activated for the evaluation form, the contact evaluation cannot be started.

Note

Evaluations created through the public API do not contain answer values suggested from automation.

See also: AWS API Documentation

Request Syntax

response = client.start_contact_evaluation(
    InstanceId='string',
    ContactId='string',
    EvaluationFormId='string',
    ClientToken='string'
)
Parameters:

  • InstanceId (string) –

    [REQUIRED]

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • ContactId (string) –

    [REQUIRED]

    The identifier of the contact in this instance of Amazon Connect.

  • EvaluationFormId (string) –

    [REQUIRED]

    The unique identifier for the evaluation form.

  • ClientToken (string) –

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'EvaluationId': 'string',
    'EvaluationArn': 'string'
}

Response Structure

  • (dict) –

    • EvaluationId (string) –

      A unique identifier for the contact evaluation.

    • EvaluationArn (string) –

      The Amazon Resource Name (ARN) for the contact evaluation resource.

Exceptions

  • Connect.Client.exceptions.InternalServiceException

  • Connect.Client.exceptions.InvalidParameterException

  • Connect.Client.exceptions.ResourceNotFoundException

  • Connect.Client.exceptions.ThrottlingException

  • Connect.Client.exceptions.ServiceQuotaExceededException

  • Connect.Client.exceptions.ResourceConflictException