기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # `AWSSupport-AssociatePhoneNumbersToConnectContactFlows` **설명** 는 Connect Customer 인스턴스의 고객 응대 흐름에 전화번호를 연결하는 데 `AWSSupport-AssociatePhoneNumbersToConnectContactFlows` 도움이 됩니다. 전화번호와 고객 응대 흐름의 매핑을 입력 쉼표로 구분된 값(CSV) 파일에 제공하여 실행서는 14.5분 이내에 가능한 한 많은 전화번호를 고객 응대 흐름에 연결합니다. 실행서는 시간 제한 내에 연결할 수 없는 모든 전화번호 및 고객 응대 흐름 페어의 CSV 파일을 생성하므로 다음 실행에서 입력할 수 있습니다. **어떻게 작동하나요?** 실행서는 Amazon Simple Storage Service(Amazon S3) 버킷에 저장된 매핑 데이터의 CSV 파일을 사용하여 Connect Customer 인스턴스의 고객 응대 흐름에 전화번호를 연결하는 데 `AWSSupport-AssociatePhoneNumbersToConnectContactFlows` 도움이 됩니다. 입력 CSV 파일은 [E.164](https://www.itu.int/rec/T-REC-E.164/en) 형식의 `PhoneNumber` 값과 함께 다음 형식과 일치해야 합니다. **입력 CSV 파일의 예** ``` PhoneNumber,ContactFlowName +1800555xxxx,ContactFlowA +1800555yyyy,ContactFlowB +1800555zzzz,ContactFlowC ``` 또한 자동화 실행서는 `DestinationFileBucket` 및에 지정된 대상 위치에 다음 파일을 생성합니다`DestinationFilePath`. + **`automation:EXECUTION_ID/ResourceIdList.csv`**: `AssociatePhoneNumberContactFlow` API에 필요한 `PhoneNumberId` 및 `ContactFlowId` 페어가 포함된 임시 파일입니다. + **`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 **파라미터** **필수 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" } ] } ``` `LambdaRoleArn` 파라미터를 제공하는 경우 런북을 성공적으로 사용하려면 역할에 다음 작업이 필요합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "logs:CreateLogGroup" ], "Resource": "arn:aws:logs:{{us-east-1}}:{{111122223333}}:*", "Effect": "Allow" }, { "Action": [ "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:{{us-east-1}}:{{111122223333}}:*", "Effect": "Allow" }, { "Action": [ "connect:AssociatePhoneNumberContactFlow" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "s3:PutObject", "s3:GetObject" ], "Resource": "arn:aws:s3:::{{amzn-s3-demo-bucket}}/{{DESTINATION_FILE_PATH}}*", "Effect": "Allow" } ] } ``` ------ **지침** 다음 단계에 따라 자동화를 구성합니다. 1. Systems Manager[https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description)의 문서로 이동합니다. 1. Execute automation(자동화 실행)을 선택합니다. 1. 입력 파라미터에 다음을 입력합니다. + **AutomationAssumeRole(선택 사항)** Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 (IAM) 역할의 Amazon 리소스 이름 AWS AWS Identity and Access Management (ARN)입니다. 역할이 지정되지 않은 경우 Systems Manager Automation은이 실행서를 시작하는 사용자의 권한을 사용합니다. + **ConnectInstanceId(필수)** Connect Customer 인스턴스의 ID입니다. + **SourceFileBucket(필수)** 전화번호와 고객 응대 흐름 페어가 포함된 CSV 파일을 저장하는 Amazon S3 버킷입니다. + **SourceFilePath(필수)** 전화번호와 고객 응대 흐름 페어가 포함된 CSV 파일의 Amazon S3 객체 키입니다. 예를 들어 `path/to/input.csv`입니다. + **DestinationFileBucket(필수)** 자동화가 중간 파일 및 결과 보고서를 배치할 Amazon S3 버킷입니다. + **DestinationFilePath(선택 사항)** 중간 파일 및 결과 보고서를 저장해야 `DestinationFileBucket` 하는 Amazon S3 객체 경로입니다. 예를 들어를 지정하면 `path/to/files/`파일이 아래에 저장됩니다`s3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/`. + **S3BucketOwnerAccount(선택 사항)** 고객 응대 흐름 로그를 업로드하려는 Amazon S3 버킷을 소유한 AWS 계정 번호입니다. 이 파라미터를 지정하지 않으면 실행서는 자동화가 실행되는 사용자 또는 역할의 AWS 계정 ID를 사용합니다. + **S3BucketOwnerRoleArn(선택 사항)** Amazon S3 버킷 및 계정을 가져올 수 있는 권한이 있는 IAM 역할의 ARN은 퍼블릭 액세스 설정, 버킷 암호화 구성, 버킷 ACLs, 버킷 정책 상태 및 버킷에 객체 업로드를 차단합니다. 이 파라미터를 지정하지 않으면 실행서는이 실행서를 시작하는 `AutomationAssumeRole` (지정된 경우) 또는 사용자(지정되지 않은 경우)`AutomationAssumeRole`를 사용합니다. 실행서 설명의 필수 권한 섹션을 참조하세요. + **LambdaRoleArn(선택 사항)** AWS Lambda 함수가 필요한 AWS 서비스 및 리소스에 액세스할 수 있도록 허용하는 IAM 역할의 ARN입니다. 역할이 지정되지 않은 경우이 자동화는 계정에서 Lambda에 대한 IAM 역할을 하나 생성합니다. 1. 실행을 선택합니다. 1. 자동화가 시작됩니다. 1. 문서는 다음 단계를 수행합니다. + **CheckConnectInstanceExistance** 에 제공된 Connect Customer 인스턴스가 `ConnectInstanceId` 존재하는지 확인합니다. + **CheckS3BucketPublicStatus** 에 지정된 Amazon S3 버킷`SourceFileBucket`이 익명 또는 퍼블릭 읽기 또는 쓰기 액세스 권한을 `DestinationFileBucket` 허용하는지 확인합니다. + **CheckSourceFileExistenceAndSize** 에 지정된 소스 CSV 파일이 `SourceFilePath` 있는지, 파일 크기가 25MiB 제한을 초과하는지 확인합니다. + **GenerateResourceIdMap** 에 지정된 소스 CSV 파일을 다운로드`SourceFilePath`하고 각 리소스에 `ContactFlowId` 대해 `PhoneNumberId` 및를 식별합니다. 완료되면 , `PhoneNumber`, `ContactFlowName`및가 포함된 CSV 파일을 `PhoneNumberId`에 지정된 대상 Amazon S3 버킷`ContactFlowId`에 업로드합니다`DestinationFileBucket`. 특정 번호에 대해를 식별할 수 `PhoneNumberId` 없는 경우 CSV 파일에서 필드가 비어 있습니다. + **AssociatePhoneNumbersToContactFlows** AWS CloudFormation 스택을 사용하여 계정에 AWS Lambda 함수를 생성합니다. AWS Lambda 함수는 각 번호를 `SourceFileBucket` 및에 지정된 소스 CSV 파일에 나열된 고객 응대 흐름에 연결하고 AWS CloudFormation 스택`SourceFilePath`은 함수를 호출합니다. AWS Lambda 함수는 제한 시간(15분) 전에 고객 응대 흐름에 최대한 많은 전화번호를 매핑합니다. 오류로 인해 처리할 수 없는 전화번호 및 고객 응대 흐름 목록은에 업로드됩니다`[automation:EXECUTION_ID]/ErrorResourceList.csv`. 단일 실행에서 처리할 수 있는 최대 전화번호 수를 초과하여 처리할 수 없는 전화번호는에 업로드됩니다`[automation:EXECUTION_ID]/NonProcessedResourceList.csv`. 이 단계가 실패하면 `DescribeCloudFormationErrorFromStackEvents` 단계로 이동하여 AWS CloudFormation 스택 이벤트에서 실패한 이유를 표시합니다. + **WaitForPhoneNumberContactFlowAssociationCompletion** 전화번호를 고객 응대 흐름에 매핑하는 AWS Lambda 함수가 생성되고 AWS CloudFormation 스택이 호출을 완료할 때까지 기다립니다. + **GenerateReport** 고객 응대 흐름에 매핑된 전화번호 수, 오류로 인해 처리할 수 없는 전화번호 수, 단일 실행에서 처리할 수 있는 최대 전화번호 수를 초과하여 처리할 수 없는 전화번호 수를 포함하는 보고서를 생성합니다. 보고서에는 해당하는 `[automation:EXECUTION_ID]/NonProcessedResourceList.csv`경우 `[automation:EXECUTION_ID]/ErrorResourceList.csv` 또는의 위치(Amazon S3 URI 및 Amazon S3 콘솔 URL)도 표시됩니다. + **`DeleteCloudFormationStack`** 매핑을 위한 Lambda 함수를 포함하여 AWS CloudFormation 스택을 삭제합니다. + **`DescribeCloudFormationErrorFromStackEvent`** `AssociatePhoneNumbersToContactFlows` 단계 AWS CloudFormation 스택의 오류를 설명합니다. 1. 완료되면 출력 섹션에서 실행의 자세한 결과를 검토합니다. + **GenerateReport.OutputPayload** 전화번호 및 고객 응대 흐름 연결의 출력입니다. 이 보고서에는 다음 정보가 포함되어 있습니다. + 입력 CSV 파일에 나열된 전화번호 및 고객 응대 흐름 페어 수 + 입력 CSV 파일에 지정된 고객 응대 흐름과 연결된 전화번호 수 + 오류로 인해 고객 응대 흐름과 연결할 수 없는 전화번호 수 + 시간 제약으로 인해 고객 응대 흐름과 연결되지 않은 전화번호 수 + 오류로 인해 연결할 수 없는 전화번호 및 고객 응대 흐름 페어가 포함된 CSV 파일의 위치(Amazon S3 URI 및 Amazon S3 콘솔 URL) + 시간 제약으로 인해 연결되지 않은 전화번호 및 고객 응대 흐름 페어가 포함된 CSV 파일의 위치(Amazon S3 URI 및 Amazon S3 콘솔 URL) + **DescribeCloudFormationErrorFromStackEvents.Events** `AssociatePhoneNumbersToContactFlows` 단계가 실패할 경우 AWS CloudFormation 스택 이벤트를 표시하는 출력입니다. 전화번호와 고객 응대 흐름이 적은 실행 출력 ![고객 응대 흐름으로 처리된 전화번호 7개, 오류 0개, 시간 제약 문제 0개를 보여주는 출력입니다.](http://docs.aws.amazon.com/ko_kr/systems-manager-automation-runbooks/latest/userguide/images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_small.png) 오류 또는 시간 제약으로 인해 연결되지 않은 전화번호와 고객 응대 흐름 및 전화번호가 많은 실행 출력 ![오류 및 처리되지 않은 리소스 파일 위치가 있는 전화번호 매핑 결과를 보여주는 출력입니다.](http://docs.aws.amazon.com/ko_kr/systems-manager-automation-runbooks/latest/userguide/images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_many.png) **참조** Systems Manager Automation + [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description) + [자동화 실행](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) + [Automation 설정](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [Support Automation Workflows 랜딩 페이지](https://aws.amazon.com/premiumsupport/technology/saw/)