Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Klaim nomor telepon ke grup distribusi lalu lintas menggunakan Connect Customer
**catatan**
**Pengguna baru? ** Lihat Lokakarya [ Ketahanan Global ](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US) Connect Customer. Kursus online ini memandu Anda melalui proses orientasi dan pengujian nomor telepon dan failover agen menggunakan API baru melalui AWS CLI.
Ketahanan Global hanya tersedia untuk instans Connect Customer yang dibuat di Wil AWS ayah berikut: AS Timur (Virginia Utara), AS Barat (Oregon), Asia Pasifik (Osaka), Asia Pasifik (Tokyo), Eropa (Frankfurt), dan Eropa (London).
Anda hanya dapat membuat replika di Wilayah AS Timur (Virginia Utara) jika sumber Anda adalah AS Barat (Oregon), atau sebaliknya.
Anda hanya dapat membuat replika di Wilayah Eropa (Frankfurt) jika sumber Anda adalah Eropa (London), atau sebaliknya.
Anda hanya dapat membuat replika di Wilayah Asia Pasifik (Osaka) jika sumber Anda adalah Asia Pasifik (Tokyo).
Untuk mendapatkan akses ke fitur ini, hubungi Arsitek Solusi Pelanggan Connect atau Manajer Akun Teknis Anda.
Setelah grup distribusi lalu lintas berhasil dibuat (`Status`is`ACTIVE`), Anda dapat menggunakannya [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) untuk mencari nomor telepon yang tersedia dan untuk meng [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) klaimnya.
Sebelum Anda mengklaim nomor telepon ke grup distribusi lalu lintas, sebaiknya gunakan [ DescribeTrafficDistributionGroup ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API untuk memverifikasi status grup distribusi lalu lintas`ACTIVE`. Menetapkan nomor telepon ke grup distribusi lalu lintas yang tidak `ACTIVE` menghasilkan`ResourceNotFoundException`.
Anda dapat mengklaim nomor telepon ke grup distribusi lalu lintas dengan memberikan grup distribusi lalu lintas ARN dalam ** TargetArn ** parameter saat memanggil [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API. Anda juga dapat menggunakan [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API untuk menetapkan nomor telepon yang sebelumnya diklaim ke instance ke grup distribusi lalu lintas.
**catatan**
Untuk memperbarui ** bidang ** Deskripsi, Anda harus menggunakan konsol Connect Customer.
## Contoh alur kerja
Berikut ini adalah contoh alur kerja untuk mengklaim nomor telepon dan menggunakannya di beberapa Wilayah AWS:
1. Buat replika instance Anda:
1. Panggil [ ReplicateInstance ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API.
1. Buat grup distribusi lalu lintas yang menghubungkan instans ini bersama-sama:
1. Panggil [ CreateTrafficDistributionGroup ](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API.
1. Temukan nomor telepon yang tersedia yang dapat diklaim ke grup distribusi lalu lintas Anda:
1. Panggil [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API di Wilayah tempat grup distribusi lalu lintas dibuat. Berikan grup distribusi lalu lintas ARN untuk `TargetArn` parameter.
1. Di Wilayah tempat grup distribusi lalu lintas dibuat, panggil [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API:
1. Berikan grup distribusi lalu lintas ARN Anda untuk `TargetArn` parameter.
1. Berikan nilai nomor telepon E164 yang dikembalikan oleh panggilan [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API pada langkah 3.
A `PhoneNumberId` dan `PhoneNumberArn` dikembalikan. Anda dapat menggunakan nilai-nilai ini untuk operasi tindak lanjut.
1. Pastikan status nomor telepon adalah`CLAIMED`:
1. Panggil [ DescribePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) API.
(juga DescribePhoneNumber dapat dipanggil di Wilayah lain yang terkait dengan grup distribusi lalu lintas. Ini akan mengembalikan detail nomor telepon yang sama.)
Nomor telepon dapat digunakan oleh operasi tindak lanjut hanya setelah statusnya`CLAIMED`.
Untuk deskripsi kemungkinan status, lihat[Status nomor telepon ditentukan](#claim-phone-number-status).
1. Ulangi langkah 3-5 untuk semua nomor telepon yang perlu Anda klaim ke grup distribusi lalu lintas Anda.
1. Lakukan langkah-langkah berikut untuk mengaitkan alur ke nomor telepon. Lakukan di kedua Wilayah tempat grup distribusi lalu lintas beroperasi.
Langkah-langkah ini memastikan lalu lintas telepon Anda akan mengarahkan dengan benar ke alur Anda untuk mendukung konfigurasi distribusi lalu lintas Anda.
1. Dalam instance Connect Customer yang ada di Wilayah tempat grup distribusi lalu lintas dibuat, lakukan langkah-langkah berikut:
1. Panggil [ ListContactFlows ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API. Berikan `InstanceId` yang sesuai dengan instance yang direplikasi.
1. Daftar ARN aliran dikembalikan. Gunakan ARN aliran ini untuk mengaitkan aliran ke nomor telepon; panggil [ AssociatePhoneNumberContactFlow ](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API.
1. Dalam instance Connect Customer yang direplikasi di Wil AWS ayah lain, lakukan langkah-langkah berikut:
1. Panggil [ ListContactFlows ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API. Berikan `InstanceId` yang sesuai dengan instance yang direplikasi.
1. Daftar ARN aliran dikembalikan. Gunakan ARN aliran ini untuk mengaitkan aliran ke nomor telepon; panggil [ AssociatePhoneNumberContactFlow ](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API.
## Mengapa ClaimPhoneNumber panggilan gagal
Pang [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) gilan API Anda akan gagal dengan a `ResourceNotFoundException` dalam kasus berikut:
+ Grup distribusi lalu lintas yang ditentukan tidak ada, status grup distribusi lalu lintas tidak ada`ACTIVE`, atau Anda tidak memiliki kepemilikan grup distribusi lalu lintas.
+ Nomor telepon tidak tersedia untuk klaim. Dalam beberapa kasus, nomor telepon yang ditemukan [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) mungkin telah diklaim oleh pelanggan lain.
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)akan gagal dengan `InvalidParameterException` kesalahan dalam kasus berikut:
+ Titik akhir yang Anda panggil tidak berada di Wilayah yang sama tempat grup distribusi lalu lintas dibuat.
## Status nomor telepon ditentukan
Berikut ini adalah deskripsi status nomor telepon:
+ `CLAIMED`berarti operasi sebelumnya [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) atau [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) operasi berhasil.
+ `IN_PROGRESS`berarti a [ ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) operasi masih berlangsung dan belum selesai. Anda dapat menelepon [ DescribePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) di lain waktu untuk memverifikasi apakah operasi sebelumnya telah selesai.
+ `FAILED`menunjukkan bahwa operasi sebelumnya [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) atau [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) operasi telah gagal. Ini termasuk pesan yang menunjukkan alasan kegagalan.
Alasan umum kegagalan adalah bahwa `TargetArn` nilai yang Anda klaim atau perbarui nomor telepon telah mencapai batas total nomor yang diklaim.
Jika Anda menerima `FAILED` status dari panggilan `ClaimPhoneNumber` API, Anda memiliki satu hari untuk mencoba kembali mengklaim nomor telepon sebelum nomor tersebut dilepaskan kembali ke inventaris untuk diklaim oleh pelanggan lain.