---
title: "Belgroepen"
description: "Laat je team in de browsertelefoon overgaan wanneer er een oproep binnenkomt op een nummer, met belgroepen die je beheert in het dashboard of via de API, CLI en MCP."
canonical: "https://bird.com/nl-nl/documentatie/guides/voice/ring-groups"
---

# Belgroepen

Een belgroep belt de mensen in je werkruimte die online zijn in de [browsertelefoon](/docs/guides/voice/phone). Routeer een nummer, of de standaardroute van je werkruimte, naar een groep. Een inkomende oproep belt dan de online leden van de groep in het dashboard totdat een van hen opneemt.

Elke werkruimte heeft een groep **Default** die iedereen belt die online is. Voeg eigen groepen toe om een kleiner team te bellen, zoals support of sales, en verwijs elk nummer naar de groep die het moet beantwoorden.

## Voordat je begint

- **Leden die online gaan.** Een belgroep belt alleen leden die online zijn in de browsertelefoon. [Oproepen ontvangen](/docs/guides/voice/phone#receive-calls) legt uit hoe je online gaat en wie dat kan.
- **Toestemming om Voice te beheren.** Om belgroepen te bekijken heb je `voice_management` op leesniveau nodig. Om groepen te maken, te hernoemen, te verwijderen, leden te wijzigen en een nummer naar een groep te routeren, heb je deze op schrijfniveau nodig.
- **Voor de API of CLI:** een API-sleutel met de scope `voice_management` op het niveau dat de bewerking vereist.

## De standaardgroep

De groep **Default** staat altijd bovenaan de lijst. De leden zijn alle gebruikers die online zijn in de werkruimte op het moment dat een oproep binnenkomt, dus je voegt er nooit iemand aan toe. Je kunt de groep niet hernoemen of verwijderen en de leden niet wijzigen: zo'n verzoek wordt geweigerd met `409` en `E21072`.

De ID ervan is `vrg_` gevolgd door het achtervoegsel van je werkruimte-ID, dus die is bij elke uitlezing hetzelfde. Gebruik deze overal waar een belgroep-ID wordt geaccepteerd.

## Een ring group maken

1. Open **Voice** > [**Ring groups**](https://bird.com/dashboard/w/voice/ring-groups) en selecteer **New ring group**.
2. Voer een **Name** in en selecteer **Create ring group**.
3. Selecteer in de **Members** van de groep **Add member** en kies elke gebruiker die de groep moet bellen. De lijst toont gebruikers die toegang hebben tot de werkruimte.

De kolom **Online** telt de leden van een groep die online zijn en oproepen accepteren. Daarbij horen ook leden die in gesprek zijn, maar die worden pas gebeld als dat gesprek is afgelopen. Een nieuwe groep heeft geen leden, dus de kolom staat op 0 totdat je leden toevoegt.

Via de API [maak je de ring group aan](/docs/api/reference/create-voice-ring-group) en [voeg je elk lid toe](/docs/api/reference/create-voice-ring-group-member) op gebruikers-ID. Gebruikers-ID's vind je met [`bird members list`](/docs/cli/reference/members-list). Daarvoor heb je de scope `members` op leesniveau nodig.

**TypeScript**

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

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

Een gebruiker die later de werkruimte verlaat, blijft in de lijst staan totdat je hem verwijdert, maar de groep belt hem nooit. Om een lid te verwijderen selecteer je **Remove** naast dat lid, of je [verwijdert het lid](/docs/api/reference/delete-voice-ring-group-member) via de API. Een verwijderd lid wordt vanaf de volgende oproep niet meer gebeld.

## Oproepen naar een ring group routeren

Een nummer belt een groep wanneer de eigen route van het nummer, of de standaardroute van de werkruimte die het volgt, die groep noemt.

- **Eén nummer:** open **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), open het nummer en kies onder **Inbound routing** de optie **Ring a ring group**. Kies de groep en selecteer **Save**.
- **Elk nummer zonder eigen route:** selecteer op de pagina **Numbers**, naast **Calls to numbers without their own route**, de optie **Change**, kies **Ring a ring group** en de groep, en sla op.

Via de API stel je de route in op `{"type": "ring_group", "ring_group_id": "<id>"}` wanneer je [het nummer bijwerkt](/docs/api/reference/update-voice-number), of in de [voice-instellingen](/docs/api/reference/update-voice-settings) voor de standaardroute. Een `ring_group_id` die niet de standaardgroep is en ook geen groep in de werkruimte, wordt geweigerd met `422`.

**CLI**

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

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

`bird voice settings update` accepteert dezelfde `--route ring_group --ring-group-id`-flags voor de standaardroute. [Oproepen ontvangen](/docs/guides/voice/receiving-calls) beschrijft de andere routes en hoe je een nummer terugzet naar de standaardroute.

Een sequence kan ook een groep laten overgaan, vanuit een belstap. De uitkomst van die stap zet de sequence daarna voort. Daar hoort een voicemail of een doorschakeling thuis als de groep niet opneemt.

## Hoe een belgroep overgaat

Wanneer er een oproep voor een groep binnenkomt, leest Bird welke leden van de groep op dat moment gebeld kunnen worden en zet ze in een willekeurige volgorde:

- Leden worden per vijf tegelijk gebeld, maximaal 20 seconden per groepje. Als elk lid van een groepje weigert of onbereikbaar is, begint het volgende groepje meteen.
- Het overgaan stopt na in totaal 60 seconden.
- Het eerste lid dat **Accept** selecteert, neemt de oproep aan en bij de anderen stopt het overgaan.
- Bij een lid gaat maar één apparaat over: de browser die zijn onlinestatus bevat.

Een lid wordt overgeslagen als het offline is, op **Busy** staat, al in gesprek is, of op **Not accepting calls** staat na drie gemiste oproepen achter elkaar. [Je status](/docs/guides/voice/phone#your-status) legt elke status uit.

De beller hoort een kiestoon terwijl de leden worden gebeld. De oproep wordt pas beantwoord als een lid accepteert, dus de tijd van het overgaan wordt niet gefactureerd. Als niemand binnen 60 seconden opneemt, of niemand gebeld kan worden, weigert een nummer dat rechtstreeks naar de groep routeert de oproep. Wil je onbeantwoorde bellers ergens anders heen sturen, routeer het nummer dan naar een sequence die de groep laat overgaan en daarna verdergaat.

## Een belgroep verwijderen

Selecteer de groep op de pagina **Ring groups** en selecteer **Delete ring group**. Oproepen die al bij de leden overgaan, blijven ongewijzigd.

Een groep die nog wordt gebeld door een nummer, de standaardroute van de werkruimte of een gepubliceerde sequence, kun je niet verwijderen: het verzoek wordt geweigerd met `409` en `E21071`. Stel eerst voor elk van deze een andere route in en verwijder daarna de groep.

## Limieten

| Limiet                                       | Waarde |
| -------------------------------------------- | ------ |
| Belgroepen per werkruimte, naast **Default** | 50     |
| Leden per belgroep                           | 200    |
| Leden die tegelijk worden gebeld             | 5      |
| Beltijd per oproep                           | 60 s   |

De standaardgroep heeft geen ledenlimiet. Als het aanmaken van een groep of het toevoegen van een lid een limiet overschrijdt, wordt het verzoek geweigerd met `422` en een melding die de limiet noemt. Hoeveel gebruikers tegelijk online kunnen zijn, is een limiet van de organisatie, beschreven in [Limiet voor online gebruikers](/docs/guides/voice/phone#users-online-limit).

## Belgroepen beheren via de API, CLI of MCP

| Taak                                   | API                                                                       | CLI                                                                                             |
| -------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| De groepen van de werkruimte weergeven | [Belgroepen weergeven](/docs/api/reference/list-voice-ring-groups)        | [`bird voice ring-groups list`](/docs/cli/reference/voice-ring-groups-list)                     |
| Een groep aanmaken                     | [Een belgroep aanmaken](/docs/api/reference/create-voice-ring-group)      | [`bird voice ring-groups create`](/docs/cli/reference/voice-ring-groups-create)                 |
| Een groep hernoemen                    | [Een belgroep bijwerken](/docs/api/reference/update-voice-ring-group)     | [`bird voice ring-groups update`](/docs/cli/reference/voice-ring-groups-update)                 |
| Een groep verwijderen                  | [Een belgroep verwijderen](/docs/api/reference/delete-voice-ring-group)   | [`bird voice ring-groups delete`](/docs/cli/reference/voice-ring-groups-delete)                 |
| De leden van een groep weergeven       | [Leden weergeven](/docs/api/reference/list-voice-ring-group-members)      | [`bird voice ring-groups members list`](/docs/cli/reference/voice-ring-groups-members-list)     |
| Een lid toevoegen                      | [Een lid toevoegen](/docs/api/reference/create-voice-ring-group-member)   | [`bird voice ring-groups members create`](/docs/cli/reference/voice-ring-groups-members-create) |
| Een lid verwijderen                    | [Een lid verwijderen](/docs/api/reference/delete-voice-ring-group-member) | [`bird voice ring-groups members delete`](/docs/cli/reference/voice-ring-groups-members-delete) |

De [MCP-server](/docs/ai/mcp-server) biedt dezelfde bewerkingen als `voice_ring_groups_*`-tools, en de tools `voice_numbers_update` en `voice_settings_update` accepteren een `ring_group`-route. Elke uitgelezen groep bevat `online_member_count`, hetzelfde aantal als in de kolom **Online**.

## Volgende stappen

| Pagina                                                     | Onderwerp                                                                           |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| [Telefoon](/docs/guides/voice/phone)                       | Online gaan, je status en een gesprek aannemen in de browser                        |
| [Gesprekken ontvangen](/docs/guides/voice/receiving-calls) | Elke route die een nummer kan volgen, en hoe je een geweigerd gesprek interpreteert |
| [Gesprekslogboek](/docs/guides/voice/call-log)             | De registratie die elk gesprek achterlaat, en hoe je die filtert en exporteert      |

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