---
title: "Grupy dzwonienia"
description: "Powiadamiaj swój zespół w telefonie przeglądarkowym, gdy na numer przychodzi połączenie, za pomocą grup dzwonienia zarządzanych w panelu lub przez API, CLI i MCP."
canonical: "https://bird.com/pl-pl/dokumentacja/guides/voice/ring-groups"
---

# Grupy dzwonienia

Grupa dzwonienia dzwoni do osób z Twojego obszaru roboczego, które są online w [telefonie przeglądarkowym](/docs/guides/voice/phone). 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ń](/docs/guides/voice/phone#receive-calls) 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**](https://bird.com/dashboard/w/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](/docs/api/reference/create-voice-ring-group), a następnie [dodaj każdego członka](/docs/api/reference/create-voice-ring-group-member) według identyfikatora użytkownika. Aby znaleźć identyfikatory użytkowników, uruchom [`bird members list`](/docs/cli/reference/members-list), co wymaga zakresu `members` na poziomie odczytu.

**TypeScript**

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

Examples: [TypeScript](/pl-pl/dokumentacja/guides/voice/ring-groups.ts.md) · [Python](/pl-pl/dokumentacja/guides/voice/ring-groups.py.md) · [Go](/pl-pl/dokumentacja/guides/voice/ring-groups.go.md) · [PHP](/pl-pl/dokumentacja/guides/voice/ring-groups.php.md) · [CLI](/pl-pl/dokumentacja/guides/voice/ring-groups.cli.md) · [MCP](/pl-pl/dokumentacja/guides/voice/ring-groups.mcp.md) · [cURL](/pl-pl/dokumentacja/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](/pl-pl/dokumentacja/guides/voice/ring-groups.ts.md) · [Python](/pl-pl/dokumentacja/guides/voice/ring-groups.py.md) · [Go](/pl-pl/dokumentacja/guides/voice/ring-groups.go.md) · [PHP](/pl-pl/dokumentacja/guides/voice/ring-groups.php.md) · [CLI](/pl-pl/dokumentacja/guides/voice/ring-groups.cli.md) · [MCP](/pl-pl/dokumentacja/guides/voice/ring-groups.mcp.md) · [cURL](/pl-pl/dokumentacja/guides/voice/ring-groups.curl.md)

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](/docs/api/reference/delete-voice-ring-group-member) 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**](https://bird.com/dashboard/w/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](/docs/api/reference/update-voice-number) albo, w przypadku trasy domyślnej, w [ustawieniach głosowych](/docs/api/reference/update-voice-settings). Wartość `ring_group_id`, która nie jest ani grupą domyślną, ani grupą w obszarze roboczym, jest odrzucana z kodem `422`.

**CLI**

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

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

`bird voice settings update` przyjmuje te same flagi `--route ring_group --ring-group-id` dla trasy domyślnej. Strona [Odbieranie połączeń](/docs/guides/voice/receiving-calls) 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](/docs/guides/voice/phone#your-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

| Limit                                                  | Wartość |
| ------------------------------------------------------ | ------- |
| Grupy dzwonienia na obszar roboczy, oprócz **Default** | 50      |
| Członkowie na grupę dzwonienia                         | 200     |
| Członkowie wywoływani 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`, 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](/docs/guides/voice/phone#users-online-limit).

## Zarządzanie grupami dzwonienia przez API, CLI lub MCP

| Zadanie                             | API                                                                            | CLI                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| Wyświetlanie grup obszaru roboczego | [Wyświetl grupy dzwonienia](/docs/api/reference/list-voice-ring-groups)        | [`bird voice ring-groups list`](/docs/cli/reference/voice-ring-groups-list)                     |
| Tworzenie grupy                     | [Utwórz grupę dzwonienia](/docs/api/reference/create-voice-ring-group)         | [`bird voice ring-groups create`](/docs/cli/reference/voice-ring-groups-create)                 |
| Zmiana nazwy grupy                  | [Aktualizowanie grupy dzwonienia](/docs/api/reference/update-voice-ring-group) | [`bird voice ring-groups update`](/docs/cli/reference/voice-ring-groups-update)                 |
| Usuwanie grupy                      | [Usuwanie grupy dzwonienia](/docs/api/reference/delete-voice-ring-group)       | [`bird voice ring-groups delete`](/docs/cli/reference/voice-ring-groups-delete)                 |
| Wyświetlanie członków grupy         | [Lista członków](/docs/api/reference/list-voice-ring-group-members)            | [`bird voice ring-groups members list`](/docs/cli/reference/voice-ring-groups-members-list)     |
| Dodawanie członka                   | [Dodawanie członka](/docs/api/reference/create-voice-ring-group-member)        | [`bird voice ring-groups members create`](/docs/cli/reference/voice-ring-groups-members-create) |
| Usuwanie członka                    | [Usuń członka](/docs/api/reference/delete-voice-ring-group-member)             | [`bird voice ring-groups members delete`](/docs/cli/reference/voice-ring-groups-members-delete) |

[Serwer MCP](/docs/ai/mcp-server) 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

| Strona                                                    | Co opisuje                                                                      |
| --------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [Telefon](/docs/guides/voice/phone)                       | Przechodzenie w tryb online, Twój status i odbieranie połączenia w przeglądarce |
| [Odbieranie połączeń](/docs/guides/voice/receiving-calls) | Wszystkie trasy, jakie może mieć numer, i jak odczytać odrzucone połączenie     |
| [Rejestr połączeń](/docs/guides/voice/call-log)           | Zapis, który pozostawia każde połączenie, oraz jak go filtrować i eksportować   |

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