Klaim nomor telepon ke grup distribusi lalu lintas menggunakan Amazon Connect - Amazon Connect
Contoh alur kerjaMengapa ClaimPhoneNumber panggilan gagalStatus nomor telepon ditentukan

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

catatan

Pengguna baru? Lihat Lokakarya Ketahanan Global Amazon Connect. Kursus online ini memandu Anda melalui proses orientasi dan pengujian nomor telepon dan failover agen menggunakan new APIs through the. AWS CLI

Ketahanan Global hanya tersedia untuk instans Amazon Connect yang dibuat di AWS Wilayah berikut: US East (Virginia N.), US West (Oregon), 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. Demikian pula, Anda hanya dapat membuat replika di Wilayah Eropa (Frankfurt) jika sumber Anda adalah Eropa (London), atau sebaliknya.

Untuk mendapatkan akses ke fitur ini, hubungi Arsitek Solusi Amazon Connect atau Manajer Akun Teknis Anda.

Setelah grup distribusi lalu lintas Anda berhasil dibuat (StatusisACTIVE), Anda dapat menggunakan SearchAvailablePhoneNumbersuntuk mencari nomor telepon yang tersedia dan ClaimPhoneNumberuntuk mengklaimnya.

Sebelum Anda mengklaim nomor telepon ke grup distribusi lalu lintas Anda, sebaiknya gunakan DescribeTrafficDistributionGroupAPIuntuk memverifikasi status grup distribusi lalu lintasACTIVE. Menetapkan nomor telepon ke grup distribusi lalu lintas yang tidak ACTIVE menghasilkanResourceNotFoundException.

Anda dapat mengklaim nomor telepon ke grup distribusi lalu lintas dengan menyediakan grup distribusi lalu lintas ARN dalam TargetArnparameter saat memanggil ClaimPhoneNumberAPI. Anda juga dapat menggunakan UpdatePhoneNumberAPIuntuk 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

Berikut ini adalah contoh alur kerja untuk mengklaim nomor telepon dan menggunakannya di beberapa Wilayah AWS:

  1. Buat replika instance Anda:

    1. Panggil ReplicateInstanceAPI.

  2. Buat grup distribusi lalu lintas yang menautkan instance ini bersama-sama:

    1. Panggil CreateTrafficDistributionGroupAPI.

  3. Temukan nomor telepon yang tersedia yang dapat diklaim ke grup distribusi lalu lintas Anda:

    1. Panggil SearchAvailablePhoneNumbersAPIdi Wilayah tempat grup distribusi lalu lintas dibuat. Berikan grup distribusi lalu lintas ARN untuk TargetArn parameter.

  4. Di Wilayah tempat grup distribusi lalu lintas dibuat, hubungi ClaimPhoneNumberAPI:

    1. Berikan grup distribusi lalu lintas Anda ARN untuk TargetArn parameter tersebut.

    2. Berikan nilai nomor telepon E164 yang dikembalikan oleh SearchAvailablePhoneNumbersAPIpanggilan pada langkah 3.

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

  5. Verifikasi bahwa status nomor telepon adalahCLAIMED:

    1. Panggil DescribePhoneNumberAPI.

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

    Untuk deskripsi status yang mungkin, lihatStatus nomor telepon ditentukan.

  6. Ulangi langkah 3-5 untuk semua nomor telepon yang perlu Anda klaim ke grup distribusi lalu lintas Anda.

  7. 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. Panggilan ListContactFlowsAPI. Berikan InstanceId yang sesuai dengan instance yang direplikasi.

      2. Daftar aliran ARNs dikembalikan. Gunakan alur ini ARNs untuk mengaitkan aliran ke nomor telepon; hubungi file AssociatePhoneNumberContactFlowAPI.

    2. Dalam instans Amazon Connect yang direplikasi di AWS Wilayah lain, lakukan langkah-langkah berikut:

      1. Panggilan ListContactFlowsAPI. Berikan InstanceId yang sesuai dengan instance yang direplikasi.

      2. Daftar aliran ARNs dikembalikan. Gunakan alur ini ARNs untuk mengaitkan aliran ke nomor telepon; hubungi file AssociatePhoneNumberContactFlowAPI.

Mengapa ClaimPhoneNumber panggilan gagal

ClaimPhoneNumberAPIPanggilan Anda akan gagal dengan a ResourceNotFoundException dalam kasus berikut:

  • Grup distribusi lalu lintas yang ditentukan tidak ada, status grup distribusi lalu lintas tidakACTIVE, atau Anda tidak memiliki kepemilikan grup distribusi lalu lintas.

  • Nomor telepon tidak tersedia untuk diklaim. Dalam beberapa kasus, nomor telepon yang ditemukan dari SearchAvailablePhoneNumbersmungkin telah diklaim oleh pelanggan lain.

ClaimPhoneNumberakan 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:

  • CLAIMEDberarti UpdatePhoneNumberoperasi sebelumnya ClaimPhoneNumberatau berhasil.

  • IN_PROGRESSberarti a ClaimPhoneNumber, UpdatePhoneNumberoperasi masih dalam proses dan belum selesai. Anda dapat menelepon DescribePhoneNumberdi lain waktu untuk memverifikasi apakah operasi sebelumnya telah selesai.

  • FAILEDmenunjukkan bahwa sebelumnya ClaimPhoneNumberatau UpdatePhoneNumberoperasi 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 ClaimPhoneNumber API panggilan, Anda memiliki satu hari untuk mencoba lagi mengklaim nomor telepon sebelum nomor tersebut dilepaskan kembali ke inventaris untuk diklaim pelanggan lain.