Grup dering

Grup dering mendering orang-orang di workspace Anda yang sedang online di ponsel browser. 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 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, 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, lalu tambahkan setiap anggota berdasarkan ID pengguna. Untuk menemukan ID pengguna, jalankan bird members list, yang memerlukan cakupan members pada tingkat baca.

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

group = client.voice.ring_groups.create(name="Support")
print(group.id, group.name)

group, err := client.Voice.RingGroups.Create(context.Background(), bird.VoiceRingGroupsCreateParams{
	Name: "Support",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(group.Id, group.Name)

$group = $bird->voice->ringGroups->create((new VoiceRingGroupCreate())->setName('Support'));
echo $group->getId(), ' ', $group->getName(), "\n";

bird voice ring-groups create --name Support

curl -X POST "https://{region}.platform.bird.com/v1/voice/ring-groups" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support"
  }'

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

member = client.voice.ring_groups.members.create("RING_GROUP_ID", user_id="USER_ID")
print(member.user_id)

member, err := client.Voice.RingGroups.Members.Create(context.Background(), "RING_GROUP_ID", bird.VoiceRingGroupsMembersCreateParams{
	UserID: "USER_ID",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(member.UserId)

$member = $bird->voice->ringGroups->members->create('RING_GROUP_ID', (new VoiceRingGroupMemberCreate())->setUserId('USER_ID'));
echo $member->getUserId(), "\n";

bird voice ring-groups members create <ring-group-id> \
  --user-id usr_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://{region}.platform.bird.com/v1/voice/ring-groups/{ring_group_id}/members" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_01krdgeqcxet5s7t44vh8rt9mg"
  }'

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 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, 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, atau di pengaturan suara untuk rute default. ring_group_id yang bukan grup default dan bukan grup di workspace akan ditolak dengan 422.

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

curl -X PATCH "https://{region}.platform.bird.com/v1/voice/numbers/vnu_01krdgeqcxet5s7t44vh8rt9mg" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "inbound_configuration": {
      "route": {
        "type": "ring_group",
        "ring_group_id": "vrg_01krdgeqcxet5s7t44vh8rt9mg"
      }
    }
  }'

bird voice settings update menerima flag --route ring_group --ring-group-id yang sama untuk rute default. Menerima panggilan 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 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

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.

Kelola ring group dari API, CLI, atau MCP

Server MCP 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