AWSSupport-AssociatePhoneNumbersToConnectContactFlows - AWS Systems Manager Referensi buku runbook otomatisasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 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.

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 danDestinationFilePath.

  • 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 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 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

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:

  1. Arahkan ke AWSSupport-AssociatePhoneNumbersToConnectContactFlowsSystems Manager di bawah Dokumen.

  2. Pilih Jalankan otomatisasi.

  3. 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 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)

      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.

    Input parameters form for AWS Systems Manager Automation with fields for roles, S3 buckets, and file paths.

  4. Pilih Jalankan.

  5. Otomatisasi dimulai.

  6. 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 berisiPhoneNumber,, PhoneNumberIdContactFlowName, 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.

  7. 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.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