AWS connect medium security documentation change

Service: connect · 2026-02-28 · Security-related medium

File: connect/latest/adminguide/evaluationforms-example-output-file.md

Summary

Updated evaluation form schema version from 3.1 to 3.5, added new fields (evaluationType, calibrationSessionId, evaluatedParticipantId, evaluatedParticipantRole), expanded JSON examples with security-relevant content like consent verification checks and automatic failure conditions

Security assessment

Added documentation about automatic failure conditions for missing consent checks (credit check consent example) demonstrates enforcement of compliance controls. New evaluatedParticipant fields improve audit trails. Consent verification documentation directly relates to data protection requirements.

Diff

diff --git a/connect/latest/adminguide/evaluationforms-example-output-file.md b/connect/latest/adminguide/evaluationforms-example-output-file.md
index da000f801..ded481f26 100644
--- a//connect/latest/adminguide/evaluationforms-example-output-file.md
+++ b//connect/latest/adminguide/evaluationforms-example-output-file.md
@@ -66 +66 @@ The following example shows a typical score.
-    "schemaVersion": "3.1",
+      "schemaVersion": "3.5",
@@ -77,3 +77,5 @@ The following example shows a typical score.
-        "evaluationStartTimestamp": "2022-11-14T17:57:08.649Z",
-        "evaluationSubmitTimestamp": "2022-11-14T17:59:29.052Z",
-        "score": { "percentage": 100 },
+        "evaluationStartTimestamp": "2025-11-14T17:57:08.649Z",
+        "evaluationSubmitTimestamp": "2025-11-14T17:59:29.052Z",
+        "score": {
+          "percentage": 100
+        },
@@ -84,4 +86,5 @@ The following example shows a typical score.
-        "acknowledgerComment": "The Acknowledgment comment",
-             "acknowledgedTimestamp": "2022-12-22T05:20:39.297Z",
-             "acknowledgedByUserName": "john",
-             "acknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218"
+        "evaluationType": "CONTACT_EVALUATION",
+        "evaluationAcknowledgerComment": "The Acknowledgment comment",
+        "evaluationAcknowledgedTimestamp": "2025-12-22T05:20:39.297Z",
+        "evaluationAcknowledgedByUserName": "john",
+        "evaluationAcknowledgedByUserId": "286bcec0-e722-4166-865f-84db80252218"
@@ -94 +97,3 @@ The following example shows a typical score.
-          "score": { "percentage": 100 }
+          "score": {
+            "percentage": 100
+          }
@@ -100 +105,3 @@ The following example shows a typical score.
-          "score": { "percentage": 100 }
+          "score": {
+            "percentage": 100
+          }
@@ -112 +119,3 @@ The following example shows a typical score.
-            "metadata": { "notApplicable": true }
+            "metadata": {
+              "notApplicable": true
+            }
@@ -114 +123,3 @@ The following example shows a typical score.
-          "score": { "notApplicable": true }
+          "score": {
+            "notApplicable": true
+          }
@@ -123,3 +134,15 @@ The following example shows a typical score.
-              { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": true },
-              { "valueText": "No", "valueRefId": "o284e4d9e", "selected": false },
-              { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false }
+              {
+                "valueText": "Yes",
+                "valueRefId": "o6999aa94",
+                "selected": true
+              },
+              {
+                "valueText": "No",
+                "valueRefId": "o284e4d9e",
+                "selected": false
+              },
+              {
+                "valueText": "Maybe",
+                "valueRefId": "o1b2f0a14",
+                "selected": false
+              }
@@ -132 +155,3 @@ The following example shows a typical score.
-            "metadata": { "notApplicable": false }
+            "metadata": {
+              "notApplicable": false
+            }
@@ -134 +159,3 @@ The following example shows a typical score.
-          "score": { "percentage": 100 }
+          "score": {
+            "percentage": 100
+          }
@@ -143,3 +170,15 @@ The following example shows a typical score.
-              { "valueText": "Yes", "valueRefId": "o6999aa94", "selected": false },
-              { "valueText": "No", "valueRefId": "o284e4d9e", "selected": true },
-              { "valueText": "Maybe", "valueRefId": "o1b2f0a14", "selected": false }
+              {
+                "valueText": "Yes",
+                "valueRefId": "p7888bb85",
+                "selected": false
+              },
+              {
+                "valueText": "No",
+                "valueRefId": "p395f5e8f",
+                "selected": true
+              },
+              {
+                "valueText": "Maybe",
+                "valueRefId": "p2c3g1b25",
+                "selected": false
+              }
@@ -149 +188 @@ The following example shows a typical score.
-                value: "No. A promotion was not offered by the agent."
+              "value": "No. A promotion was not offered by the agent."
@@ -151 +190,3 @@ The following example shows a typical score.
-            "metadata": { "notApplicable": false }
+            "metadata": {
+              "notApplicable": false
+            }
@@ -153 +194,3 @@ The following example shows a typical score.
-          "score": { "percentage": 100 }
+          "score": {
+            "percentage": 100
+          }
@@ -163 +206,3 @@ The following example shows a typical score.
-            "metadata": { "notApplicable": false }
+            "metadata": {
+              "notApplicable": false
+            }
@@ -165 +210,3 @@ The following example shows a typical score.
-          "score": { "notApplicable": true }
+          "score": {
+            "percentage": 50
+          }
@@ -262,0 +310,11 @@ _Type_ – Timestamp
+_Example_ – 2025-11-14T17:57:08.649Z
+
+**evaluationSubmitTimestamp**
+    
+
+The evaluation's submission timestamp.
+
+_Type_ – Timestamp
+
+_Example_ – 2025-11-14T17:59:29.052Z
+
@@ -306,0 +365,50 @@ Valid values:
+**evaluationType**
+    
+
+The type of evaluation.
+
+_Type_ – String
+
+Valid values:
+
+  * `CONTACT_EVALUATION` \- evaluation of a contact.
+
+
+
+
+**calibrationSessionId**
+    
+
+The identifier of the calibration session associated with this evaluation.
+
+_Type_ – String
+
+_Length constraints_ – Minimum length of 1, maximum length of 500
+
+**evaluatedParticipantId**
+    
+
+The identifier of the participant being evaluated.
+
+_Type_ – String
+
+_Length constraints_ – Minimum length of 1, maximum length of 256
+
+**evaluatedParticipantRole**
+    
+
+The role of the participant being evaluated.
+
+_Type_ – String
+
+Valid values:
+
+  * `AGENT` \- the agent participant.
+
+  * `CUSTOMER` \- the customer participant.
+
+  * `SYSTEM` \- the system participant.
+
+
+
+
@@ -338,0 +447,2 @@ _Type_ – Timestamp
+_Example_ – 2025-12-24T15:45:56.662Z
+
@@ -546 +656 @@ The following example shows a typical exported evaluation.
-    "schemaVersion": "3.1",
+      "schemaVersion": "3.5",
@@ -549 +658,0 @@ The following example shows a typical exported evaluation.
-        "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb",
@@ -551,0 +661 @@ The following example shows a typical exported evaluation.
+        "contactId": "badd4896-75f7-43b3-bee6-c617ed3d04cb",
@@ -553 +663 @@ The following example shows a typical exported evaluation.
-        "evaluationDefinitionTitle": "Compliance Evaluation Form",
+        "evaluationDefinitionTitle": "Legal Compliance Evaluation Form",
@@ -559,2 +669,3 @@ The following example shows a typical exported evaluation.
-        "score": { "percentage": 100 },
-        "creator": "john",
+        "score": {
+          "percentage": 85
+        },
@@ -561,0 +673 @@ The following example shows a typical exported evaluation.