AWS CloudFormationで、コンタクト終了後にAmazon Connectパフォーマンス評価を自動で行うルールを作成してみた

			
			$ aws connect list-evaluation-forms \
    --instance-id 3ff2093d-af96-43fd-b038-3c07cdd7609c \
    --region ap-northeast-1
{
    "EvaluationFormSummaryList": [
        {
            "EvaluationFormId": "78d88714-7b2c-4f25-8d55-4638a5ece4c0",
            "EvaluationFormArn": "arn:aws:connect:ap-northeast-1:111111111111:instance/3ff2093d-af96-43fd-b038-3c07cdd7609c/evaluation-form/78d88714-7b2c-4f25-8d55-4638a5ece4c0",
            "Title": "カスタマーサービス評価フォーム",
            "CreatedTime": "2025-09-04T02:22:35.069000+00:00",
            "CreatedBy": "arn:aws:sts::111111111111:assumed-role/cm-hirai.yuji-Read/cm-hirai.yuji",
            "LastModifiedTime": "2025-09-08T23:55:45.020000+00:00",
            "LastModifiedBy": "arn:aws:connect:ap-northeast-1:111111111111:instance/3ff2093d-af96-43fd-b038-3c07cdd7609c/agent/104b4727-a2ef-4f12-8daf-6068ce627667",
            "LastActivatedTime": "2025-09-08T23:55:45.020000+00:00",
            "LastActivatedBy": "hirai",
            "LatestVersion": 2,
            "ActiveVersion": 2
        },

		

			
			AWSTemplateFormatVersion: '2010-09-09'
Description: 'CloudFormation template for Amazon Connect Contact Lens auto-evaluation rules'

Parameters:
  ConnectInstanceArn:
    Type: String
    Description: ARN of the Amazon Connect instance
    AllowedPattern: '^arn:aws[-a-z0-9]*:connect:[-a-z0-9]*:[0-9]{12}:instance/[-a-zA-Z0-9]*$'

  EvaluationFormArn:
    Type: String
    Description: ARN of the evaluation form for auto-evaluation
    AllowedPattern: '^arn:aws[-a-z0-9]*:connect:[-a-z0-9]*:[0-9]{12}:instance/[-a-zA-Z0-9]*/evaluation-form/[-a-zA-Z0-9]*$'

  RuleName:
    Type: String
    Description: Name of the rule
    Default: 'AutoEvaluationRule'
    AllowedPattern: '^[a-zA-Z0-9._-]{1,200}$'

  ContactCategoryName:
    Type: String
    Description: Contact category name for rule identification
    Default: 'AutoEvaluationTriggered'
    MaxLength: 200

  MinAgentInteractionSeconds:
    Type: Number
    Description: Minimum agent interaction duration in seconds
    Default: 1
    MinValue: 1

  PublishStatus:
    Type: String
    Description: Publish status of the rule
    Default: 'PUBLISHED'
    AllowedValues: ['DRAFT', 'PUBLISHED']

Resources:
  # 通話後分析が利用可能になったときに自動評価を実行するルール
  PostCallAutoEvaluationRule:
    Type: AWS::Connect::Rule
    Properties:
      Name: !Sub '${RuleName}-PostCall'
      InstanceArn: !Ref ConnectInstanceArn
      PublishStatus: !Ref PublishStatus
      TriggerEventSource:
        EventSourceName: 'OnPostCallAnalysisAvailable'
      Function: !Sub |
        {
          "Version": "2022-11-25",
          "RuleFunction": {
            "Operator": "AND",
            "Operands": [
              {
                "Operator": "NumberGreaterOrEqualTo",
                "Operands": [${MinAgentInteractionSeconds}],
                "ComparisonValue": "$.ContactLens.PostCall.Agent.AgentInteractionDurationSecs",
                "Negate": false
              }
            ]
          }
        }
      Actions:
        AssignContactCategoryActions:
          - {}
        SubmitAutoEvaluationActions:
          - EvaluationFormArn: !Ref EvaluationFormArn
      Tags:
        - Key: 'Purpose'
          Value: 'AutoEvaluation'
        - Key: 'CreatedBy'
          Value: 'CloudFormation'

  # チャット後分析が利用可能になったときに自動評価を実行するルール
  PostChatAutoEvaluationRule:
    Type: AWS::Connect::Rule
    Properties:
      Name: !Sub '${RuleName}-PostChat'
      InstanceArn: !Ref ConnectInstanceArn
      PublishStatus: !Ref PublishStatus
      TriggerEventSource:
        EventSourceName: 'OnPostChatAnalysisAvailable'
      Function: !Sub |
        {
          "Version": "2022-11-25",
          "RuleFunction": {
            "Operator": "AND",
            "Operands": [
              {
                "Operator": "NumberGreaterOrEqualTo",
                "Operands": [${MinAgentInteractionSeconds}],
                "ComparisonValue": "$.ContactLens.PostChat.Agent.AgentInteractionDurationSecs",
                "Negate": false
              }
            ]
          }
        }
      Actions:
        AssignContactCategoryActions:
          - {}
        SubmitAutoEvaluationActions:
          - EvaluationFormArn: !Ref EvaluationFormArn
      Tags:
        - Key: 'Purpose'
          Value: 'AutoEvaluation'
        - Key: 'CreatedBy'
          Value: 'CloudFormation'

Outputs:
  PostCallRuleArn:
    Description: 'ARN of the post-call auto-evaluation rule'
    Value: !Ref PostCallAutoEvaluationRule.RuleArn
    Export:
      Name: !Sub '${AWS::StackName}-PostCallRuleArn'

  PostChatRuleArn:
    Description: 'ARN of the post-chat auto-evaluation rule'
    Value: !Ref PostChatAutoEvaluationRule.RuleArn
    Export:
      Name: !Sub '${AWS::StackName}-PostChatRuleArn'