--- title: "Inkomende oproepen omleiden en verdelen over je gateways" description: "Gebruik huntgroepen op een SIP-trunk om inkomende oproepen naar een backupgateway te sturen als de eerste uitvalt, of om oproepen op gewicht over gateways te verdelen." canonical: "https://bird.com/nl-nl/documentatie/guides/voice/hunt-groups" --- # Inkomende oproepen omleiden en verdelen over je gateways De routering van een SIP-trunk bepaalt wat er met elke inkomende oproep gebeurt: een groep van je gateways afgaan, de oproep weigeren of hem doorschakelen naar een geverifieerd nummer. Een huntgroep is een lijst gateways die Bird een voor een probeert totdat er een opneemt. De volgorde, prioriteiten, gewichten en beltijden van de groep bepalen welke gateway eerst overgaat en wat er gebeurt als die niet opneemt. Op deze pagina lees je hoe je ze instelt voor failover en voor het verdelen van de belasting. ## Voordat je begint - Een SIP-trunk met inkomende oproepen ingeschakeld en minstens één gateway. [Een SIP-trunk instellen](/docs/guides/voice/sip-trunk-setup) behandelt beide. Als je de eerste gateway toevoegt aan een trunk waarvan de routering nog nooit is opgeslagen, laat het dashboard de standaardroute verwijzen naar **All gateways (automatic)**, de groep met alle gateways van de trunk. - De gateways die je wilt combineren, toegevoegd op het tabblad **Inbound routing** > **Gateways** van de trunk. ## Hoe een groep de gateways afgaat Elke inkomende oproep start een hunt. Bird bepaalt voor die oproep de volgorde van de gateways in de groep, laat de eerste overgaan en gaat door naar de volgende als die mislukt: - Een gateway gaat over gedurende zijn **Ring time**, van 1 tot 120 seconden (standaard 30). Als niemand binnen die tijd opneemt, gaat Bird verder. - Een gateway die helemaal geen antwoord stuurt, wordt na korte tijd overgeslagen. Zo houdt een uitgevallen gateway de beller niet zijn hele beltijd vast. - Als een gateway de oproep weigert met een SIP-foutcode, gaat de hunt door naar de volgende gateway, tenzij die code in **Stop the hunt on** van de groep staat. - De hunt stopt zodra een gateway opneemt of wanneer elke gateway in de groep is geprobeerd. Bird bepaalt de volgorde per gesprek en houdt geen rotatie tussen gesprekken bij, dus er is geen round-robin. Een gelijkmatige verdeling ontstaat over veel gesprekken door een willekeurige of gewogen volgorde. | Volgorde | Hoe de gateways per gesprek worden geordend | Gebruik het voor | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | **Sequential** | De volgorde van de lijst, van boven naar beneden | Een vaste primaire gateway met back-ups | | **Random** | Telkens een nieuwe willekeurige volgorde | Gesprekken gelijkmatig verdelen | | **Weighted** | Laagste **Priority** eerst. Binnen één prioriteit een willekeurige volgorde waarin de kans dat een gateway als eerste gaat gelijk is aan zijn aandeel in de gewichten | Failover en gewogen verdeling tegelijk | ## De automatische groep gebruiken Elke gateway van een trunk zit in **All gateways (automatic)**, tenzij de opgeslagen routering van de trunk op die plaats een eigen groep bevat (zie het einde van deze sectie). Een gateway die je toevoegt of verwijdert, komt automatisch in de groep of verdwijnt eruit. De groep gebruikt de volgorde **Weighted**, gelijke gewichten en een beltijd van 30 seconden, en probeert de gateways in de volgorde van de **Priority** die je op het tabblad **Gateways** instelt. In de groep zelf kun je de naam, **Order**, beltijden en leden niet bewerken. Voor failover via deze groep geef je de primaire gateway op het tabblad **Gateways** een lagere **Priority** dan de back-up. Gateways met dezelfde **Priority** verdelen de oproepen gelijkmatig. Wil je andere beltijden, gewichten of codes voor **Stop the hunt on**, voeg dan een eigen groep met dezelfde gateways toe, zoals de volgende secties laten zien. Een groep met de naam **All gateways** die het dashboard heeft aangemaakt toen je je eerste gateway toevoegde, is je eigen groep: die bevat alleen de gateways waarmee hij is opgeslagen. Als het tabblad **Groups** geen **All gateways (automatic)** toont, bevat de opgeslagen routering van de trunk op die plaats een eigen groep, meestal met de naam **All gateways**. Als je die verwijdert, komt de automatische groep weer op zijn plaats: oproepen die naar die groep gingen, laten dan elke gateway overgaan, in volgorde van **Priority** en met een beltijd van 30 seconden. Houd de groep als die de gateways, beltijden of codes voor **Stop the hunt on** bevat die je wilt. ## Failover instellen 1. Open **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), open de trunk en ga naar **Inbound routing** > **Groups**. 2. Open een eigen groep, of selecteer **Add group** en geef de groep een naam. **All gateways (automatic)** kun je niet bewerken. 3. Voeg je primaire gateway en je back-up toe met **Add gateway to group**. 4. Zet **Order** op **Sequential** en houd de primaire gateway bovenaan met **Move up** en **Move down**. Je kunt ook **Order** op **Weighted** zetten en de primaire gateway **Priority** 1 en de back-up **Priority** 2 geven. 5. Stel per gateway de **Ring time** in. Met een kortere beltijd op de primaire gateway gaan onbeantwoorde oproepen sneller naar de back-up. 6. Zet op het tabblad **Rules** de **Then** van de **Default route** op **Route to group** en kies de groep, of laat een regel naar de groep verwijzen. Een groep die door geen enkele route wordt gebruikt, ontvangt geen oproepen. 7. Selecteer **Review and save** en bevestig. ## Oproepen verdelen over gateways 1. Open **Inbound routing** > **Groups** van de trunk. Open een eigen groep, of selecteer **Add group**, geef de groep een naam en voeg de gateways toe met **Add gateway to group**. 2. Zet **Order** op **Weighted**, geef de gateways dezelfde **Priority** en stel voor elke gateway een **Weight** van 1 tot 100 in. Met gewichten van 70 en 30 gaat ongeveer 70% en 30% van de oproepen naar de betreffende gateway. Voor een gelijke verdeling gebruik je gelijke gewichten of zet je **Order** op **Random**. 3. Wil je ook een back-up houden, geef de gateways die de oproepen delen dan **Priority** 1 en de back-up **Priority** 2. De back-up gaat alleen over wanneer elke gateway met prioriteit 1 is mislukt. 4. Zet op het tabblad **Rules** de **Then** van de **Default route** op **Route to group** en kies de groep, of laat een regel naar de groep verwijzen. 5. Selecteer **Review and save** en bevestig. ## Stop het zoeken bij een bezettoon Bird probeert bij elke fout de volgende gateway, tenzij je dat wijzigt. Als een andere gateway bij een bepaalde fout niet helpt, zet je de code ervan in **Stop the hunt on** van de groep. Voeg bijvoorbeeld `486` (Busy Here) toe, zodat iemand die al in gesprek is niet opnieuw wordt gebeld via een tweede gateway. Je kunt elke code van 400 tot 699 invoeren. ## Verschillende oproepen naar verschillende groepen routeren Een trunk kan meerdere groepen hebben. De **Default route** stuurt oproepen waarop geen regel van toepassing is naar één groep, en de regels op het tabblad **Rules** kunnen andere oproepen naar andere groepen sturen. [Oproepen afleveren bij een SIP-trunk](/docs/guides/voice/receiving-calls#deliver-calls-to-a-sip-trunk) legt regels en de standaardroute uit. ## Problemen oplossen | Wat je ziet | Wat je controleert | | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | De back-up gaat nooit over | De back-up zit in de groep die de standaardroute (of de overeenkomende regel) gebruikt. Bij **Weighted** is het **Priority**-nummer hoger dan dat van de primaire gateway. Een code in **Stop the hunt on** beëindigt het zoeken vóór de back-up | | Eén gateway krijgt elke oproep bij **Weighted** | Gateways met verschillende prioriteiten verdelen geen oproepen. Geef ze dezelfde **Priority** | | Oproepen gaan te lang over voordat ze de back-up bereiken | Verlaag de **Ring time** van de primaire gateway | | Een gateway gaat nooit over | De gateway zit in geen enkele groep die een regel of de standaardroute gebruikt. Bij het opslaan waarschuwt het dashboard met **Calls never reach some gateways** | ## Volgende stappen | Pagina | Wat er behandeld wordt | | ------------------------------------------------------------------- | ------------------------------------------------------------------------ | | [Een SIP-trunk instellen](/docs/guides/voice/sip-trunk-setup) | Een volledige trunkconfiguratie op volgorde, van aanmaken tot testoproep | | [Oproepen ontvangen](/docs/guides/voice/receiving-calls) | Nummerroutes, regels, de standaardroute en geweigerde oproepen | | [Problemen met spraak oplossen](/docs/guides/voice/troubleshooting) | Een gesprek diagnosticeren aan de hand van het symptoom | ## 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)