Grup dering

Grup dering membunyikan telepon orang-orang di workspace Anda yang sedang online di telepon browser. Arahkan sebuah nomor, atau rute default workspace Anda, ke sebuah grup. Panggilan masuk lalu berdering untuk anggota grup yang online di dasbor hingga salah satu dari mereka menjawab.

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

Sebelum memulai

• Anggota yang online. Grup dering hanya membunyikan telepon anggota yang online di telepon browser. Menerima panggilan menjelaskan cara online dan siapa yang dapat 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, sehingga Anda tidak perlu menambahkan siapa pun ke grup ini. Grup ini tidak dapat diganti nama 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 selalu sama setiap kali dibaca. 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 milik grup, pilih Add member lalu pilih setiap pengguna yang harus dihubungi oleh grup. Daftar ini menampilkan pengguna yang dapat mengakses workspace.

Kolom Online menghitung anggota grup yang sedang online dan menerima panggilan. Hitungan 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 di 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 sebelah anggota tersebut, atau hapus anggota melalui API. Anggota yang dihapus tidak lagi dihubungi mulai panggilan berikutnya.

Merutekan panggilan ke ring group

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

• Satu nomor: buka Voice > Numbers, buka nomornya, lalu di bagian Inbound routing pilih Ring a ring group. Pilih grupnya lalu pilih Save.
• Setiap 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 itu kemudian melanjutkan sequence. Di situlah Anda menempatkan pesan suara atau penerusan panggilan setelah grup tidak menjawab.

Cara ring group berdering

Saat panggilan masuk untuk sebuah grup, Bird membaca anggota grup yang dapat dibunyikan pada saat itu dan mengacaknya ke dalam urutan acak:

• Anggota dibunyikan lima orang sekaligus, hingga 20 detik per kelompok. Jika setiap anggota dalam satu kelompok menolak atau tidak dapat dihubungi, kelompok berikutnya langsung dimulai.
• Dering berhenti setelah total 60 detik.
• Anggota pertama yang memilih Accept mengambil panggilan, dan perangkat anggota lainnya berhenti berdering.
• Seorang anggota hanya berdering di satu perangkat, yaitu browser yang menyimpan status online-nya.

Anggota dilewati jika sedang offline, Busy, sedang dalam panggilan, atau Not accepting calls setelah tiga kali berturut-turut tidak menjawab panggilan. Status Anda menjelaskan masing-masing status.

Penelepon mendengar nada dering selama anggota dibunyikan, dan panggilan belum dijawab sampai seorang anggota menerimanya, sehingga waktu dering tidak ditagih. Jika tidak ada yang menjawab dalam 60 detik, atau tidak ada anggota yang dapat dibunyikan, 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 berlanjut.

Di API leg suara, leg penelepon menyebutkan anggota tersebut di answered_by. Dalam rekaman atau transkrip, user_id milik pihak tersebut menyebutkan anggota di sisi itu.

Menghapus ring group

Pilih grup di halaman Ring groups, lalu pilih Delete ring group. Panggilan yang sedang berdering ke anggotanya tidak terpengaruh.

Grup yang masih dituju oleh sebuah nomor, rute default workspace, atau sequence yang telah 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. Pembuatan grup atau penambahan anggota yang melebihi batas ditolak dengan 422, disertai pesan yang menyebutkan batasnya. 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 alat voice_ring_groups_*, dan alat voice_numbers_update serta voice_settings_update di dalamnya menerima rute ring_group. Setiap pembacaan grup menyertakan online_member_count, yaitu jumlah yang sama dengan kolom Online.

Langkah berikutnya