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 Amazon Connect
<a name="claim-phone-numbers-traffic-distribution-groups"></a>

**catatan**  
**Pengguna baru?** Lihat Lokakarya [Ketahanan Global Amazon Connect](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). Kursus online ini memandu Anda melalui proses orientasi dan pengujian nomor telepon dan failover agen menggunakan yang baru APIs melalui AWS CLI.  
Ketahanan Global hanya tersedia untuk instans Amazon Connect yang dibuat di AWS Wilayah berikut: US East (Virginia N.), US West (Oregon), Asia Pasifik (Osaka), Asia Pasifik (Tokyo), Eropa (Frankfurt), dan Eropa (London).  
Anda hanya dapat membuat replika di Wilayah AS Timur (Virginia N.) jika sumber Anda adalah US West (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 Amazon Connect atau Manajer Akun Teknis Anda.

 Setelah grup distribusi lalu lintas Anda berhasil dibuat (`Status`is`ACTIVE`), Anda dapat menggunakan [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)untuk mencari nomor telepon yang tersedia dan [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)untuk mengklaimnya. 

Sebelum Anda mengklaim nomor telepon ke grup distribusi lalu lintas Anda, 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 menyediakan grup distribusi lalu lintas ARN dalam **TargetArn**parameter saat memanggil API. [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 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 instans ke grup distribusi lalu lintas. 

**catatan**  
Untuk memperbarui bidang **Deskripsi**, Anda harus menggunakan konsol Amazon Connect.

## Contoh alur kerja
<a name="example-workflow-claim"></a>

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 menautkan instance 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 parameter. `TargetArn`

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 ARN grup distribusi lalu lintas Anda untuk parameter. `TargetArn`

   1. Berikan nilai nomor telepon E164 yang dikembalikan oleh panggilan [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API di langkah 3.

   A `PhoneNumberId` dan `PhoneNumberArn` dikembalikan. Anda dapat menggunakan nilai-nilai ini untuk operasi tindak lanjut. 

1. Verifikasi bahwa 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 status yang mungkin, 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 dirutekan dengan benar ke arus Anda untuk mendukung konfigurasi distribusi lalu lintas Anda.

   1. Di instans Amazon Connect 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 aliran ARNs dikembalikan. Gunakan alur ini ARNs untuk mengaitkan alur ke nomor telepon; panggil [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API. 

   1. Dalam instans Amazon Connect yang direplikasi di AWS Wilayah 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 aliran ARNs dikembalikan. Gunakan alur ini ARNs untuk mengaitkan alur ke nomor telepon; panggil [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API. 

## Mengapa ClaimPhoneNumber panggilan gagal
<a name="why-claimphonenumber-fails"></a>

Panggilan [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API Anda akan gagal dengan a `ResourceNotFoundException` dalam kasus berikut:
+ Grup distribusi lalu lintas yang ditentukan tidak ada, status grup distribusi lalu lintas tidak`ACTIVE`, atau Anda tidak memiliki kepemilikan grup distribusi lalu lintas.
+ Nomor telepon tidak tersedia untuk diklaim. Dalam beberapa kasus, nomor telepon yang ditemukan dari [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
<a name="claim-phone-number-status"></a>

Berikut ini adalah deskripsi status nomor telepon:
+ `CLAIMED`berarti [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)operasi sebelumnya [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)atau 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 dalam proses 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 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 untuk kegagalan adalah bahwa `TargetArn` nilai yang Anda klaim atau memperbarui 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.