Update Evaluation Form

connect_update_evaluation_form

R Documentation

Updates details about a specific evaluation form version in the specified Connect Customer instance

Description

Updates details about a specific evaluation form version in the specified Connect Customer instance. Question and section identifiers cannot be duplicated within the same evaluation form.

This operation does not support partial updates. Instead it does a full update of evaluation form content.

Usage

connect_update_evaluation_form(InstanceId, EvaluationFormId,
  EvaluationFormVersion, CreateNewVersion, Title, Description, Items,
  ScoringStrategy, AutoEvaluationConfiguration, ReviewConfiguration,
  AsDraft, ClientToken, TargetConfiguration, LanguageConfiguration)

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.
EvaluationFormId	[required] The unique identifier for the evaluation form.
EvaluationFormVersion	[required] A version of the evaluation form to update.
CreateNewVersion	A flag indicating whether the operation must create a new version.
Title	[required] A title of the evaluation form.
Description	The description of the evaluation form.
Items	[required] Items that are part of the evaluation form. The total number of sections and questions must not exceed 100 each. Questions must be contained in a section.
ScoringStrategy	A scoring strategy of the evaluation form.
AutoEvaluationConfiguration	Whether automated evaluations are enabled.
ReviewConfiguration	Configuration for evaluation review settings of the evaluation form.
AsDraft	A boolean flag indicating whether to update evaluation form to draft state.
ClientToken	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.
TargetConfiguration	Configuration that specifies the target for the evaluation form.
LanguageConfiguration	Configuration for language settings of the evaluation form.

Value

A list with the following syntax:

list(
  EvaluationFormId = "string",
  EvaluationFormArn = "string",
  EvaluationFormVersion = 123
)

Request syntax

svc$update_evaluation_form(
  InstanceId = "string",
  EvaluationFormId = "string",
  EvaluationFormVersion = 123,
  CreateNewVersion = TRUE|FALSE,
  Title = "string",
  Description = "string",
  Items = list(
    list(
      Section = list(
        Title = "string",
        RefId = "string",
        Instructions = "string",
        Items = list(),
        Weight = 123.0
      ),
      Question = list(
        Title = "string",
        Instructions = "string",
        RefId = "string",
        NotApplicableEnabled = TRUE|FALSE,
        QuestionType = "TEXT"|"SINGLESELECT"|"NUMERIC"|"MULTISELECT"|"DATETIME",
        QuestionTypeProperties = list(
          Numeric = list(
            MinValue = 123,
            MaxValue = 123,
            Options = list(
              list(
                MinValue = 123,
                MaxValue = 123,
                Score = 123,
                AutomaticFail = TRUE|FALSE,
                AutomaticFailConfiguration = list(
                  TargetSection = "string"
                )
              )
            ),
            Automation = list(
              PropertyValue = list(
                Label = "OVERALL_CUSTOMER_SENTIMENT_SCORE"|"OVERALL_AGENT_SENTIMENT_SCORE"|"CUSTOMER_SENTIMENT_SCORE_WITHOUT_AGENT"|"CUSTOMER_SENTIMENT_SCORE_WITH_AGENT"|"NON_TALK_TIME"|"NON_TALK_TIME_PERCENTAGE"|"NUMBER_OF_INTERRUPTIONS"|"CONTACT_DURATION"|"AGENT_INTERACTION_DURATION"|"CUSTOMER_HOLD_TIME"|"LONGEST_HOLD_DURATION"|"NUMBER_OF_HOLDS"|"AGENT_INTERACTION_AND_HOLD_DURATION"
              ),
              AnswerSource = list(
                SourceType = "CONTACT_LENS_DATA"|"GEN_AI"
              )
            )
          ),
          SingleSelect = list(
            Options = list(
              list(
                RefId = "string",
                Text = "string",
                Score = 123,
                AutomaticFail = TRUE|FALSE,
                AutomaticFailConfiguration = list(
                  TargetSection = "string"
                )
              )
            ),
            DisplayAs = "DROPDOWN"|"RADIO",
            Automation = list(
              Options = list(
                list(
                  RuleCategory = list(
                    Category = "string",
                    Condition = "PRESENT"|"NOT_PRESENT",
                    OptionRefId = "string"
                  )
                )
              ),
              DefaultOptionRefId = "string",
              AnswerSource = list(
                SourceType = "CONTACT_LENS_DATA"|"GEN_AI"
              )
            )
          ),
          Text = list(
            Automation = list(
              AnswerSource = list(
                SourceType = "CONTACT_LENS_DATA"|"GEN_AI"
              )
            )
          ),
          MultiSelect = list(
            Options = list(
              list(
                RefId = "string",
                Text = "string"
              )
            ),
            DisplayAs = "DROPDOWN"|"CHECKBOX",
            Automation = list(
              Options = list(
                list(
                  RuleCategory = list(
                    Category = "string",
                    Condition = "PRESENT"|"NOT_PRESENT",
                    OptionRefIds = list(
                      "string"
                    )
                  )
                )
              ),
              DefaultOptionRefIds = list(
                "string"
              ),
              AnswerSource = list(
                SourceType = "CONTACT_LENS_DATA"|"GEN_AI"
              )
            )
          )
        ),
        Enablement = list(
          Condition = list(
            Operands = list(
              list(
                Expression = list(
                  Source = list(
                    Type = "QUESTION_REF_ID",
                    RefId = "string"
                  ),
                  Values = list(
                    list(
                      Type = "OPTION_REF_ID",
                      RefId = "string"
                    )
                  ),
                  Comparator = "IN"|"NOT_IN"|"ALL_IN"|"EXACT"
                ),
                Condition = list()
              )
            ),
            Operator = "OR"|"AND"
          ),
          Action = "DISABLE"|"ENABLE",
          DefaultAction = "DISABLE"|"ENABLE"
        ),
        Weight = 123.0
      )
    )
  ),
  ScoringStrategy = list(
    Mode = "QUESTION_ONLY"|"SECTION_ONLY",
    Status = "ENABLED"|"DISABLED"
  ),
  AutoEvaluationConfiguration = list(
    Enabled = TRUE|FALSE
  ),
  ReviewConfiguration = list(
    ReviewNotificationRecipients = list(
      list(
        Type = "USER_ID",
        Value = list(
          UserId = "string"
        )
      )
    ),
    EligibilityDays = 123
  ),
  AsDraft = TRUE|FALSE,
  ClientToken = "string",
  TargetConfiguration = list(
    ContactInteractionType = "AGENT"|"AUTOMATED"|"CUSTOMER"
  ),
  LanguageConfiguration = list(
    FormLanguage = "de-DE"|"en-US"|"es-ES"|"fr-FR"|"it-IT"|"pt-BR"|"ja-JP"|"ko-KR"|"zh-CN"
  )
)