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ę Everyone, która dzwoni do wszystkich osób online. Dodaj własne grupy, aby dzwonić do mniejszego zespołu, na przykład 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 uprawnienia
voice_managementna poziomie odczytu. Tworzenie, zmiana nazwy, usuwanie i zmiana członków oraz kierowanie numeru do grupy wymagają go na poziomie zapisu. - Dla API lub CLI: klucz API z zakresem
voice_managementna poziomie wymaganym przez operację.
Grupa domyślna
Grupa Everyone 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 końcówka identyfikatora Twojego obszaru roboczego, więc przy każdym odczycie jest taki sam. Używaj go wszędzie, gdzie akceptowany jest identyfikator grupy dzwonienia.
Tworzenie grupy dzwonienia
- Otwórz Voice > Ring groups i wybierz New ring group.
- Wpisz Name i wybierz Create ring group.
- W sekcji Members grupy wybierz Add member i wskaż każdego użytkownika, do którego grupa ma dzwonić. Lista zawiera użytkowników z dostępem do obszaru roboczego.
Kolumna Online pokazuje liczbę członków grupy, którzy są online i przyjmują połączenia. Obejmuje też członków prowadzących rozmowę, do których nie dzwoni się, dopóki ta rozmowa się nie zakończy. Nowa grupa nie ma członków, więc kolumna 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 Supportcurl -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_01krdgeqcxet5s7t44vh8rt9mgcurl -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 lub 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 lub, 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, zostaje odrzucona z kodem 422.
bird voice numbers update vnu_01krdgeqcxet5s7t44vh8rt9mg \
--route ring_group --ring-group-id vrg_01krdgeqcxet5s7t44vh8rt9mgcurl -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. Odbieranie połączeń opisuje pozostałe trasy oraz sposób przywrócenia numeru do trasy domyślnej.
Grupę może też dzwonić sekwencja, z kroku wybierania. Wynik tego kroku kontynuuje wtedy sekwencję i to tam należy umieścić pocztę głosową lub przekierowanie, gdy grupa nie odbierze.
Jak dzwoni grupa dzwonienia
Gdy przychodzi połączenie do grupy, Bird odczytuje członków grupy, do których można w tym momencie dzwonić, i ustawia ich w losowej kolejności:
- Członkowie są wywoływani po pięciu naraz, przez maksymalnie 20 sekund na partię. Gdy każdy członek partii odrzuci połączenie lub jest nieosiągalny, następna partia zaczyna się od razu.
- Dzwonienie kończy się łącznie po 60 sekundach.
- Pierwszy członek, który wybierze Accept, przejmuje połączenie, 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. Twój status wyjaśnia każdy z nich.
Podczas dzwonienia do członków dzwoniący słyszy sygnał, a połączenie nie jest odebrane, dopóki członek go nie zaakceptuje, 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 potem przechodzi dalej.
W API odcinków połączeń głosowych odcinek dzwoniącego wskazuje ich w answered_by. W nagraniu lub transkrypcji user_id uczestnika wskazuje członka po tej stronie.
Usuwanie grupy dzwonienia
Wybierz grupę na stronie Ring groups i wybierz Delete ring group. Nie ma to wpływu na połączenia, które już dzwonią u jej członków.
Nie można usunąć grupy, do której nadal dzwoni numer, domyślna trasa obszaru roboczego lub opublikowana sekwencja: żądanie zostaje odrzucone z 409 i E21071. Najpierw skieruj każde z nich na inną trasę, a potem usuń grupę.
Limity
| Limit | Wartość |
|---|---|
| Grupy dzwonienia w obszarze roboczym, oprócz Everyone | 50 |
| Członkowie jednej grupy dzwonienia | 200 |
| Członkowie, do których dzwoni się jednocześnie | 5 |
| Czas dzwonienia dla każdego połączenia | 60 s |
Grupa domyślna nie ma limitu członków. Utworzenie grupy lub dodanie członka ponad limit zostaje odrzucone z 422 i komunikatem, który podaje ten 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
| Zadanie | API | CLI |
|---|---|---|
| Wyświetlenie grup obszaru roboczego | Wyświetl grupy dzwonienia | bird voice ring-groups list |
| Utworzenie grupy | Utwórz grupę dzwonienia | bird voice ring-groups create |
| Zmiana nazwy grupy | Aktualizacja grupy dzwonienia | bird voice ring-groups update |
| Usunięcie grupy | Usunięcie grupy dzwonienia | bird voice ring-groups delete |
| Lista członków grupy | Lista członków | bird voice ring-groups members list |
| Dodanie członka | Dodanie członka | bird voice ring-groups members create |
| Usuń członka | Usuń członka | bird voice ring-groups members delete |
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.
Następne kroki
| Strona | Czego dotyczy |
|---|---|
| Telefon | Przechodzenie w tryb online, Twój status i odbieranie połączeń w przeglądarce |
| Odbieranie połączeń | Wszystkie trasy, jakie może mieć numer, i jak interpretować odrzucone połączenie |
| Rejestr połączeń | Rekord, który pozostawia każde połączenie, oraz sposób jego filtrowania i eksportowania |
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.