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
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 berisiPhoneNumberId
danContactFlowId
pasangan yang diperlukan untukAssociatePhoneNumberContactFlow
API. -
automation:EXECUTION_ID/ErrorResourceList.csv
: File yang berisi nomor telepon dan pasangan aliran kontak yang tidak dapat diproses karena kesalahan, sepertiResourceNotFoundException
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
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" } ] }
Instruksi
Ikuti langkah-langkah ini untuk mengonfigurasi otomatisasi:
-
Arahkan ke
AWSSupport-AssociatePhoneNumbersToConnectContactFlows
Systems 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 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, ACL bucket, status kebijakan bucket, dan mengunggah objek ke bucket. Jika parameter ini tidak ditentukan, runbook menggunakan
AutomationAssumeRole
(jika ditentukan) atau pengguna yang memulai runbook ini (jika tidakAutomationAssumeRole
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
danDestinationFileBucket
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 mengidentifikasiPhoneNumberId
danContactFlowId
untuk setiap sumber daya. Setelah selesai, ia mengunggah file CSV yang berisiPhoneNumber
,,PhoneNumberId
ContactFlowName
, danContactFlowId
ke bucket Amazon S3 tujuan yang ditentukan.DestinationFileBucket
JikaPhoneNumberId
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
danSourceFilePath
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 keDescribeCloudFormationErrorFromStackEvents
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.
-
-
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
![](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
![](images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_many.png)
Referensi
Otomatisasi Systems Manager