AWSSupport-AssociatePhoneNumbersToConnectContactFlows - AWS Systems Manager 자동화 런북 참조

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWSSupport-AssociatePhoneNumbersToConnectContactFlows

설명

전화번호를 Amazon Connect 인스턴스의 통화 흐름에 연결하는 AWSSupport-AssociatePhoneNumbersToConnectContactFlows 데 도움이 됩니다. 전화 번호와 통화 흐름의 매핑을 입력 CSV (쉼표로 구분된 값) 파일에 제공함으로써 런북은 14.5분 내에 가능한 한 많은 전화 번호를 통화 흐름에 연결합니다. 런북은 제한 시간 내에 연결할 수 없었던 모든 전화 번호 및 통화 흐름 쌍이 포함된 CSV 파일을 생성하므로 다음 실행 시 입력할 수 있습니다.

어떻게 작동하나요?

런북을 AWSSupport-AssociatePhoneNumbersToConnectContactFlows 사용하면 Amazon Simple Storage Service (Amazon S3) 버킷에 저장된 매핑 데이터의 CSV 파일을 사용하여 Amazon Connect 인스턴스의 통화 흐름에 전화번호를 연결할 수 있습니다. 입력 CSV 파일은 E.164 형식의 PhoneNumber 값을 사용하여 다음 형식에 맞게 정렬되어야 합니다.

입력 CSV 파일의 예

PhoneNumber,ContactFlowName +1800555xxxx,ContactFlowA +1800555yyyy,ContactFlowB +1800555zzzz,ContactFlowC

또한 자동화 런북은 및 에 지정된 대상 위치에 다음 파일을 생성합니다. DestinationFileBucket DestinationFilePath

  • automation:EXECUTION_ID/ResourceIdList.csv: AssociatePhoneNumberContactFlow API에 필요한 PhoneNumberIdContactFlowId 쌍이 들어 있는 임시 파일입니다.

  • automation:EXECUTION_ID/ErrorResourceList.csv: 의 형식과 같은 오류로 인해 처리할 수 없었던 전화 번호와 통화 흐름 쌍이 들어 ResourceNotFoundException 있는 PhoneNumber,ContactFlowName,ErrorMessage 파일입니다.

  • automation:EXECUTION_ID/NonProcessedResourceList.csv: 처리되지 않은 전화 번호와 통화 흐름 쌍이 포함된 파일입니다. 런북은 14.5분 ( AWS Lambda 함수 타임아웃 15분 - 버퍼 30초) 내에 최대한 많은 전화번호와 통화 흐름을 처리하려고 합니다. 시간 제약으로 인해 처리할 수 없는 전화 번호/통화 흐름이 있는 경우 런북은 이를 다음 런북 실행 시 입력으로 사용할 수 있도록 CSV 파일에 포함합니다.

문서 유형

자동화

소유자

Amazon

플랫폼

Linux, macOS, Windows

Parameters

필수 IAM 권한

실행서를 성공적으로 사용하려면 AutomationAssumeRole 파라미터에 다음 작업이 필요합니다.

{ "Statement": [ { "Action": [ "s3:GetBucketPublicAccessBlock", "s3:GetBucketPolicyStatus", "s3:GetBucketAcl", "s3:GetObject", "s3:GetObjectAttributes", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": [ "arn:aws:s3:::YOUR-BUCKET/*", "arn:aws:s3:::YOUR-BUCKET" ], "Effect": "Allow" }, { "Action": [ "cloudformation:CreateStack", "cloudformation:DescribeStacks", "cloudformation:DeleteStack", "iam:CreateRole", "iam:DeleteRole", "iam:DeleteRolePolicy", "iam:GetRole", "iam:PutRolePolicy", "lambda:CreateFunction", "lambda:DeleteFunction", "lambda:GetFunction", "lambda:InvokeFunction", "lambda:TagResource", "connect:AssociatePhoneNumberContactFlow", "logs:CreateLogGroup", "logs:TagResource", "logs:PutRetentionPolicy", "logs:DeleteLogGroup", "s3:GetAccountPublicAccessBlock" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "connect:DescribeInstance", "connect:ListPhoneNumbers", "connect:ListContactFlows", "ds:DescribeDirectories" ], "Resource": "*", "Effect": "Allow" }, { "Condition": { "StringLikeIfExists": { "iam:PassedToService": [ "ssm.amazonaws.com", "lambda.amazonaws.com" ] } }, "Action": [ "iam:PassRole" ], "Resource": "*", "Effect": "Allow" } ] }

지침

다음 단계에 따라 자동화를 구성합니다.

  1. Systems AWSSupport-AssociatePhoneNumbersToConnectContactFlowsManager의 문서 아래로 이동합니다.

  2. Execute automation(자동화 실행)을 선택합니다.

  3. 입력 매개변수에 다음을 입력합니다.

    • AutomationAssumeRole (선택 사항)

      Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 하는 AWS AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름 (ARN). 역할이 지정되지 않은 경우 Systems Manager Automation은 이 런북을 시작하는 사용자의 권한을 사용합니다.

    • ConnectInstanceId (필수)

      아마존 커넥트 인스턴스의 ID.

    • SourceFileBucket (필수)

      전화번호와 통화 흐름 쌍이 포함된 CSV 파일을 저장하는 Amazon S3 버킷입니다.

    • SourceFilePath (필수)

      전화번호와 통화 흐름 쌍이 포함된 CSV 파일의 Amazon S3 객체 키입니다. 예를 들어 path/to/input.csv입니다.

    • DestinationFileBucket (필수)

      자동화가 중간 파일 및 결과 보고서를 배치할 Amazon S3 버킷입니다.

    • DestinationFilePath (선택 사항)

      중간 파일 및 결과 보고서가 저장되어야 하는 Amazon S3 객체 경로입니다. DestinationFileBucket 예를 들어path/to/files/, 지정하면 파일이 에 저장됩니다s3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/.

    • S3 BucketOwnerAccount (선택 사항)

      통화 흐름 로그를 업로드하려는 Amazon S3 버킷을 소유한 AWS 계정 번호입니다. 이 파라미터를 지정하지 않으면 Runbook은 자동화가 실행되는 사용자 또는 역할의 AWS 계정 ID를 사용합니다.

    • S3 BucketOwnerRoleArn (선택 사항)

      Amazon S3 버킷 및 계정 블록 공개 액세스 설정, 버킷 암호화 구성, 버킷 ACL, 버킷 정책 상태를 가져오고 버킷에 객체를 업로드할 권한이 있는 IAM 역할의 ARN. 이 파라미터가 지정되지 않은 경우, 런북은 이 런북을 시작하는 사용자 AutomationAssumeRole (지정된 경우) 또는 사용자 (지정되지 않은 경우AutomationAssumeRole) 를 사용합니다. 실행서 설명의 필수 권한 섹션을 참조하세요.

  4. 실행을 선택합니다.

  5. 자동화가 시작됩니다.

  6. 문서는 다음 단계를 수행합니다.

    • CheckConnectInstanceExistance

      에서 제공한 Amazon Connect 인스턴스가 ConnectInstanceId 존재하는지 확인합니다.

    • 체크 S3 BucketPublicStatus

      에 지정된 Amazon S3 버킷이 SourceFileBucket 익명 또는 공개 읽기 또는 쓰기 액세스 권한을 DestinationFileBucket 허용하는지 확인합니다.

    • CheckSourceFileExistenceAndSize

      에서 지정한 소스 CSV 파일이 SourceFilePath 존재하는지, 파일 크기가 25MiB 제한을 초과하는지 확인합니다.

    • GenerateResourceIdMap

      및 ID SourceFilePath 및 각 리소스에 지정된 소스 CSV 파일을 PhoneNumberId 다운로드합니다ContactFlowId. 완료되면,,, 가 포함된 PhoneNumber CSV 파일을 에서 지정한 대상 Amazon S3 ContactFlowId 버킷에 업로드합니다. PhoneNumberId ContactFlowName DestinationFileBucket 특정 숫자를 PhoneNumberId 식별할 수 없는 경우 CSV 파일에서 해당 파일은 비어 있게 됩니다.

    • AssociatePhoneNumbersToContactFlows

      AWS CloudFormation 스택을 사용하여 계정에 AWS Lambda 함수를 생성합니다. AWS Lambda 함수는 각 숫자를 SourceFileBucket SourceFilePath 및 에 지정된 소스 CSV 파일에 나열된 통화 흐름에 연결하고 AWS CloudFormation 스택은 함수를 호출합니다. 이 AWS Lambda 함수는 제한 시간이 초과되기 전 (15분) 가능한 한 많은 전화 번호를 통화 흐름에 매핑합니다. 오류로 인해 처리하지 못한 전화번호 및 통화 흐름 목록이 업로드됩니다[automation:EXECUTION_ID]/ErrorResourceList.csv. 한 번의 실행으로 처리할 수 있는 최대 전화번호 수를 초과하여 처리할 수 없었던 전화번호는 에 업로드됩니다[automation:EXECUTION_ID]/NonProcessedResourceList.csv. 이 단계가 실패하면 AWS CloudFormation 스택 이벤트에서 실패한 이유를 보여주는 DescribeCloudFormationErrorFromStackEvents 단계로 이동합니다.

    • WaitForPhoneNumberContactFlowAssociationCompletion

      전화 번호를 통화 흐름에 매핑하는 AWS Lambda 함수가 생성되고 AWS CloudFormation 스택이 호출을 완료할 때까지 기다립니다.

    • GenerateReport

      통화 흐름에 매핑된 전화 번호 수, 오류로 인해 처리할 수 없는 전화 번호 및 단일 실행으로 처리할 수 있는 최대 전화 번호 수를 초과하여 처리할 수 없는 전화 번호가 포함된 보고서를 생성합니다. 보고서에는 [automation:EXECUTION_ID]/ErrorResourceList.csv 또는 [automation:EXECUTION_ID]/NonProcessedResourceList.csv 해당하는 경우 위치 (Amazon S3 URI 및 Amazon S3 콘솔 URL) 도 표시됩니다.

    • DeleteCloudFormationStack

      매핑을 위한 Lambda 함수를 포함하여 AWS CloudFormation 스택을 삭제합니다.

    • DescribeCloudFormationErrorFromStackEvent

      단계 AWS CloudFormation 스택의 오류를 설명합니다. AssociatePhoneNumbersToContactFlows

  7. 완료 후 출력 섹션에서 실행의 세부 결과를 검토하십시오.

    • GenerateReport.OutputPayload

      전화번호 및 통화 흐름 연결 출력 이 보고서에는 다음 정보가 포함됩니다.

      • 입력 CSV 파일에 나열된 전화번호 및 통화 흐름 쌍의 수

      • 입력 CSV 파일에 지정된 통화 흐름과 관련된 전화번호 수

      • 오류로 인해 통화 흐름에 연결할 수 없는 전화번호 수

      • 시간 제약으로 인해 통화 흐름과 연결되지 않은 전화번호 수

      • 오류로 인해 연결할 수 없는 전화 번호와 통화 흐름 쌍이 포함된 CSV 파일의 위치 (Amazon S3 URI 및 Amazon S3 콘솔 URL)

      • 시간 제약으로 인해 연결되지 않은 전화 번호와 통화 흐름 쌍이 포함된 CSV 파일의 위치 (Amazon S3 URI 및 Amazon S3 콘솔 URL)

    • DescribeCloudFormationErrorFromStackEvents.Events

      AssociatePhoneNumbersToContactFlows단계가 실패할 경우 AWS CloudFormation 스택 이벤트를 표시하는 출력입니다.

적은 수의 전화번호와 통화 흐름을 사용한 실행 출력

오류나 시간 제약으로 인해 연결되지 않은 전화 번호, 통화 흐름 및 전화 번호가 많이 포함된 실행 결과

참조

Systems Manager Automation