View a markdown version of this page

Klaim nomor telepon ke grup distribusi lalu lintas menggunakan Connect Customer - Pelanggan 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 Connect Customer

catatan

Pengguna baru? Lihat Lokakarya Ketahanan Global 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 (StatusisACTIVE), Anda dapat menggunakannya SearchAvailablePhoneNumbers untuk mencari nomor telepon yang tersedia dan untuk meng ClaimPhoneNumber klaimnya.

Sebelum Anda mengklaim nomor telepon ke grup distribusi lalu lintas, sebaiknya gunakan DescribeTrafficDistributionGroup API untuk 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 memberikan grup distribusi lalu lintas ARN dalam TargetArn parameter saat memanggil ClaimPhoneNumber API. Anda juga dapat menggunakan UpdatePhoneNumber 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 API.

  2. Buat grup distribusi lalu lintas yang menghubungkan instans ini bersama-sama:

    1. Panggil CreateTrafficDistributionGroup API.

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

    1. Panggil SearchAvailablePhoneNumbers API di 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, panggil ClaimPhoneNumber API:

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

    2. Berikan nilai nomor telepon E164 yang dikembalikan oleh panggilan SearchAvailablePhoneNumbers API pada langkah 3.

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

  5. Pastikan status nomor telepon adalahCLAIMED:

    1. Panggil DescribePhoneNumber 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 statusnyaCLAIMED.

    Untuk deskripsi kemungkinan status, 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 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 API. Berikan InstanceId yang sesuai dengan instance yang direplikasi.

      2. Daftar ARN aliran dikembalikan. Gunakan ARN aliran ini untuk mengaitkan aliran ke nomor telepon; panggil AssociatePhoneNumberContactFlow API.

    2. Dalam instance Connect Customer yang direplikasi di Wil AWS ayah lain, lakukan langkah-langkah berikut:

      1. Panggil ListContactFlows API. Berikan InstanceId yang sesuai dengan instance yang direplikasi.

      2. Daftar ARN aliran dikembalikan. Gunakan ARN aliran ini untuk mengaitkan aliran ke nomor telepon; panggil AssociatePhoneNumberContactFlow API.

Mengapa ClaimPhoneNumber panggilan gagal

Pang ClaimPhoneNumber 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 adaACTIVE, atau Anda tidak memiliki kepemilikan grup distribusi lalu lintas.

  • Nomor telepon tidak tersedia untuk klaim. Dalam beberapa kasus, nomor telepon yang ditemukan SearchAvailablePhoneNumbers mungkin 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 operasi sebelumnya ClaimPhoneNumber atau UpdatePhoneNumber operasi berhasil.

  • IN_PROGRESSberarti a ClaimPhoneNumber, UpdatePhoneNumber operasi masih berlangsung dan belum selesai. Anda dapat menelepon DescribePhoneNumber di lain waktu untuk memverifikasi apakah operasi sebelumnya telah selesai.

  • FAILEDmenunjukkan bahwa operasi sebelumnya ClaimPhoneNumber atau UpdatePhoneNumber 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.