Groupes de sonnerie

Un groupe de sonnerie fait sonner les personnes de votre espace de travail qui sont en ligne dans le téléphone du navigateur. Acheminez un numéro, ou la route par défaut de votre espace de travail, vers un groupe : un appel entrant fait alors sonner les membres en ligne du groupe dans le tableau de bord jusqu'à ce que l'un d'eux réponde.

Chaque espace de travail dispose d'un groupe Default qui fait sonner toutes les personnes en ligne. Ajoutez vos propres groupes pour faire sonner une équipe plus restreinte, par exemple le support ou les ventes, puis associez chaque numéro au groupe qui doit y répondre.

Avant de commencer

• Des membres qui se mettent en ligne. Un groupe de sonnerie ne fait sonner que les membres en ligne dans le téléphone du navigateur. Recevoir des appels explique comment se mettre en ligne et qui peut le faire.
• L'autorisation de gérer Voice. Pour consulter les groupes de sonnerie, il faut voice_management en lecture. Pour créer, renommer ou supprimer un groupe, modifier ses membres et acheminer un numéro vers un groupe, il faut cette autorisation en écriture.
• Pour API ou CLI : une clé API disposant du scope voice_management au niveau requis par l'opération.

Le groupe par défaut

Le groupe Default figure toujours en tête de la liste. Ses membres sont tous les utilisateurs en ligne dans l'espace de travail au moment où un appel arrive : vous n'y ajoutez donc jamais personne. Vous ne pouvez ni le renommer, ni le supprimer, ni modifier ses membres : une telle requête est refusée avec 409 et E21072.

Son ID se compose de vrg_ suivi du suffixe de l'ID de votre espace de travail ; il est donc identique à chaque lecture. Utilisez-le partout où un ID de groupe de sonnerie est accepté.

Créer un groupe d'appel

1. Ouvrez Voice > Ring groups et sélectionnez New ring group.
2. Saisissez un Name et sélectionnez Create ring group.
3. Dans les Members du groupe, sélectionnez Add member et choisissez chaque utilisateur que le groupe doit faire sonner. La liste propose les utilisateurs qui ont accès à l'espace de travail.

La colonne Online compte les membres du groupe qui sont en ligne et acceptent les appels. Elle inclut les membres déjà en communication, que le groupe ne fait sonner qu'une fois cet appel terminé. Un nouveau groupe n'a aucun membre, la colonne affiche donc 0 jusqu'à ce que vous en ajoutiez.

Via l'API, créez le groupe d'appel, puis ajoutez chaque membre par son ID utilisateur. Pour trouver les ID utilisateur, exécutez bird members list, qui nécessite le scope members en lecture.

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 Support

curl -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_01krdgeqcxet5s7t44vh8rt9mg

curl -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 utilisateur qui quitte ensuite l'espace de travail reste dans la liste jusqu'à ce que vous le retiriez, mais le groupe ne le fait jamais sonner. Pour retirer un membre, sélectionnez Remove à côté de son nom, ou retirez le membre via l'API. Un membre retiré n'est plus appelé dès l'appel suivant.

Acheminer les appels vers un groupe d'appel

Un numéro fait sonner un groupe lorsque sa propre route, ou la route par défaut de l'espace de travail qu'il suit, désigne ce groupe.

• Un seul numéro : ouvrez Voice > Numbers, ouvrez le numéro, puis sous Inbound routing choisissez Ring a ring group. Choisissez le groupe et sélectionnez Save.
• Tous les numéros sans route propre : sur la page Numbers, à côté de Calls to numbers without their own route, sélectionnez Change, choisissez Ring a ring group et le groupe, puis enregistrez.

Via l'API, définissez la route sur {"type": "ring_group", "ring_group_id": "<id>"} lorsque vous mettez à jour le numéro, ou dans les paramètres vocaux pour la route par défaut. Un ring_group_id qui ne désigne ni le groupe par défaut ni un groupe de l'espace de travail est refusé avec 422.

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

curl -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 accepte les mêmes options --route ring_group --ring-group-id pour la route par défaut. Recevoir des appels décrit les autres routes et explique comment rétablir la route par défaut d'un numéro.

Une séquence peut aussi faire sonner un groupe, depuis une étape d'appel. Le résultat de l'étape fait ensuite continuer la séquence : c'est là que se place une messagerie vocale ou un transfert lorsque le groupe ne répond pas.

Comment sonne un groupe d'appel

Lorsqu'un appel arrive pour un groupe, Bird récupère les membres du groupe joignables à ce moment et les mélange dans un ordre aléatoire :

• Les membres sont appelés par lots de cinq, pendant 20 secondes au plus par lot. Lorsque tous les membres d'un lot refusent ou sont injoignables, le lot suivant commence aussitôt.
• La sonnerie s'arrête après 60 secondes au total.
• Le premier membre qui sélectionne Accept prend l'appel, et la sonnerie s'arrête pour les autres.
• Un membre ne sonne que sur un seul appareil : le navigateur qui détient son statut en ligne.

Un membre est ignoré s'il est hors ligne, Busy, déjà en communication, ou Not accepting calls après trois appels manqués d'affilée. Votre statut explique chacun de ces cas.

L'appelant entend la sonnerie pendant que les membres sont appelés. L'appel n'est décroché qu'au moment où un membre l'accepte, donc le temps de sonnerie n'est pas facturé. Si personne ne répond en 60 secondes, ou si personne n'est joignable, un numéro routé directement vers le groupe refuse l'appel. Pour rediriger ailleurs les appelants sans réponse, routez le numéro vers une séquence qui fait sonner le groupe puis continue.

Supprimer un groupe d'appel

Sélectionnez le groupe sur la page Ring groups, puis sélectionnez Delete ring group. Les appels qui font déjà sonner ses membres ne sont pas affectés.

Un groupe d'appel encore utilisé par un numéro, par la route par défaut de l'espace de travail ou par une séquence publiée ne peut pas être supprimé : la requête est refusée avec 409 et E21071. Redirigez d'abord chacun d'eux vers une autre route, puis supprimez le groupe.

Limites

Le groupe par défaut n'a pas de limite de membres. Une création ou un ajout de membre qui dépasse une limite est refusé avec 422, accompagné d'un message qui nomme la limite. Le nombre d'utilisateurs pouvant être en ligne en même temps est une limite de l'organisation, décrite dans Limite d'utilisateurs en ligne.

Gérer les groupes d'appel depuis API, CLI ou MCP

Le serveur MCP propose les mêmes opérations sous forme d'outils voice_ring_groups_*, et ses outils voice_numbers_update et voice_settings_update acceptent une route ring_group. Chaque lecture d'un groupe inclut online_member_count, le même nombre que celui de la colonne Online.

Étapes suivantes