`AWSSupport-AssociatePhoneNumbersToConnectContactFlows`

Deskripsi

AWSSupport-AssociatePhoneNumbersToConnectContactFlowsIni membantu Anda mengaitkan nomor telepon ke alur kontak di instans Amazon Connect Anda. Dengan menyediakan pemetaan nomor telepon dan alur kontak dalam file nilai (CSV) yang dipisahkan koma input, buku runbook mengaitkan sebanyak mungkin nomor telepon ke arus kontak dalam waktu 14,5 menit. Runbook menghasilkan CSV file dari semua nomor telepon dan pasangan alur 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 CSV file data pemetaan yang disimpan dalam bucket Amazon Simple Storage Service (Amazon S3). CSVFile input harus sejajar dengan format berikut, dengan PhoneNumber nilai dalam format E.164.

Contoh CSV file input


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

Runbook otomatisasi juga membuat file berikut di lokasi tujuan yang ditentukan dalam DestinationFileBucket danDestinationFilePath.

automation:EXECUTION_ID/ResourceIdList.csv: File sementara yang berisi PhoneNumberId dan ContactFlowId pasangan yang diperlukan untuk file AssociatePhoneNumberContactFlowAPI.
automation:EXECUTION_ID/ErrorResourceList.csv: File yang berisi nomor telepon dan pasangan aliran kontak yang tidak dapat diproses karena kesalahan, seperti ResourceNotFoundException dalam formatPhoneNumber,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 memasukkannya ke dalam CSV file yang akan digunakan sebagai input untuk eksekusi runbook berikutnya.

Jenis dokumen

Otomatisasi

Pemilik

Amazon

Platform

Linux,macOS, Windows

Parameter

IAMIzin yang diperlukan

AutomationAssumeRoleParameter 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"
                }
            ]
        }

Instruksi

Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi:

Arahkan ke AWSSupport-AssociatePhoneNumbersToConnectContactFlowsSystems Manager di bawah Dokumen.
Pilih Jalankan otomatisasi.
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 CSV file yang berisi nomor telepon dan pasangan aliran kontak.
- SourceFilePath (Diperlukan)
  
  Kunci objek Amazon S3 dari CSV file 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 menentukanpath/to/files/, file disimpan di bawahs3://[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)
  
  ARNIAMPeran dengan izin untuk mendapatkan bucket Amazon S3 dan pengaturan pemblokiran akun akses publik, konfigurasi enkripsi bucket, bucket, status kebijakan ACLs bucket, 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.
Pilih Jalankan.
Otomatisasi dimulai.
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 CSV file sumber yang ditentukan dalam SourceFilePath ada dan jika ukuran file melebihi batas 25 MiB.
- GenerateResourceIdMap
  
  Mengunduh CSV file sumber yang ditentukan dalam SourceFilePath dan mengidentifikasi PhoneNumberId dan ContactFlowId untuk setiap sumber daya. Setelah selesai, ia mengunggah CSV file yang berisiPhoneNumber,, PhoneNumberIdContactFlowName, dan ContactFlowId ke bucket Amazon S3 tujuan yang ditentukan. DestinationFileBucket Jika PhoneNumberId tidak dapat diidentifikasi untuk nomor tertentu, yang diajukan akan kosong dalam CSV file.
- AssociatePhoneNumbersToContactFlows
  
  Membuat AWS Lambda fungsi di akun Anda menggunakan AWS CloudFormation tumpukan. AWS Lambda Fungsi mengaitkan setiap nomor ke alur kontak yang tercantum dalam CSV file sumber yang ditentukan dalam SourceFileBucket 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 tersebut juga menunjukkan lokasi (Amazon S3 URI 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.
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 nomor telepon dan pasangan aliran kontak yang tercantum dalam CSV file input
  - Jumlah nomor telepon yang terkait dengan alur kontak sebagaimana ditentukan dalam CSV file 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 (URLkonsol Amazon S3 URI dan Amazon S3) dari file CSV yang berisi nomor telepon dan pasangan aliran kontak yang tidak dapat dikaitkan karena kesalahan
  - Lokasi (Amazon S3 URI dan Amazon S3 URL Console) dari file CSV yang berisi nomor telepon dan pasangan alur kontak yang tidak terkait karena keterbatasan waktu
- DescribeCloudFormationErrorFromStackEvents.Acara
  
  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.

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.

Referensi

Otomatisasi Systems Manager

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Amazon Connect

AWSSupport-CollectAmazonConnectContactFlowLog