--- title: "Basculer et répartir les appels entrants entre vos passerelles" description: "Utilisez des groupes de recherche sur un trunk SIP pour envoyer les appels entrants vers une passerelle de secours quand la première échoue, ou pour répartir les appels entre les passerelles selon un poids." canonical: "https://bird.com/fr-fr/documentation/guides/voice/hunt-groups" --- # Basculer et répartir les appels entrants entre vos passerelles Le routage d'un trunk SIP détermine le sort de chaque appel entrant : parcourir un groupe de vos passerelles, rejeter l'appel ou le transférer vers un numéro vérifié. Un groupe de recherche est une liste de passerelles que Bird essaie l'une après l'autre jusqu'à ce que l'une d'elles réponde. L'ordre, les priorités, les poids et les durées de sonnerie du groupe déterminent quelle passerelle sonne en premier et ce qui se passe si elle ne répond pas. Cette page explique comment les configurer pour la bascule et pour la répartition de charge. ## Avant de commencer - Un trunk SIP avec les appels entrants activés et au moins une passerelle. [Configurer un trunk SIP](/docs/guides/voice/sip-trunk-setup) couvre ces deux points. Lorsque vous ajoutez la première passerelle à un trunk dont le routage n'a jamais été enregistré, le tableau de bord fait pointer la route par défaut vers **All gateways (automatic)**, le groupe qui contient toutes les passerelles du trunk. - Les passerelles à combiner, ajoutées dans l'onglet **Inbound routing** > **Gateways** du trunk. ## Fonctionnement de la recherche dans un groupe Chaque appel entrant lance une recherche. Bird ordonne les passerelles du groupe pour cet appel, fait sonner la première, puis passe à la suivante en cas d'échec : - Une passerelle sonne pendant sa **Ring time**, de 1 à 120 secondes (30 par défaut). Si personne ne répond dans ce délai, Bird passe à la suivante. - Une passerelle qui n'envoie aucune réponse est ignorée après un court délai : une passerelle hors service ne fait donc pas attendre l'appelant pendant toute sa durée de sonnerie. - Si une passerelle refuse l'appel avec un code d'échec SIP, la recherche passe à la passerelle suivante, sauf si ce code figure dans le champ **Stop the hunt on** du groupe. - La recherche s'arrête lorsqu'une passerelle répond ou lorsque toutes les passerelles du groupe ont été essayées. Bird ordonne chaque appel indépendamment et ne conserve aucune rotation d'un appel à l'autre : il n'y a donc pas de round-robin. Une répartition uniforme résulte d'un ordre aléatoire ou pondéré sur de nombreux appels. | Ordre | Comment les passerelles sont ordonnées pour chaque appel | Usage | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | **Sequential** | L'ordre de la liste, de haut en bas | Une passerelle principale fixe et des passerelles de secours | | **Random** | Un nouvel ordre aléatoire | Répartir les appels uniformément | | **Weighted** | D’abord la **Priority** la plus basse. Pour une même priorité, un ordre aléatoire où la probabilité de chaque passerelle de passer en premier correspond à sa part du poids total | Basculement et répartition pondérée en même temps | ## Utiliser le groupe automatique Toutes les passerelles d'un trunk font partie de **All gateways (automatic)**, sauf si le routage enregistré du trunk contient à sa place un groupe qui vous est propre (voir la fin de cette section). Une passerelle que vous ajoutez ou supprimez rejoint ce groupe ou le quitte. Ce groupe utilise l'ordre **Weighted**, des poids égaux et une durée de sonnerie de 30 secondes, et il essaie les passerelles dans l'ordre de la **Priority** que vous définissez dans l'onglet **Gateways**. Dans le groupe lui-même, vous ne pouvez modifier ni son nom, ni son **Order**, ni ses durées de sonnerie, ni ses membres. Pour une bascule via ce groupe, attribuez à la passerelle principale une **Priority** plus basse qu'à la passerelle de secours dans l'onglet **Gateways**. Les passerelles qui ont la même **Priority** se partagent les appels uniformément. Pour d'autres durées de sonnerie, d'autres poids ou des codes **Stop the hunt on**, ajoutez votre propre groupe avec les mêmes passerelles, comme le montrent les sections suivantes. Un groupe nommé **All gateways** que le tableau de bord a créé lorsque vous avez ajouté votre première passerelle est un groupe qui vous est propre : il ne contient que les passerelles avec lesquelles il a été enregistré. Si l'onglet **Groups** n'affiche pas **All gateways (automatic)**, le routage enregistré du trunk contient à sa place un groupe qui vous est propre, généralement nommé **All gateways**. Si vous le supprimez, le groupe automatique reprend sa place : les appels qui lui étaient destinés font alors sonner toutes les passerelles, dans l'ordre de **Priority**, avec une durée de sonnerie de 30 secondes. Conservez-le s'il contient les passerelles, les durées de sonnerie ou les codes **Stop the hunt on** que vous souhaitez. ## Configurer le basculement 1. Ouvrez **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), ouvrez le trunk, puis accédez à **Inbound routing** > **Groups**. 2. Ouvrez l'un de vos propres groupes, ou sélectionnez **Add group** et nommez-le. **All gateways (automatic)** n'est pas modifiable. 3. Ajoutez votre passerelle principale et votre passerelle de secours avec **Add gateway to group**. 4. Réglez **Order** sur **Sequential** et laissez la passerelle principale en haut de la liste à l’aide de **Move up** et **Move down**. Vous pouvez aussi régler **Order** sur **Weighted** et attribuer la **Priority** 1 à la passerelle principale et la **Priority** 2 à la passerelle de secours. 5. Définissez le **Ring time** de chaque passerelle. Avec un temps de sonnerie plus court sur la passerelle principale, les appels sans réponse passent plus tôt à la passerelle de secours. 6. Dans l'onglet **Rules**, réglez le champ **Then** de la **Default route** sur **Route to group** et choisissez le groupe, ou faites pointer une règle vers celui-ci. Un groupe qu'aucune route n'utilise ne reçoit aucun appel. 7. Sélectionnez **Review and save**, puis confirmez. ## Répartir les appels entre les passerelles 1. Dans le trunk, ouvrez **Inbound routing** > **Groups**. Ouvrez l'un de vos propres groupes, ou sélectionnez **Add group**, nommez-le, puis ajoutez les passerelles avec **Add gateway to group**. 2. Réglez **Order** sur **Weighted**, attribuez la même **Priority** aux passerelles et définissez le **Weight** de chacune entre 1 et 100. Avec des poids de 70 et 30, chaque passerelle reçoit environ 70 % et 30 % des appels. Pour une répartition égale, utilisez des poids identiques ou réglez **Order** sur **Random**. 3. Pour conserver aussi une passerelle de secours, attribuez la **Priority** 1 aux passerelles qui se partagent les appels et la **Priority** 2 à la passerelle de secours. Celle-ci ne sonne que lorsque toutes les passerelles de priorité 1 ont échoué. 4. Dans l'onglet **Rules**, réglez le champ **Then** de la **Default route** sur **Route to group** et choisissez le groupe, ou faites pointer une règle vers celui-ci. 5. Sélectionnez **Review and save**, puis confirmez. ## Arrêter la recherche sur un signal d'occupation Par défaut, Bird essaie la passerelle suivante à chaque échec. Lorsqu'un échec signifie qu'une autre passerelle n'y changera rien, ajoutez son code dans le champ **Stop the hunt on** du groupe. Par exemple, ajoutez `486` (Busy Here) pour qu'une personne déjà en communication ne soit pas rappelée via une deuxième passerelle. Vous pouvez saisir n'importe quel code de 400 à 699. ## Acheminer différents appels vers différents groupes Un trunk peut comporter plusieurs groupes. La **Default route** envoie vers un groupe les appels qui ne correspondent à aucune règle, et les règles de l'onglet **Rules** peuvent envoyer d'autres appels vers d'autres groupes. [Acheminer des appels vers un trunk SIP](/docs/guides/voice/receiving-calls#deliver-calls-to-a-sip-trunk) explique les règles et la route par défaut. ## Dépannage | Ce que vous constatez | Ce qu'il faut vérifier | | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | La passerelle de secours ne sonne jamais | La passerelle de secours doit faire partie du groupe utilisé par la route par défaut (ou par la règle correspondante). Avec **Weighted**, son numéro de **Priority** doit être supérieur à celui de la passerelle principale. Un code dans **Stop the hunt on** peut arrêter la recherche avant la passerelle de secours | | Une seule passerelle reçoit tous les appels avec **Weighted** | Les passerelles de priorités différentes ne se partagent pas les appels. Attribuez-leur la même **Priority** | | Les appels sonnent trop longtemps avant d’atteindre la passerelle de secours | Réduisez la **Ring time** de la passerelle principale | | Une passerelle ne sonne jamais | Elle ne fait partie d’aucun groupe utilisé par une règle ou par la route par défaut. Lors de l’enregistrement, le tableau de bord affiche l’avertissement **Calls never reach some gateways** | ## Étapes suivantes | Page | Contenu | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | [Configurer un trunk SIP](/docs/guides/voice/sip-trunk-setup) | La configuration complète d’un trunk, dans l’ordre, de sa création à un appel de test | | [Recevoir des appels](/docs/guides/voice/receiving-calls) | Routes par numéro, règles, route par défaut et appels refusés | | [Dépannage de la voix](/docs/guides/voice/troubleshooting) | Diagnostiquer un appel à partir de son symptôme | ## 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)