Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # `AWSSupport-AssociatePhoneNumbersToConnectContactFlows` **Deskripsi** `AWSSupport-AssociatePhoneNumbersToConnectContactFlows`Ini membantu Anda mengaitkan nomor telepon ke alur kontak di instans Amazon Connect Anda. Dengan menyediakan pemetaan nomor telepon dan alur kontak dalam file input comma-separated values (CSV), runbook mengaitkan sebanyak mungkin nomor telepon ke arus kontak dalam waktu 14,5 menit. Runbook menghasilkan file CSV dari semua nomor telepon dan pasangan aliran kontak yang tidak dapat dikaitkan dalam batas waktu sehingga Anda dapat memasukkannya dalam proses berikutnya. **Bagaimana cara kerjanya?** Runbook `AWSSupport-AssociatePhoneNumbersToConnectContactFlows` membantu Anda mengaitkan nomor telepon ke alur kontak di instans Amazon Connect menggunakan file CSV untuk memetakan data yang disimpan dalam bucket Amazon Simple Storage Service (Amazon S3). File CSV input harus sejajar dengan format berikut, dengan `PhoneNumber` nilai dalam format [E.164](https://www.itu.int/rec/T-REC-E.164/en). **Contoh file CSV masukan** ``` PhoneNumber,ContactFlowName +1800555xxxx,ContactFlowA +1800555yyyy,ContactFlowB +1800555zzzz,ContactFlowC ``` Runbook otomatisasi juga membuat file berikut di lokasi tujuan yang ditentukan dalam `DestinationFileBucket` dan`DestinationFilePath`. + **`automation:EXECUTION_ID/ResourceIdList.csv`**: File sementara yang berisi `PhoneNumberId` dan `ContactFlowId` pasangan yang diperlukan untuk `AssociatePhoneNumberContactFlow` API. + **`automation:EXECUTION_ID/ErrorResourceList.csv`**: File yang berisi nomor telepon dan pasangan aliran kontak yang tidak dapat diproses karena kesalahan, seperti `ResourceNotFoundException` dalam format`PhoneNumber,ContactFlowName,ErrorMessage`. + **`automation:EXECUTION_ID/NonProcessedResourceList.csv`**: File yang berisi nomor telepon dan pasangan alur kontak yang tidak diproses. Runbook mencoba memproses nomor telepon dan arus kontak sebanyak mungkin dalam 14,5 menit (15 menit waktu tunggu AWS Lambda fungsi - 30 detik buffer). Jika ada beberapa nomor telepon/alur kontak yang tidak dapat diproses karena keterbatasan waktu, runbook menyertakannya dalam file CSV untuk digunakan sebagai input untuk eksekusi runbook berikutnya. **Jenis dokumen** Otomatisasi **Pemilik** Amazon **Platform** Linux,macOS, Windows **Parameter** **Izin IAM yang diperlukan** `AutomationAssumeRole`Parameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses. ``` { "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" } ] } ``` Jika memberikan `LambdaRoleArn` parameter, peran memerlukan tindakan berikut agar berhasil menggunakan runbook. ------ #### [ 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" } ] } ``` ------ **Instruksi** Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi: 1. Arahkan ke [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description)Systems Manager di bawah Documents. 1. Pilih Jalankan otomatisasi. 1. Untuk parameter input, masukkan yang berikut ini: + **AutomationAssumeRole (Opsional)** Nama Sumber Daya Amazon (ARN) dari peran AWS AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini. + **ConnectInstanceId (Diperlukan)** ID instans Amazon Connect Anda. + **SourceFileBucket (Diperlukan)** Bucket Amazon S3 yang menyimpan file CSV yang berisi nomor telepon dan pasangan alur kontak. + **SourceFilePath (Diperlukan)** Kunci objek Amazon S3 dari file CSV yang berisi nomor telepon dan pasangan aliran kontak. Misalnya, `path/to/input.csv`. + **DestinationFileBucket (Diperlukan)** Bucket Amazon S3 di mana otomatisasi akan menempatkan file perantara dan laporan hasil. + **DestinationFilePath (Opsional)** Jalur objek Amazon S3 `DestinationFileBucket` di mana file perantara dan laporan hasil harus disimpan. Misalnya, jika Anda menentukan`path/to/files/`, file disimpan di bawah`s3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/`. + **S3 BucketOwnerAccount (Opsional)** Nomor AWS Akun yang memiliki bucket Amazon S3 tempat Anda ingin mengunggah Log Aliran Kontak. Jika Anda tidak menentukan parameter ini, runbook menggunakan ID AWS akun pengguna atau peran di mana Otomasi berjalan. + **S3 BucketOwnerRoleArn (Opsional)** ARN peran IAM dengan izin untuk mendapatkan bucket Amazon S3 dan pengaturan pemblokiran akun akses publik, konfigurasi enkripsi bucket, bucket, status kebijakan bucket ACLs, dan mengunggah objek ke bucket. Jika parameter ini tidak ditentukan, runbook menggunakan `AutomationAssumeRole` (jika ditentukan) atau pengguna yang memulai runbook ini (jika tidak `AutomationAssumeRole` ditentukan). Silakan lihat bagian izin yang diperlukan di deskripsi buku runbook. + **LambdaRoleArn (Opsional)** ARN dari peran IAM yang memungkinkan AWS Lambda fungsi untuk mengakses AWS layanan dan sumber daya yang diperlukan. Jika tidak ada peran yang ditentukan, otomatisasi ini akan membuat satu peran IAM untuk Lambda di akun Anda. 1. Pilih Jalankan. 1. Otomatisasi dimulai. 1. Dokumen melakukan langkah-langkah berikut: + **CheckConnectInstanceExistance** Memeriksa apakah instans Amazon Connect yang disediakan `ConnectInstanceId` ada. + **Ceks3 BucketPublicStatus** Memeriksa apakah bucket Amazon S3 ditentukan dalam `SourceFileBucket` dan `DestinationFileBucket` mengizinkan izin akses baca atau tulis anonim atau publik. + **CheckSourceFileExistenceAndSize** Memeriksa apakah file CSV sumber yang ditentukan dalam `SourceFilePath` ada dan jika ukuran file melebihi batas 25 MiB. + **GenerateResourceIdMap** Mengunduh file CSV sumber yang ditentukan dalam `SourceFilePath` dan mengidentifikasi `PhoneNumberId` dan `ContactFlowId` untuk setiap sumber daya. Setelah selesai, ia mengunggah file CSV yang berisi`PhoneNumber`,, `PhoneNumberId``ContactFlowName`, dan `ContactFlowId` ke bucket Amazon S3 tujuan yang ditentukan. `DestinationFileBucket` Jika `PhoneNumberId` tidak dapat diidentifikasi untuk nomor tertentu, yang diajukan akan kosong di file CSV. + **AssociatePhoneNumbersToContactFlows** Membuat AWS Lambda fungsi di akun Anda menggunakan AWS CloudFormation tumpukan. AWS Lambda Fungsi ini mengaitkan setiap nomor ke alur kontak yang tercantum dalam file CSV sumber yang ditentukan dalam `SourceFileBucket` dan `SourceFilePath` dan AWS CloudFormation tumpukan memanggil fungsi. AWS Lambda Fungsi memetakan nomor telepon sebanyak mungkin untuk menghubungi arus sebelum waktu habis (15 menit). Daftar nomor telepon dan alur kontak yang tidak dapat diproses karena kesalahan diunggah. `[automation:EXECUTION_ID]/ErrorResourceList.csv` Yang tidak dapat diproses karena kelebihan jumlah maksimum nomor telepon yang dapat diproses dalam satu eksekusi diunggah. `[automation:EXECUTION_ID]/NonProcessedResourceList.csv` Jika langkah ini gagal, lanjutkan ke `DescribeCloudFormationErrorFromStackEvents` langkah untuk menunjukkan mengapa gagal dari peristiwa AWS CloudFormation tumpukan. + **WaitForPhoneNumberContactFlowAssociationCompletion** Menunggu hingga AWS Lambda fungsi yang memetakan nomor telepon ke alur kontak dibuat dan AWS CloudFormation tumpukan menyelesaikan pemanggilannya. + **GenerateReport** Menghasilkan laporan yang berisi jumlah nomor telepon yang dipetakan ke arus kontak, yang tidak dapat diproses karena kesalahan, dan yang tidak dapat diproses karena kelebihan jumlah maksimum nomor telepon yang dapat diproses dalam eksekusi tunggal. Laporan ini juga menunjukkan lokasi (URI Amazon S3 dan URL konsol Amazon S3) `[automation:EXECUTION_ID]/ErrorResourceList.csv` untuk `[automation:EXECUTION_ID]/NonProcessedResourceList.csv` atau, jika berlaku. + **`DeleteCloudFormationStack`** Menghapus AWS CloudFormation tumpukan, termasuk fungsi Lambda untuk pemetaan. + **`DescribeCloudFormationErrorFromStackEvent`** Menjelaskan kesalahan dari AWS CloudFormation tumpukan `AssociatePhoneNumbersToContactFlows` langkah. 1. Setelah selesai, tinjau bagian Output untuk hasil eksekusi yang terperinci: + **GenerateReport.OutputPayload** Output nomor telepon dan asosiasi aliran kontak. Laporan ini berisi informasi berikut: + Jumlah pasangan nomor telepon dan alur kontak yang tercantum dalam file CSV masukan + Jumlah nomor telepon yang terkait dengan alur kontak sebagaimana ditentukan dalam file CSV input + Jumlah nomor telepon yang tidak dapat dikaitkan dengan arus kontak karena kesalahan + Jumlah nomor telepon yang tidak terkait dengan arus kontak karena keterbatasan waktu + Lokasi (Amazon S3 URI dan URL konsol Amazon S3) dari file CSV yang berisi nomor telepon dan pasangan alur kontak yang tidak dapat dikaitkan karena kesalahan + Lokasi (URI Amazon S3 dan URL Konsol Amazon S3) dari file CSV yang berisi nomor telepon dan pasangan alur kontak yang tidak terkait karena keterbatasan waktu + **DescribeCloudFormationErrorFromStackEvents.Events** Output yang menunjukkan peristiwa AWS CloudFormation tumpukan jika `AssociatePhoneNumbersToContactFlows` langkah gagal. Output eksekusi dengan sejumlah kecil nomor telepon dan arus kontak ![\[Report showing 7 phone numbers processed successfully with no errors or time constraints.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_small.png) Output eksekusi dengan sejumlah besar nomor telepon dan alur kontak dan nomor telepon yang tidak terkait karena kesalahan atau kendala waktu ![\[Amazon Connect phone number mapping results showing processed and unprocessed contacts.\]](http://docs.aws.amazon.com/id_id/systems-manager-automation-runbooks/latest/userguide/images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_many.png) **Referensi** Otomatisasi Systems Manager + [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description) + [Jalankan otomatisasi](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) + [Menyiapkan Otomasi](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [Support Automation Workflow landing page](https://aws.amazon.com/premiumsupport/technology/saw/)