--- title: "Alihkan dan bagi panggilan masuk di antara gateway Anda" description: "Gunakan hunt group pada trunk SIP untuk mengirim panggilan masuk ke gateway cadangan saat gateway pertama gagal, atau untuk membagi panggilan antar-gateway berdasarkan bobot." canonical: "https://bird.com/id-id/dokumentasi/guides/voice/hunt-groups" --- # Alihkan dan bagi panggilan masuk di antara gateway Anda Routing trunk SIP menentukan apa yang terjadi pada setiap panggilan masuk: mencari melalui grup gateway Anda, menolak panggilan, atau meneruskannya ke nomor terverifikasi. Hunt group adalah daftar gateway yang dicoba Bird satu per satu hingga salah satunya menjawab. Urutan, prioritas, bobot, dan waktu dering grup menentukan gateway mana yang berdering lebih dulu dan apa yang terjadi jika gateway itu tidak menjawab. Halaman ini menunjukkan cara mengaturnya untuk failover dan pembagian beban. ## Sebelum memulai - Trunk SIP dengan panggilan masuk aktif dan setidaknya satu gateway. [Menyiapkan trunk SIP](/docs/guides/voice/sip-trunk-setup) membahas keduanya. Saat Anda menambahkan gateway pertama ke trunk yang routing-nya belum pernah disimpan, dashboard mengarahkan rute default ke **All gateways (automatic)**, yaitu grup yang berisi semua gateway pada trunk tersebut. - Gateway yang ingin Anda gabungkan, yang ditambahkan di tab **Inbound routing** > **Gateways** pada trunk. ## Cara grup melakukan pencarian Setiap panggilan masuk memulai pencarian. Bird mengurutkan gateway dalam grup untuk panggilan tersebut, membunyikan gateway pertama, lalu beralih ke gateway berikutnya jika gateway itu gagal: - Gateway berdering selama **Ring time**-nya, dari 1 hingga 120 detik (default 30). Jika tidak ada yang menjawab dalam waktu tersebut, Bird beralih ke gateway berikutnya. - Gateway yang sama sekali tidak mengirim balasan akan dilewati setelah jeda singkat, sehingga gateway yang mati tidak menahan penelepon selama seluruh waktu deringnya. - Gateway yang menolak panggilan dengan kode kegagalan SIP memindahkan pencarian ke gateway berikutnya, kecuali kode tersebut tercantum di **Stop the hunt on** pada grup. - Pencarian berakhir ketika sebuah gateway menjawab atau ketika semua gateway dalam grup sudah dicoba. Bird mengurutkan setiap panggilan secara terpisah dan tidak menyimpan rotasi antarpanggilan, sehingga tidak ada round-robin. Sebaran yang merata dihasilkan oleh urutan acak atau berbobot di sepanjang banyak panggilan. | Urutan | Cara mengurutkan gateway untuk setiap panggilan | Gunakan untuk | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | **Sequential** | Urutan daftar, dari atas ke bawah | Satu gateway utama tetap dan cadangannya | | **Random** | Urutan acak baru | Menyebarkan panggilan secara merata | | **Weighted** | **Priority** yang lebih rendah lebih dulu. Dalam satu prioritas, urutannya acak, dan peluang setiap gateway untuk berada di urutan pertama sebanding dengan porsi bobotnya | Failover dan pembagian berbobot sekaligus | ## Menggunakan grup otomatis Setiap gateway pada trunk berada di **All gateways (automatic)**, kecuali routing trunk yang tersimpan memuat grup milik Anda sendiri sebagai penggantinya (lihat bagian akhir bagian ini). Gateway yang Anda tambahkan atau hapus otomatis masuk ke atau keluar dari grup ini. Grup ini menggunakan urutan **Weighted**, bobot yang sama, dan waktu dering 30 detik, serta mencoba gateway sesuai **Priority** yang Anda atur di tab **Gateways**. Di dalam grup itu sendiri, nama, **Order**, waktu dering, dan anggotanya tidak dapat diedit. Untuk failover melalui grup ini, beri gateway utama **Priority** yang lebih rendah daripada gateway cadangan di tab **Gateways**. Gateway dengan **Priority** yang sama berbagi panggilan secara merata. Jika Anda memerlukan waktu dering, bobot, atau kode **Stop the hunt on** yang berbeda, tambahkan grup milik Anda sendiri dengan gateway yang sama, seperti yang dijelaskan di bagian berikutnya. Grup bernama **All gateways** yang dibuat dashboard saat Anda menambahkan gateway pertama adalah grup milik Anda sendiri: grup itu hanya berisi gateway yang tersimpan bersamanya. Jika tab **Groups** tidak menampilkan **All gateways (automatic)**, routing trunk yang tersimpan memuat grup milik Anda sendiri sebagai pengganti grup tersebut, biasanya bernama **All gateways**. Jika Anda menghapusnya, grup otomatis kembali menggantikannya: panggilan yang sebelumnya menuju grup itu kemudian membunyikan semua gateway, sesuai urutan **Priority** dengan waktu dering 30 detik. Pertahankan grup itu jika isinya adalah gateway, waktu dering, atau kode **Stop the hunt on** yang Anda inginkan. ## Menyiapkan failover 1. Buka **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), buka trunk, lalu buka **Inbound routing** > **Groups**. 2. Buka grup milik Anda sendiri, atau pilih **Add group** dan beri nama. **All gateways (automatic)** tidak dapat diedit. 3. Tambahkan gateway utama dan gateway cadangan Anda dengan **Add gateway to group**. 4. Atur **Order** ke **Sequential** dan pertahankan gateway utama di posisi teratas dengan **Move up** dan **Move down**. Sebagai alternatif, atur **Order** ke **Weighted**, lalu beri gateway utama **Priority** 1 dan gateway cadangan **Priority** 2. 5. Atur **Ring time** setiap gateway. Dengan ring time yang lebih singkat pada gateway utama, panggilan yang tidak dijawab lebih cepat beralih ke gateway cadangan. 6. Di tab **Rules**, atur **Then** pada **Default route** ke **Route to group** dan pilih grupnya, atau arahkan sebuah aturan ke grup tersebut. Grup yang tidak digunakan rute mana pun tidak menerima panggilan. 7. Pilih **Review and save**, lalu konfirmasi. ## Membagi panggilan antar-gateway 1. Buka **Inbound routing** > **Groups** pada trunk. Buka grup milik Anda sendiri, atau pilih **Add group**, beri nama, lalu tambahkan gateway dengan **Add gateway to group**. 2. Atur **Order** ke **Weighted**, beri semua gateway **Priority** yang sama, lalu atur **Weight** masing-masing dari 1 hingga 100. Dengan bobot 70 dan 30, sekitar 70% dan 30% panggilan dikirim ke masing-masing gateway. Untuk pembagian merata, gunakan bobot yang sama atau atur **Order** ke **Random**. 3. Agar tetap memiliki cadangan, beri gateway yang berbagi panggilan **Priority** 1 dan gateway cadangan **Priority** 2. Gateway cadangan hanya berdering jika semua gateway prioritas 1 gagal. 4. Di tab **Rules**, atur **Then** pada **Default route** ke **Route to group** dan pilih grupnya, atau arahkan sebuah aturan ke grup tersebut. 5. Pilih **Review and save**, lalu konfirmasi. ## Hentikan pencarian saat nada sibuk Secara default, Bird mencoba gateway berikutnya pada setiap kegagalan. Jika suatu kegagalan berarti gateway lain tidak akan membantu, cantumkan kodenya di **Stop the hunt on** pada grup tersebut. Misalnya, tambahkan `486` (Busy Here) agar orang yang sedang menerima panggilan tidak dihubungi lagi melalui gateway kedua. Anda dapat memasukkan kode apa pun dari 400 hingga 699. ## Arahkan panggilan yang berbeda ke grup yang berbeda Satu trunk dapat memiliki beberapa grup. **Default route** mengirim panggilan yang tidak cocok dengan aturan mana pun ke satu grup, dan aturan di tab **Rules** dapat mengirim panggilan lain ke grup lain. [Mengirim panggilan ke trunk SIP](/docs/guides/voice/receiving-calls#deliver-calls-to-a-sip-trunk) menjelaskan aturan dan rute default. ## Pemecahan masalah | Yang Anda lihat | Yang perlu diperiksa | | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Gateway cadangan tidak pernah berdering | Gateway cadangan berada di grup yang digunakan rute default (atau aturan yang cocok). Dengan **Weighted**, angka **Priority**-nya lebih tinggi daripada gateway utama. Kode di **Stop the hunt on** dapat mengakhiri pencarian sebelum mencapai gateway cadangan | | Satu gateway menerima semua panggilan dengan **Weighted** | Gateway dengan prioritas berbeda tidak berbagi panggilan. Berikan **Priority** yang sama kepada semuanya | | Panggilan berdering terlalu lama sebelum dialihkan ke cadangan | Turunkan **Ring time** gateway utama | | Sebuah gateway tidak pernah berdering | Gateway tersebut tidak berada di grup mana pun yang digunakan oleh aturan atau rute default. Saat Anda menyimpan, dashboard menampilkan peringatan **Calls never reach some gateways** | ## Langkah berikutnya | Halaman | Isi halaman | | ------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [Menyiapkan trunk SIP](/docs/guides/voice/sip-trunk-setup) | Penyiapan trunk lengkap secara berurutan, mulai dari pembuatan hingga panggilan uji | | [Menerima panggilan](/docs/guides/voice/receiving-calls) | Rute nomor, aturan, rute default, dan panggilan yang ditolak | | [Pemecahan masalah suara](/docs/guides/voice/troubleshooting) | Mendiagnosis panggilan berdasarkan gejalanya | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)