---
title: "Grupos de llamada"
description: "Haz sonar a tu equipo en el teléfono del navegador cuando entra una llamada en un número, con grupos de llamada que gestionas en el panel o mediante API, CLI y MCP."
canonical: "https://bird.com/es-es/documentacion/guides/voice/ring-groups"
---

# Grupos de llamada

Un grupo de llamada hace sonar a las personas de tu espacio de trabajo que están en línea en el [teléfono del navegador](/docs/guides/voice/phone). Dirige un número, o la ruta predeterminada de tu espacio de trabajo, a un grupo, y cada llamada entrante sonará en el panel para los miembros del grupo que estén en línea hasta que uno de ellos conteste.

Cada espacio de trabajo tiene un grupo **Default** que hace sonar a todas las personas en línea. Añade tus propios grupos para hacer sonar a un equipo más pequeño, como soporte o ventas, y dirige cada número al grupo que debe contestarlo.

## Antes de empezar

- **Miembros que se conectan.** Un grupo de llamada solo hace sonar a los miembros que están en línea en el teléfono del navegador. En [Recibir llamadas](/docs/guides/voice/phone#receive-calls) se explica cómo conectarse y quién puede hacerlo.
- **Permiso para gestionar Voice.** Para ver los grupos de llamada necesitas `voice_management` con nivel de lectura. Para crearlos, cambiarles el nombre, eliminarlos, cambiar sus miembros y dirigir un número a un grupo, lo necesitas con nivel de escritura.
- **Para API o CLI:** una clave de API con el ámbito `voice_management` en el nivel que requiere la operación.

## El grupo predeterminado

El grupo **Default** aparece siempre primero en la lista. Sus miembros son todos los usuarios en línea en el espacio de trabajo en el momento en que llega una llamada, así que nunca tienes que añadir a nadie. No se puede renombrar ni eliminar, y sus miembros no se pueden cambiar: cualquier solicitud para hacerlo se rechaza con `409` y `E21072`.

Su ID es `vrg_` seguido del sufijo del ID de tu espacio de trabajo, por lo que es el mismo en cada lectura. Úsalo en cualquier lugar donde se acepte el ID de un grupo de llamada.

## Crear un grupo de llamada

1. Abre **Voice** > [**Ring groups**](https://bird.com/dashboard/w/voice/ring-groups) y selecciona **New ring group**.
2. Introduce un **Name** y selecciona **Create ring group**.
3. En **Members** del grupo, selecciona **Add member** y elige cada usuario al que deba llamar el grupo. La lista ofrece los usuarios que tienen acceso al espacio de trabajo.

La columna **Online** cuenta los miembros del grupo que están en línea y aceptan llamadas. Incluye a los miembros que están en una llamada, a los que no se llama hasta que esa llamada termina. Un grupo nuevo no tiene miembros, así que muestra 0 hasta que los añadas.

Con la API, [crea el grupo de llamada](/docs/api/reference/create-voice-ring-group) y después [añade cada miembro](/docs/api/reference/create-voice-ring-group-member) por su ID de usuario. Para obtener los ID de usuario, ejecuta [`bird members list`](/docs/cli/reference/members-list), que requiere el ámbito `members` con nivel de lectura.

**TypeScript**

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

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

Si un usuario abandona después el espacio de trabajo, sigue apareciendo en la lista hasta que lo quites, pero el grupo nunca lo llama. Para quitar un miembro, selecciona **Remove** junto a él, o [quita el miembro](/docs/api/reference/delete-voice-ring-group-member) con la API. Un miembro quitado deja de recibir llamadas a partir de la siguiente.

## Dirigir llamadas a un grupo de llamada

Un número llama a un grupo cuando su propia ruta, o la ruta predeterminada del espacio de trabajo que sigue, indica ese grupo.

- **Un solo número:** abre **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), abre el número y, en **Inbound routing**, elige **Ring a ring group**. Elige el grupo y selecciona **Save**.
- **Todos los números sin ruta propia:** en la página **Numbers**, junto a **Calls to numbers without their own route**, selecciona **Change**, elige **Ring a ring group** y el grupo, y guarda.

Con la API, establece la ruta en `{"type": "ring_group", "ring_group_id": "<id>"}` al [actualizar el número](/docs/api/reference/update-voice-number), o en la [configuración de voz](/docs/api/reference/update-voice-settings) para la ruta predeterminada. Si el `ring_group_id` no es el grupo predeterminado ni un grupo del espacio de trabajo, la solicitud se rechaza con `422`.

**CLI**

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

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

`bird voice settings update` admite las mismas opciones `--route ring_group --ring-group-id` para la ruta predeterminada. [Recibir llamadas](/docs/guides/voice/receiving-calls) describe las demás rutas y cómo devolver un número a la ruta predeterminada.

Una secuencia también puede hacer sonar un grupo, desde un paso de marcación. El resultado del paso continúa entonces la secuencia, y ahí es donde se configura un buzón de voz o un desvío cuando el grupo no contesta.

## Cómo suena un grupo de timbrado

Cuando llega una llamada para un grupo, Bird lee los miembros del grupo que pueden recibir la llamada en ese momento y los ordena al azar:

- Los miembros suenan de cinco en cinco, durante un máximo de 20 segundos por tanda. Cuando todos los miembros de una tanda rechazan la llamada o no están localizables, la siguiente tanda empieza de inmediato.
- El timbrado se detiene tras 60 segundos en total.
- El primer miembro que selecciona **Accept** atiende la llamada, y los demás dejan de sonar.
- A cada miembro le suena un solo dispositivo: el navegador que mantiene su estado en línea.

Se omite a un miembro cuando está desconectado, en **Busy**, ya en una llamada, o en **Not accepting calls** tras tres llamadas perdidas seguidas. [Tu estado](/docs/guides/voice/phone#your-status) explica cada uno.

La persona que llama oye el tono mientras suenan los miembros, y la llamada no se contesta hasta que un miembro la acepta, así que el tiempo de timbrado no se factura. Si nadie contesta en 60 segundos, o no se puede hacer sonar a nadie, un número dirigido directamente al grupo rechaza la llamada. Para enviar a otro destino las llamadas no contestadas, dirige el número a una secuencia que haga sonar el grupo y después continúe.

## Eliminar un grupo de timbrado

Selecciona el grupo en la página **Ring groups** y selecciona **Delete ring group**. Las llamadas que ya están sonando a sus miembros no se ven afectadas.

No puedes eliminar un grupo al que todavía llama un número, la ruta predeterminada del espacio de trabajo o una secuencia publicada: la solicitud se rechaza con `409` y `E21071`. Primero dirige cada uno de ellos a otra ruta y después elimina el grupo.

## Límites

| Límite                                                          | Valor |
| --------------------------------------------------------------- | ----- |
| Grupos de llamada por espacio de trabajo, además de **Default** | 50    |
| Miembros por grupo de llamada                                   | 200   |
| Miembros que suenan a la vez                                    | 5     |
| Tiempo de timbrado por llamada                                  | 60 s  |

El grupo predeterminado no tiene límite de miembros. Si una creación o un miembro añadido supera un límite, la solicitud se rechaza con `422` y un mensaje que indica el límite. El número de usuarios que pueden estar en línea a la vez es un límite de la organización, descrito en [Límite de usuarios en línea](/docs/guides/voice/phone#users-online-limit).

## Gestionar grupos de llamada desde API, CLI o MCP

| Tarea                                    | API                                                                           | CLI                                                                                             |
| ---------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Listar los grupos del espacio de trabajo | [Listar grupos de llamada](/docs/api/reference/list-voice-ring-groups)        | [`bird voice ring-groups list`](/docs/cli/reference/voice-ring-groups-list)                     |
| Crear un grupo                           | [Crear un grupo de llamada](/docs/api/reference/create-voice-ring-group)      | [`bird voice ring-groups create`](/docs/cli/reference/voice-ring-groups-create)                 |
| Cambiar el nombre de un grupo            | [Actualizar un grupo de llamada](/docs/api/reference/update-voice-ring-group) | [`bird voice ring-groups update`](/docs/cli/reference/voice-ring-groups-update)                 |
| Eliminar un grupo                        | [Eliminar un grupo de llamada](/docs/api/reference/delete-voice-ring-group)   | [`bird voice ring-groups delete`](/docs/cli/reference/voice-ring-groups-delete)                 |
| Listar los miembros de un grupo          | [Listar miembros](/docs/api/reference/list-voice-ring-group-members)          | [`bird voice ring-groups members list`](/docs/cli/reference/voice-ring-groups-members-list)     |
| Añadir un miembro                        | [Añadir un miembro](/docs/api/reference/create-voice-ring-group-member)       | [`bird voice ring-groups members create`](/docs/cli/reference/voice-ring-groups-members-create) |
| Quitar un miembro                        | [Eliminar un miembro](/docs/api/reference/delete-voice-ring-group-member)     | [`bird voice ring-groups members delete`](/docs/cli/reference/voice-ring-groups-members-delete) |

El [servidor MCP](/docs/ai/mcp-server) ofrece las mismas operaciones como herramientas `voice_ring_groups_*`, y sus herramientas `voice_numbers_update` y `voice_settings_update` aceptan una ruta `ring_group`. Cada lectura de un grupo incluye `online_member_count`, el mismo recuento que muestra la columna **Online**.

## Próximos pasos

| Página                                                 | Qué trata                                                                           |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| [Teléfono](/docs/guides/voice/phone)                   | Cómo conectarte, tu estado y cómo responder una llamada en el navegador             |
| [Recibir llamadas](/docs/guides/voice/receiving-calls) | Todas las rutas que puede seguir un número y cómo interpretar una llamada rechazada |
| [Registro de llamadas](/docs/guides/voice/call-log)    | El registro que deja cada llamada y cómo filtrarlo y exportarlo                     |

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