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. Dirigez 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 Everyone qui fait sonner toutes les personnes en ligne. Ajoutez vos propres groupes pour faire sonner une équipe plus restreinte, comme le support ou les ventes, et dirigez chaque numéro vers le groupe qui doit y répondre.

Avant de commencer

• Des membres qui se mettent en ligne. Un groupe de sonnerie fait sonner uniquement 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 et supprimer des groupes, modifier leurs membres et diriger 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 Everyone apparaît toujours en premier dans 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 identifiant est vrg_ suivi du suffixe de l'identifiant de votre espace de travail ; il reste donc identique à chaque lecture. Utilisez-le partout où un identifiant de groupe de sonnerie est accepté.

Créer un groupe de sonnerie

1. Ouvrez Voice > Ring groups et sélectionnez New ring group.
2. Saisissez un Name et sélectionnez Create ring group.
3. Dans la section 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, qui ne sont sollicités qu'à la fin de cet appel. 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 de sonnerie, 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 sollicité dès l'appel suivant.

Acheminer les appels vers un groupe de sonnerie

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.

• Pour 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.
• Pour 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. Une valeur ring_group_id qui ne correspond ni au groupe par défaut ni à un groupe de l'espace de travail est refusée 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 poursuit ensuite la séquence : c'est là que vous placez une messagerie vocale ou un transfert lorsque le groupe ne répond pas.

Comment sonne un groupe de sonnerie

Lorsqu'un appel arrive pour un groupe, Bird lit les membres du groupe joignables à cet instant et les mélange dans un ordre aléatoire :

• Les membres sonnent par lots de cinq, pendant 20 secondes au maximum par lot. Lorsque tous les membres d'un lot refusent l'appel 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, en statut Busy, déjà en communication, ou en statut Not accepting calls après trois appels manqués d'affilée. Votre statut explique chaque cas.

L'appelant entend la tonalité pendant que les membres sonnent, et l'appel n'est décroché qu'au moment où un membre l'accepte : le temps de sonnerie n'est donc 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 les appels sans réponse ailleurs, routez le numéro vers une séquence qui fait sonner le groupe, puis continue.

Dans les API des segments d'appel vocal, le segment de l'appelant les nomme dans answered_by. Dans un enregistrement ou une transcription, le champ user_id de l'interlocuteur nomme le membre de ce côté.

Supprimer un groupe de sonnerie

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 concernés.

Vous ne pouvez pas supprimer un groupe que fait encore sonner un numéro, la route par défaut de l'espace de travail ou une séquence publiée : la requête est refusée avec 409 et E21071. Dirigez 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 indique la limite concernée. Le nombre d'utilisateurs pouvant être en ligne simultanément 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 de groupe inclut online_member_count, le même décompte que la colonne Online.

Étapes suivantes