---
title: "Gruppi di squillo"
description: "Fai squillare il tuo team nel telefono del browser quando arriva una chiamata su un numero, con gruppi di squillo che gestisci nella dashboard o tramite API, CLI e MCP."
canonical: "https://bird.com/it-it/documentazione/guides/voice/ring-groups"
---

# Gruppi di squillo

Un gruppo di squillo fa squillare le persone del tuo spazio di lavoro che sono online nel [telefono del browser](/docs/guides/voice/phone). Instrada un numero, o il percorso predefinito del tuo spazio di lavoro, verso un gruppo: una chiamata in arrivo fa squillare nella dashboard i membri online del gruppo finché uno di loro non risponde.

Ogni spazio di lavoro ha un gruppo **Default** che fa squillare tutti gli utenti online. Aggiungi i tuoi gruppi per far squillare un team più piccolo, come l'assistenza o le vendite, e associa ogni numero al gruppo che deve rispondere.

## Prima di iniziare

- **Membri che vanno online.** Un gruppo di squillo fa squillare solo i membri online nel telefono del browser. [Ricevere chiamate](/docs/guides/voice/phone#receive-calls) spiega come andare online e chi può farlo.
- **Autorizzazione a gestire Voice.** Per visualizzare i gruppi di squillo serve `voice_management` a livello di lettura. Per creare, rinominare ed eliminare gruppi, modificarne i membri e instradare un numero verso un gruppo serve a livello di scrittura.
- **Per API o CLI:** una chiave API con l'ambito `voice_management` al livello richiesto dall'operazione.

## Il gruppo predefinito

Il gruppo **Default** è sempre il primo dell'elenco. I suoi membri sono tutti gli utenti online nello spazio di lavoro nel momento in cui arriva una chiamata, quindi non devi mai aggiungervi nessuno. Non può essere rinominato né eliminato e i suoi membri non possono essere modificati: una richiesta in tal senso viene rifiutata con `409` e `E21072`.

Il suo ID è `vrg_` seguito dal suffisso dell'ID del tuo spazio di lavoro, quindi è lo stesso in ogni lettura. Usalo ovunque sia accettato l'ID di un gruppo di squillo.

## Creare un gruppo di squillo

1. Apri **Voice** > [**Ring groups**](https://bird.com/dashboard/w/voice/ring-groups) e seleziona **New ring group**.
2. Inserisci un **Name** e seleziona **Create ring group**.
3. In **Members** del gruppo, seleziona **Add member** e scegli ogni utente che il gruppo deve far squillare. L'elenco propone gli utenti che possono accedere allo spazio di lavoro.

La colonna **Online** conta i membri del gruppo che sono online e accettano chiamate. Include i membri impegnati in una chiamata, che non squillano finché quella chiamata non termina. Un nuovo gruppo non ha membri, quindi mostra 0 finché non li aggiungi.

Tramite API, [crea il gruppo di squillo](/docs/api/reference/create-voice-ring-group), poi [aggiungi ogni membro](/docs/api/reference/create-voice-ring-group-member) tramite il suo ID utente. Per trovare gli ID utente, esegui [`bird members list`](/docs/cli/reference/members-list), che richiede l'ambito `members` in lettura.

**TypeScript**

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

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

Un utente che in seguito lascia lo spazio di lavoro resta nell'elenco finché non lo rimuovi, ma il gruppo non lo fa mai squillare. Per rimuovere un membro, seleziona **Remove** accanto al suo nome, oppure [rimuovi il membro](/docs/api/reference/delete-voice-ring-group-member) tramite API. Un membro rimosso smette di squillare dalla chiamata successiva.

## Instradare le chiamate a un gruppo di squillo

Un numero fa squillare un gruppo quando il suo instradamento, o l'instradamento predefinito dello spazio di lavoro che segue, indica quel gruppo.

- **Un solo numero:** apri **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), apri il numero e in **Inbound routing** scegli **Ring a ring group**. Scegli il gruppo e seleziona **Save**.
- **Tutti i numeri senza un instradamento proprio:** nella pagina **Numbers**, accanto a **Calls to numbers without their own route**, seleziona **Change**, scegli **Ring a ring group** e il gruppo, poi salva.

Tramite API, imposta l'instradamento su `{"type": "ring_group", "ring_group_id": "<id>"}` quando [aggiorni il numero](/docs/api/reference/update-voice-number), oppure nelle [impostazioni vocali](/docs/api/reference/update-voice-settings) per l'instradamento predefinito. Un `ring_group_id` che non corrisponde né al gruppo predefinito né a un gruppo dello spazio di lavoro viene rifiutato con `422`.

**CLI**

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

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

`bird voice settings update` accetta gli stessi flag `--route ring_group --ring-group-id` per l'instradamento predefinito. [Ricevere chiamate](/docs/guides/voice/receiving-calls) descrive gli altri instradamenti e spiega come riportare un numero all'instradamento predefinito.

Anche una sequenza può far squillare un gruppo, da un passaggio di chiamata. L'esito del passaggio prosegue poi la sequenza: è lì che va inserita una segreteria o un inoltro quando il gruppo non risponde.

## Come squilla un gruppo di squillo

Quando arriva una chiamata per un gruppo, Bird legge i membri del gruppo che possono squillare in quel momento e li mescola in ordine casuale:

- I membri squillano cinque alla volta, per un massimo di 20 secondi per gruppo di squilli. Quando tutti i membri di un gruppo di squilli rifiutano o non sono raggiungibili, il gruppo successivo parte subito.
- Lo squillo si interrompe dopo 60 secondi in totale.
- Il primo membro che seleziona **Accept** prende la chiamata e per gli altri lo squillo si interrompe.
- Un membro squilla su un solo dispositivo: il browser che mantiene il suo stato online.

Un membro viene saltato quando è offline, **Busy**, già impegnato in una chiamata oppure **Not accepting calls** dopo tre chiamate perse di fila. [Il tuo stato](/docs/guides/voice/phone#your-status) spiega ciascuno di questi stati.

Mentre i membri squillano, il chiamante sente il segnale di chiamata e la chiamata non riceve risposta finché un membro non accetta, quindi il tempo di squillo non viene addebitato. Se nessuno risponde entro 60 secondi, o nessuno può squillare, un numero instradato direttamente al gruppo rifiuta la chiamata. Per indirizzare altrove i chiamanti senza risposta, instrada il numero a una sequenza che fa squillare il gruppo e poi prosegue.

## Eliminare un gruppo di squillo

Seleziona il gruppo nella pagina **Ring groups** e seleziona **Delete ring group**. Le chiamate che stanno già facendo squillare i suoi membri non vengono interessate.

Non puoi eliminare un gruppo che un numero, l'instradamento predefinito dello spazio di lavoro o una sequenza pubblicata fa ancora squillare: la richiesta viene rifiutata con `409` e `E21071`. Prima indirizza ciascuno di essi verso un altro instradamento, poi elimina il gruppo.

## Limiti

| Limite                                                      | Valore |
| ----------------------------------------------------------- | ------ |
| Gruppi di squillo per spazio di lavoro, oltre a **Default** | 50     |
| Membri per gruppo di squillo                                | 200    |
| Membri fatti squillare contemporaneamente                   | 5      |
| Durata degli squilli per ogni chiamata                      | 60 s   |

Il gruppo predefinito non ha un limite di membri. Una creazione o un membro aggiunto oltre un limite viene rifiutato con `422`, con un messaggio che indica il limite. Il numero di utenti che possono essere online contemporaneamente è un limite dell'organizzazione, descritto in [Limite di utenti online](/docs/guides/voice/phone#users-online-limit).

## Gestire i gruppi di squillo da API, CLI o MCP

| Attività                                 | API                                                                        | CLI                                                                                             |
| ---------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Elencare i gruppi dello spazio di lavoro | [Elencare i gruppi di squillo](/docs/api/reference/list-voice-ring-groups) | [`bird voice ring-groups list`](/docs/cli/reference/voice-ring-groups-list)                     |
| Creare un gruppo                         | [Creare un gruppo di squillo](/docs/api/reference/create-voice-ring-group) | [`bird voice ring-groups create`](/docs/cli/reference/voice-ring-groups-create)                 |
| Rinominare un gruppo                     | [Aggiornare un ring group](/docs/api/reference/update-voice-ring-group)    | [`bird voice ring-groups update`](/docs/cli/reference/voice-ring-groups-update)                 |
| Eliminare un gruppo                      | [Eliminare un ring group](/docs/api/reference/delete-voice-ring-group)     | [`bird voice ring-groups delete`](/docs/cli/reference/voice-ring-groups-delete)                 |
| Elencare i membri di un gruppo           | [Elencare i membri](/docs/api/reference/list-voice-ring-group-members)     | [`bird voice ring-groups members list`](/docs/cli/reference/voice-ring-groups-members-list)     |
| Aggiungere un membro                     | [Aggiungere un membro](/docs/api/reference/create-voice-ring-group-member) | [`bird voice ring-groups members create`](/docs/cli/reference/voice-ring-groups-members-create) |
| Rimuovere un membro                      | [Rimuovere un membro](/docs/api/reference/delete-voice-ring-group-member)  | [`bird voice ring-groups members delete`](/docs/cli/reference/voice-ring-groups-members-delete) |

Il [server MCP](/docs/ai/mcp-server) offre le stesse operazioni come strumenti `voice_ring_groups_*`, e i suoi strumenti `voice_numbers_update` e `voice_settings_update` accettano un instradamento `ring_group`. Ogni lettura di un gruppo include `online_member_count`, lo stesso conteggio della colonna **Online**.

## Passaggi successivi

| Pagina                                                  | Argomenti trattati                                                                         |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| [Telefono](/docs/guides/voice/phone)                    | Andare online, il tuo stato e rispondere a una chiamata nel browser                        |
| [Ricevere chiamate](/docs/guides/voice/receiving-calls) | Tutti gli instradamenti possibili per un numero e come interpretare una chiamata rifiutata |
| [Registro chiamate](/docs/guides/voice/call-log)        | Il record lasciato da ogni chiamata e come filtrarlo ed esportarlo                         |

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