--- title: "Groupes de sonnerie" description: "Faites sonner votre équipe dans le téléphone du navigateur quand un appel arrive sur un numéro, grâce à des groupes de sonnerie que vous gérez dans le tableau de bord ou via API, CLI et MCP." canonical: "https://bird.com/fr-fr/documentation/guides/voice/ring-groups" --- # 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](/docs/guides/voice/phone). 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](/docs/guides/voice/phone#receive-calls) 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**](https://bird.com/dashboard/w/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](/docs/api/reference/create-voice-ring-group), puis [ajoutez chaque membre](/docs/api/reference/create-voice-ring-group-member) par son ID utilisateur. Pour trouver les ID utilisateur, exécutez [`bird members list`](/docs/cli/reference/members-list), qui nécessite le scope `members` en lecture. **TypeScript** ```typescript const group = await bird.voice.ringGroups.create({ name: "Support" }); console.log(group.id, group.name); ``` Examples: [TypeScript](/fr-fr/documentation/guides/voice/ring-groups.ts.md) · [Python](/fr-fr/documentation/guides/voice/ring-groups.py.md) · [Go](/fr-fr/documentation/guides/voice/ring-groups.go.md) · [PHP](/fr-fr/documentation/guides/voice/ring-groups.php.md) · [CLI](/fr-fr/documentation/guides/voice/ring-groups.cli.md) · [MCP](/fr-fr/documentation/guides/voice/ring-groups.mcp.md) · [cURL](/fr-fr/documentation/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](/fr-fr/documentation/guides/voice/ring-groups.ts.md) · [Python](/fr-fr/documentation/guides/voice/ring-groups.py.md) · [Go](/fr-fr/documentation/guides/voice/ring-groups.go.md) · [PHP](/fr-fr/documentation/guides/voice/ring-groups.php.md) · [CLI](/fr-fr/documentation/guides/voice/ring-groups.cli.md) · [MCP](/fr-fr/documentation/guides/voice/ring-groups.mcp.md) · [cURL](/fr-fr/documentation/guides/voice/ring-groups.curl.md) 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](/docs/api/reference/delete-voice-ring-group-member) 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**](https://bird.com/dashboard/w/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": ""}` lorsque vous [mettez à jour le numéro](/docs/api/reference/update-voice-number), ou dans les [paramètres vocaux](/docs/api/reference/update-voice-settings) 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`. **CLI** ```cli bird voice numbers update vnu_01krdgeqcxet5s7t44vh8rt9mg \ --route ring_group --ring-group-id vrg_01krdgeqcxet5s7t44vh8rt9mg ``` Examples: [CLI](/fr-fr/documentation/guides/voice/ring-groups.cli.md) · [cURL](/fr-fr/documentation/guides/voice/ring-groups.curl.md) `bird voice settings update` accepte les mêmes options `--route ring_group --ring-group-id` pour la route par défaut. [Recevoir des appels](/docs/guides/voice/receiving-calls) 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](/docs/guides/voice/phone#your-status) 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 | Limite | Valeur | | ----------------------------------------------------------- | ------ | | Groupes de sonnerie par espace de travail, hors **Default** | 50 | | Membres par groupe de sonnerie | 200 | | Membres appelés simultanément | 5 | | Durée de sonnerie par appel | 60 s | 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](/docs/guides/voice/phone#users-online-limit). ## Gérer les groupes d'appel depuis API, CLI ou MCP | Tâche | API | CLI | | ----------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | Lister les groupes de l'espace de travail | [Lister les groupes d'appel](/docs/api/reference/list-voice-ring-groups) | [`bird voice ring-groups list`](/docs/cli/reference/voice-ring-groups-list) | | Créer un groupe | [Créer un groupe d'appel](/docs/api/reference/create-voice-ring-group) | [`bird voice ring-groups create`](/docs/cli/reference/voice-ring-groups-create) | | Renommer un groupe | [Mettre à jour un groupe de sonnerie](/docs/api/reference/update-voice-ring-group) | [`bird voice ring-groups update`](/docs/cli/reference/voice-ring-groups-update) | | Supprimer un groupe | [Supprimer un groupe de sonnerie](/docs/api/reference/delete-voice-ring-group) | [`bird voice ring-groups delete`](/docs/cli/reference/voice-ring-groups-delete) | | Lister les membres d'un groupe | [Lister les membres](/docs/api/reference/list-voice-ring-group-members) | [`bird voice ring-groups members list`](/docs/cli/reference/voice-ring-groups-members-list) | | Ajouter un membre | [Ajouter un membre](/docs/api/reference/create-voice-ring-group-member) | [`bird voice ring-groups members create`](/docs/cli/reference/voice-ring-groups-members-create) | | Retirer un membre | [Retirer un membre](/docs/api/reference/delete-voice-ring-group-member) | [`bird voice ring-groups members delete`](/docs/cli/reference/voice-ring-groups-members-delete) | Le [serveur MCP](/docs/ai/mcp-server) 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 | Page | Contenu | | --------------------------------------------------------- | ---------------------------------------------------------------------------------- | | [Téléphone](/docs/guides/voice/phone) | Passer en ligne, votre statut et répondre à un appel dans le navigateur | | [Recevoir des appels](/docs/guides/voice/receiving-calls) | Toutes les routes possibles pour un numéro, et comment interpréter un appel refusé | | [Journal des appels](/docs/guides/voice/call-log) | L'enregistrement laissé par chaque appel, et comment le filtrer et l'exporter | ## 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)