Grupy dzwonienia

Grupa dzwonienia dzwoni do osób z Twojego obszaru roboczego, które są online w telefonie przeglądarkowym. Skieruj numer lub domyślną trasę obszaru roboczego do grupy, a połączenie przychodzące będzie dzwonić w panelu u członków grupy, którzy są online, dopóki ktoś z nich nie odbierze.

Każdy obszar roboczy ma grupę Default, która dzwoni do wszystkich osób online. Dodaj własne grupy, aby dzwonić do mniejszego zespołu, np. wsparcia lub sprzedaży, i skieruj każdy numer do grupy, która ma go obsługiwać.

Zanim zaczniesz

• Członkowie, którzy przechodzą w tryb online. Grupa dzwonienia dzwoni tylko do członków, którzy są online w telefonie przeglądarkowym. Strona Odbieranie połączeń wyjaśnia, jak przejść w tryb online i kto może to zrobić.
• Uprawnienie do zarządzania Voice. Wyświetlanie grup dzwonienia wymaga voice_management na poziomie odczytu. Tworzenie, zmiana nazwy, usuwanie i zmiana członków oraz kierowanie numeru do grupy wymagają go na poziomie zapisu.
• W przypadku API lub CLI: klucz API z zakresem voice_management na poziomie, którego wymaga dana operacja.

Grupa domyślna

Grupa Default jest zawsze pierwsza na liście. Jej członkami są wszyscy użytkownicy online w obszarze roboczym w chwili nadejścia połączenia, więc nigdy nikogo do niej nie dodajesz. Nie można zmienić jej nazwy, usunąć jej ani zmienić jej członków: takie żądanie zostaje odrzucone z 409 i E21072.

Jej identyfikator to vrg_, po którym następuje sufiks identyfikatora Twojego obszaru roboczego, więc jest taki sam przy każdym odczycie. Używaj go wszędzie tam, gdzie akceptowany jest identyfikator grupy dzwonienia.

Tworzenie grupy dzwonienia

1. Otwórz Voice > Ring groups i wybierz New ring group.
2. Wpisz Name i wybierz Create ring group.
3. W sekcji Members grupy wybierz Add member i wskaż każdego użytkownika, do którego grupa ma dzwonić. Lista zawiera użytkowników, którzy mają dostęp do obszaru roboczego.

Kolumna Online pokazuje liczbę członków grupy, którzy są online i przyjmują połączenia. Obejmuje ona członków prowadzących rozmowę, do których grupa nie dzwoni, dopóki ta rozmowa się nie zakończy. Nowa grupa nie ma członków, więc pokazuje 0, dopóki ich nie dodasz.

Przez API utwórz grupę dzwonienia, a następnie dodaj każdego członka według identyfikatora użytkownika. Aby znaleźć identyfikatory użytkowników, uruchom bird members list, co wymaga zakresu members na poziomie odczytu.

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"
  }'

Użytkownik, który później opuści obszar roboczy, pozostaje na liście, dopóki go nie usuniesz, ale grupa nigdy do niego nie dzwoni. Aby usunąć członka, wybierz Remove obok niego albo usuń członka przez API. Do usuniętego członka grupa przestaje dzwonić od następnego połączenia.

Kierowanie połączeń do grupy dzwonienia

Numer dzwoni do grupy, gdy jego własna trasa lub domyślna trasa obszaru roboczego, z której korzysta, wskazuje tę grupę.

• Jeden numer: otwórz Voice > Numbers, otwórz numer i w sekcji Inbound routing wybierz Ring a ring group. Wskaż grupę i wybierz Save.
• Każdy numer bez własnej trasy: na stronie Numbers obok Calls to numbers without their own route wybierz Change, wybierz Ring a ring group oraz grupę i zapisz.

Przez API ustaw trasę na {"type": "ring_group", "ring_group_id": "<id>"} podczas aktualizacji numeru albo, w przypadku trasy domyślnej, w ustawieniach głosowych. Wartość ring_group_id, która nie jest ani grupą domyślną, ani grupą w obszarze roboczym, jest odrzucana z kodem 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 przyjmuje te same flagi --route ring_group --ring-group-id dla trasy domyślnej. Strona Odbieranie połączeń opisuje pozostałe trasy oraz sposób przywrócenia numeru do trasy domyślnej.

Grupę może też dzwonić sekwencja, w kroku wybierania. Wynik tego kroku kontynuuje wtedy sekwencję i właśnie tam należy umieścić pocztę głosową lub przekierowanie, gdy nikt z grupy nie odbierze.

Jak dzwoni grupa dzwonienia

Gdy przychodzi połączenie do grupy, Bird odczytuje członków grupy, do których można w danej chwili zadzwonić, i ustawia ich w losowej kolejności:

• Członkowie są dzwonieni po pięciu naraz, przez maksymalnie 20 sekund na partię. Gdy każdy członek partii odrzuci połączenie lub będzie nieosiągalny, od razu zaczyna się następna partia.
• Dzwonienie kończy się łącznie po 60 sekundach.
• Połączenie odbiera pierwszy członek, który wybierze Accept, a u pozostałych dzwonienie ustaje.
• U członka dzwoni tylko jedno urządzenie: przeglądarka, w której ma status online.

Członek jest pomijany, gdy jest offline, ma status Busy, prowadzi już rozmowę lub ma status Not accepting calls po trzech kolejnych nieodebranych połączeniach. Strona Twój status wyjaśnia każdy z nich.

Podczas dzwonienia do członków dzwoniący słyszy sygnał dzwonienia, a połączenie nie jest odebrane, dopóki członek go nie przyjmie, więc czas dzwonienia nie jest naliczany. Jeśli nikt nie odbierze w ciągu 60 sekund lub nie można zadzwonić do nikogo, numer kierowany bezpośrednio do grupy odrzuca połączenie. Aby przekazać nieobsłużonych dzwoniących gdzie indziej, skieruj numer do sekwencji, która dzwoni do grupy, a następnie przechodzi dalej.

Usuwanie grupy dzwonienia

Wybierz grupę na stronie Ring groups i wybierz Delete ring group. Nie wpływa to na połączenia, które już dzwonią u jej członków.

Nie można usunąć grupy, którą nadal wywołuje numer, domyślna trasa obszaru roboczego lub opublikowana sekwencja: żądanie zostaje odrzucone z 409 i E21071. Najpierw skieruj każdy z nich na inną trasę, a potem usuń grupę.

Limity

Grupa domyślna nie ma limitu członków. Utworzenie grupy lub dodanie członka ponad limit zostaje odrzucone z 422, a komunikat wskazuje przekroczony limit. Liczba użytkowników, którzy mogą być jednocześnie online, to limit organizacji opisany w sekcji Limit użytkowników online.

Zarządzanie grupami dzwonienia przez API, CLI lub MCP

Serwer MCP udostępnia te same operacje jako narzędzia voice_ring_groups_*, a jego narzędzia voice_numbers_update i voice_settings_update przyjmują trasę ring_group. Każdy odczyt grupy zawiera online_member_count, czyli tę samą liczbę co kolumna Online.

Dalsze kroki