Grupos de llamada
Un grupo de llamada hace sonar a las personas de tu espacio de trabajo que están conectadas en el teléfono del navegador. 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 conectados del grupo hasta que uno de ellos responda.
Cada espacio de trabajo tiene un grupo Everyone que hace sonar a todas las personas conectadas. Añade tus propios grupos para hacer sonar a un equipo más pequeño, como soporte o ventas, y asigna a cada número el grupo que debe atenderlo.
Antes de empezar
- Miembros que se conecten. Un grupo de llamada solo hace sonar a los miembros conectados en el teléfono del navegador. Recibir llamadas explica cómo conectarse y quién puede hacerlo.
- Permiso para gestionar Voice. Para ver los grupos de llamada necesitas
voice_managementcon nivel de lectura. Para crear, renombrar y eliminar grupos, 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_managementen el nivel que requiera la operación.
El grupo predeterminado
El grupo Everyone aparece siempre el primero de la lista. Sus miembros son todos los usuarios conectados 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 todas las lecturas. Úsalo en cualquier lugar donde se acepte el ID de un grupo de llamada.
Crear un grupo de llamada
- Abre Voice > Ring groups y selecciona New ring group.
- Escribe un Name y selecciona Create ring group.
- En Members del grupo, selecciona Add member y elige cada usuario al que debe 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 conectados y aceptan llamadas. Incluye a los miembros que están en una llamada, a quienes no se les llama hasta que esa llamada termina. Un grupo nuevo no tiene miembros, así que muestra 0 hasta que los añades.
Con la API, crea el grupo de llamada y después añade cada miembro por su ID de usuario. Para encontrar los ID de usuario, ejecuta bird members list, que necesita el ámbito members con nivel de lectura.
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"
}'Un usuario que más tarde abandona el espacio de trabajo sigue en la lista hasta que lo quitas, pero el grupo nunca lo llama. Para quitar un miembro, selecciona Remove junto a él o quita el miembro con la API. A un miembro quitado se le deja de llamar a partir de la siguiente llamada.
Enrutar 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 número: abre 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, o en la configuración de voz para la ruta predeterminada. Un ring_group_id que no sea el grupo predeterminado ni un grupo del espacio de trabajo se rechaza con 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 admite las mismas opciones --route ring_group --ring-group-id para la ruta predeterminada. Recibir llamadas explica 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 va un buzón de voz o un desvío cuando nadie del grupo contesta.
Cómo suena un grupo de llamada
Cuando llega una llamada para un grupo, Bird lee los miembros del grupo a los que se puede llamar 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 timbre se detiene tras 60 segundos en total.
- El primer miembro que selecciona Accept atiende la llamada, y a los demás les deja de sonar.
- A cada miembro le suena en 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 explica cada uno.
Quien 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 timbre no se factura. Si nadie contesta en 60 segundos, o no se puede llamar a nadie, un número enrutado directamente al grupo rechaza la llamada. Para enviar las llamadas sin contestar a otro destino, enruta el número a una secuencia que haga sonar el grupo y después continúe.
En los tramos de voz API, el tramo de quien llama identifica al miembro en answered_by. En una grabación o una transcripción, el campo user_id del participante identifica al miembro de ese lado.
Eliminar un grupo de llamada
Selecciona el grupo en la página Ring groups y selecciona Delete ring group. Las llamadas que ya están sonando para 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 Everyone | 50 |
| Miembros por grupo de llamada | 200 |
| Miembros a los que se llama a la vez | 5 |
| Tiempo de timbre de cada 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, se rechaza con 422 y un mensaje que indica el límite. Cuántos usuarios 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.
Gestiona los grupos de llamada desde API, CLI o MCP
| Tarea | API | CLI |
|---|---|---|
| Listar los grupos del espacio de trabajo | Listar grupos de llamada | bird voice ring-groups list |
| Crear un grupo | Crear un grupo de llamada | bird voice ring-groups create |
| Cambiar el nombre de un grupo | Actualizar un grupo de llamada | bird voice ring-groups update |
| Eliminar un grupo | Eliminar un grupo de llamada | bird voice ring-groups delete |
| Listar los miembros de un grupo | Listar miembros | bird voice ring-groups members list |
| Añadir un miembro | Añadir un miembro | bird voice ring-groups members create |
| Eliminar un miembro | Eliminar un miembro | bird voice ring-groups members delete |
El servidor MCP 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 la columna Online.
Próximos pasos
| Página | Qué trata |
|---|---|
| Teléfono | Conectarte, tu estado y contestar una llamada en el navegador |
| Recibir llamadas | Todas las rutas que puede seguir un número y cómo interpretar una llamada rechazada |
| Registro de llamadas | El registro que deja cada llamada y cómo filtrarlo y exportarlo |
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.