---
title: "Grup dering"
description: "Deringkan tim Anda di ponsel browser saat panggilan masuk ke sebuah nomor, dengan grup dering yang Anda kelola di dasbor atau melalui API, CLI, dan MCP."
canonical: "https://bird.com/id-id/dokumentasi/guides/voice/ring-groups"
---

# Grup dering

Grup dering mendering orang-orang di workspace Anda yang sedang online di [ponsel browser](/docs/guides/voice/phone). Arahkan sebuah nomor, atau rute default workspace Anda, ke sebuah grup, maka panggilan masuk akan mendering anggota grup yang online di dasbor sampai salah satu dari mereka menjawab.

Setiap workspace memiliki grup **Default** yang mendering semua orang yang online. Tambahkan grup Anda sendiri untuk mendering tim yang lebih kecil, seperti dukungan atau penjualan, lalu arahkan setiap nomor ke grup yang seharusnya menjawabnya.

## Sebelum memulai

- **Anggota yang online.** Grup dering hanya mendering anggota yang online di ponsel browser. [Menerima panggilan](/docs/guides/voice/phone#receive-calls) menjelaskan cara online dan siapa yang bisa melakukannya.
- **Izin untuk mengelola Voice.** Untuk melihat grup dering, Anda memerlukan `voice_management` pada tingkat baca. Untuk membuat, mengganti nama, menghapus, dan mengubah anggota, serta mengarahkan nomor ke grup, Anda memerlukannya pada tingkat tulis.
- **Untuk API atau CLI:** kunci API yang memiliki cakupan `voice_management` pada tingkat yang diperlukan operasi tersebut.

## Grup default

Grup **Default** selalu berada di urutan pertama daftar. Anggotanya adalah setiap pengguna yang online di workspace saat panggilan masuk, jadi Anda tidak perlu menambahkan siapa pun ke dalamnya. Grup ini tidak dapat diganti namanya atau dihapus, dan anggotanya tidak dapat diubah: permintaan untuk melakukannya ditolak dengan `409` dan `E21072`.

ID-nya adalah `vrg_` diikuti akhiran ID workspace Anda, sehingga ID ini sama di setiap pembacaan. Gunakan ID ini di mana pun ID grup dering diterima.

## Membuat ring group

1. Buka **Voice** > [**Ring groups**](https://bird.com/dashboard/w/voice/ring-groups), lalu pilih **New ring group**.
2. Masukkan **Name**, lalu pilih **Create ring group**.
3. Di **Members** grup tersebut, pilih **Add member** dan pilih setiap pengguna yang harus dihubungi grup. Daftar ini menampilkan pengguna yang dapat mengakses workspace.

Kolom **Online** menghitung anggota grup yang online dan menerima panggilan. Jumlah ini mencakup anggota yang sedang dalam panggilan, yang tidak akan dihubungi sampai panggilan tersebut berakhir. Grup baru belum memiliki anggota, sehingga kolom ini menampilkan 0 sampai Anda menambahkan anggota.

Melalui API, [buat ring group](/docs/api/reference/create-voice-ring-group), lalu [tambahkan setiap anggota](/docs/api/reference/create-voice-ring-group-member) berdasarkan ID pengguna. Untuk menemukan ID pengguna, jalankan [`bird members list`](/docs/cli/reference/members-list), yang memerlukan cakupan `members` pada tingkat baca.

**TypeScript**

```typescript
const group = await bird.voice.ringGroups.create({ name: "Support" });
console.log(group.id, group.name);
```

Examples: [TypeScript](/id-id/dokumentasi/guides/voice/ring-groups.ts.md) · [Python](/id-id/dokumentasi/guides/voice/ring-groups.py.md) · [Go](/id-id/dokumentasi/guides/voice/ring-groups.go.md) · [PHP](/id-id/dokumentasi/guides/voice/ring-groups.php.md) · [CLI](/id-id/dokumentasi/guides/voice/ring-groups.cli.md) · [MCP](/id-id/dokumentasi/guides/voice/ring-groups.mcp.md) · [cURL](/id-id/dokumentasi/guides/voice/ring-groups.curl.md)

**TypeScript**

```typescript
const member = await bird.voice.ringGroups.members.create("RING_GROUP_ID", { user_id: "USER_ID" });
console.log(member.user_id);
```

Examples: [TypeScript](/id-id/dokumentasi/guides/voice/ring-groups.ts.md) · [Python](/id-id/dokumentasi/guides/voice/ring-groups.py.md) · [Go](/id-id/dokumentasi/guides/voice/ring-groups.go.md) · [PHP](/id-id/dokumentasi/guides/voice/ring-groups.php.md) · [CLI](/id-id/dokumentasi/guides/voice/ring-groups.cli.md) · [MCP](/id-id/dokumentasi/guides/voice/ring-groups.mcp.md) · [cURL](/id-id/dokumentasi/guides/voice/ring-groups.curl.md)

Pengguna yang kemudian keluar dari workspace tetap tercantum sampai Anda menghapusnya, tetapi grup tidak pernah menghubunginya. Untuk menghapus anggota, pilih **Remove** di sebelahnya, atau [hapus anggota](/docs/api/reference/delete-voice-ring-group-member) melalui API. Anggota yang dihapus tidak lagi dihubungi mulai panggilan berikutnya.

## Mengarahkan panggilan ke ring group

Sebuah nomor menghubungi grup jika rutenya sendiri, atau rute default workspace yang diikutinya, menyebutkan grup tersebut.

- **Satu nomor:** buka **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), buka nomornya, lalu di bawah **Inbound routing** pilih **Ring a ring group**. Pilih grupnya, lalu pilih **Save**.
- **Semua nomor tanpa rute sendiri:** di halaman **Numbers**, di sebelah **Calls to numbers without their own route**, pilih **Change**, pilih **Ring a ring group** beserta grupnya, lalu simpan.

Melalui API, atur rute ke `{"type": "ring_group", "ring_group_id": "<id>"}` saat Anda [memperbarui nomor](/docs/api/reference/update-voice-number), atau di [pengaturan suara](/docs/api/reference/update-voice-settings) untuk rute default. `ring_group_id` yang bukan grup default dan bukan grup di workspace akan ditolak dengan `422`.

**CLI**

```cli
bird voice numbers update vnu_01krdgeqcxet5s7t44vh8rt9mg \
  --route ring_group --ring-group-id vrg_01krdgeqcxet5s7t44vh8rt9mg
```

Examples: [CLI](/id-id/dokumentasi/guides/voice/ring-groups.cli.md) · [cURL](/id-id/dokumentasi/guides/voice/ring-groups.curl.md)

`bird voice settings update` menerima flag `--route ring_group --ring-group-id` yang sama untuk rute default. [Menerima panggilan](/docs/guides/voice/receiving-calls) menjelaskan rute lainnya dan cara mengembalikan nomor ke rute default.

Sequence juga dapat membunyikan grup melalui langkah panggilan. Hasil langkah tersebut kemudian melanjutkan sequence, dan di situlah Anda menempatkan pesan suara atau penerusan panggilan jika grup tidak menjawab.

## Cara ring group berdering

Saat panggilan masuk untuk sebuah grup, Bird membaca anggota grup yang dapat dihubungi pada saat itu dan mengacak urutan mereka:

- Anggota dihubungi lima orang sekaligus, hingga 20 detik per kelompok. Jika semua anggota dalam satu kelompok menolak atau tidak dapat dihubungi, kelompok berikutnya langsung dimulai.
- Dering berhenti setelah total 60 detik.
- Anggota pertama yang memilih **Accept** menerima panggilan, dan dering pada anggota lain berhenti.
- Panggilan berdering hanya di satu perangkat milik anggota, yaitu browser yang menyimpan status online mereka.

Anggota dilewati jika sedang offline, berstatus **Busy**, sedang dalam panggilan, atau berstatus **Not accepting calls** setelah tiga kali berturut-turut tidak menjawab panggilan. [Status Anda](/docs/guides/voice/phone#your-status) menjelaskan setiap status tersebut.

Penelepon mendengar nada dering selama anggota dihubungi, dan panggilan belum dijawab hingga ada anggota yang menerimanya, sehingga waktu dering tidak ditagih. Jika tidak ada yang menjawab dalam 60 detik atau tidak ada anggota yang dapat dihubungi, nomor yang dirutekan langsung ke grup akan menolak panggilan. Untuk mengarahkan penelepon yang tidak terjawab ke tujuan lain, rutekan nomor ke sequence yang membunyikan grup lalu melanjutkan ke langkah berikutnya.

## Menghapus ring group

Pilih grup di halaman **Ring groups**, lalu pilih **Delete ring group**. Panggilan yang sudah berdering pada anggotanya tidak terpengaruh.

Grup yang masih dihubungi oleh nomor, rute default workspace, atau sequence yang sudah dipublikasikan tidak dapat dihapus: permintaan tersebut ditolak dengan `409` dan `E21071`. Arahkan masing-masing ke rute lain terlebih dahulu, lalu hapus grupnya.

## Batas

| Batas                                        | Nilai  |
| -------------------------------------------- | ------ |
| Ring group per workspace, selain **Default** | 50     |
| Anggota per ring group                       | 200    |
| Anggota yang dihubungi sekaligus             | 5      |
| Waktu dering untuk setiap panggilan          | 60 dtk |

Grup default tidak memiliki batas anggota. Permintaan pembuatan grup atau penambahan anggota yang melebihi batas akan ditolak dengan `422`, disertai pesan yang menyebutkan batas tersebut. Jumlah pengguna yang dapat online secara bersamaan merupakan batas organisasi, yang dijelaskan di [Batas pengguna online](/docs/guides/voice/phone#users-online-limit).

## Kelola ring group dari API, CLI, atau MCP

| Tugas                                | API                                                                             | CLI                                                                                             |
| ------------------------------------ | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Menampilkan daftar grup di workspace | [Menampilkan daftar ring group](/docs/api/reference/list-voice-ring-groups)     | [`bird voice ring-groups list`](/docs/cli/reference/voice-ring-groups-list)                     |
| Membuat grup                         | [Membuat ring group](/docs/api/reference/create-voice-ring-group)               | [`bird voice ring-groups create`](/docs/cli/reference/voice-ring-groups-create)                 |
| Mengganti nama grup                  | [Memperbarui ring group](/docs/api/reference/update-voice-ring-group)           | [`bird voice ring-groups update`](/docs/cli/reference/voice-ring-groups-update)                 |
| Menghapus grup                       | [Menghapus ring group](/docs/api/reference/delete-voice-ring-group)             | [`bird voice ring-groups delete`](/docs/cli/reference/voice-ring-groups-delete)                 |
| Menampilkan daftar anggota grup      | [Menampilkan daftar anggota](/docs/api/reference/list-voice-ring-group-members) | [`bird voice ring-groups members list`](/docs/cli/reference/voice-ring-groups-members-list)     |
| Menambahkan anggota                  | [Menambahkan anggota](/docs/api/reference/create-voice-ring-group-member)       | [`bird voice ring-groups members create`](/docs/cli/reference/voice-ring-groups-members-create) |
| Menghapus anggota                    | [Menghapus anggota](/docs/api/reference/delete-voice-ring-group-member)         | [`bird voice ring-groups members delete`](/docs/cli/reference/voice-ring-groups-members-delete) |

[Server MCP](/docs/ai/mcp-server) menyediakan operasi yang sama sebagai tool `voice_ring_groups_*`, dan tool `voice_numbers_update` serta `voice_settings_update` miliknya menerima rute `ring_group`. Setiap pembacaan grup menyertakan `online_member_count`, yaitu jumlah yang sama dengan kolom **Online**.

## Langkah berikutnya

| Halaman                                                  | Isi halaman                                                                        |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Telepon](/docs/guides/voice/phone)                      | Cara online, status Anda, dan menjawab panggilan di browser                        |
| [Menerima panggilan](/docs/guides/voice/receiving-calls) | Semua rute yang dapat digunakan nomor, dan cara membaca panggilan yang ditolak     |
| [Log panggilan](/docs/guides/voice/call-log)             | Catatan yang ditinggalkan setiap panggilan, serta cara memfilter dan mengekspornya |

## 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)