--- title: "Een SIP-trunk instellen om gesprekken te ontvangen en te voeren" description: "Verbind je PBX of SBC in deze volgorde met Bird: maak de trunk aan, lever inkomende gesprekken af bij je gateways, zet uitgaande gesprekken open en test beide richtingen." canonical: "https://bird.com/nl-nl/documentatie/guides/voice/sip-trunk-setup" --- # Een SIP-trunk instellen om gesprekken te ontvangen en te voeren Deze pagina beschrijft een volledige trunkconfiguratie in de volgorde die het dashboard vereist. Als het overslaan van een stap een zichtbaar symptoom geeft, noemt de stap dat symptoom. Zo kun je de pagina ook als checklist gebruiken wanneer een testgesprek mislukt. Wat elke instelling betekent, lees je via de links naar [SIP-trunks](/docs/guides/voice/sip-trunks), [Gesprekken ontvangen](/docs/guides/voice/receiving-calls) en [Gesprekken voeren](/docs/guides/voice/placing-calls). ## Voordat je begint - Een Bird-werkruimte. Gesprekken, nummers en trunks horen bij één werkruimte, dus voer elke stap in dezelfde werkruimte uit. - De openbare adressen van je apparatuur: de hosts waar Bird gesprekken naartoe moet sturen, en de adressen waarvandaan je apparatuur SIP verstuurt. - Voor inkomende gesprekken een Bird-nummer in die werkruimte. Voor uitgaande gesprekken een beller-ID: een Bird-nummer in de werkruimte of een nummer dat je hebt [geverifieerd](/docs/guides/voice/caller-ids). - Een Bird-nummer waarvan de `status` `active` is. Een nummer dat nog wacht op de eigendomsdocumenten of de registratie, verwerkt geen inkomende of uitgaande gesprekken: zie [De eigendomsdocumenten van een nummer indienen](/docs/guides/numbers/ownership-paperwork). ## 1. Maak de trunk aan Open **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), selecteer **Add new SIP trunk**, voer een naam in en selecteer **Create trunk**. Een nieuwe trunk verwerkt in geen enkele richting gesprekken totdat je elke richting inschakelt. ## 2. Schakel inkomende gesprekken in Selecteer onder **Inbound calling** de optie **Enable inbound**. Daaronder verschijnt de sectie **Inbound routing**. Als je deze stap overslaat, kun je nummers niet naar de trunk laten verwijzen: de trunk ontbreekt dan in de trunklijst van het nummer. ## 3. Voeg je gateways toe Open in **Inbound routing** het tabblad **Gateways** en selecteer **Add gateway** voor elk adres waarop Bird gesprekken moet afleveren: | Veld | Wat je invult | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Een label dat je herkent, zoals `Primary SBC` | | **Host** | De hostnaam of het openbare IP-adres van je apparatuur, zonder `sip:` of gebruikersdeel | | **Port** | Laat leeg voor de standaardpoort van het transport, of vul de poort in waarop je apparatuur luistert | | **Transport** | UDP, TCP of TLS, passend bij je apparatuur | | **R-URI user part** | Hoe het gekozen nummer in de Request-URI wordt geschreven. Standaard is dit E.164 met `+` | | **Origination format** | Hoe het nummer van de beller wordt geschreven. Standaard is dit E.164 met `+` | | **Priority** | De plaats van de gateway in **All gateways (automatic)**: lagere nummers gaan eerst over, en gelijke nummers verdelen de oproepen. Standaard is dit 0 | Verwacht je apparatuur nummers zonder de voorloop-`+`, open dan de lijst van het formaat en kies **Without the plus**, of een internationaal voorvoegsel `00` of `011`. [What a gateway needs](/docs/guides/voice/receiving-calls#what-a-gateway-needs) legt de nummerformaten uit. Bird geeft de `To`-header ongewijzigd door, zoals de provider van de beller die heeft verstuurd. Leest je apparatuur het gekozen nummer uit `To`, selecteer dan **Rewrite To user part** en stel hetzelfde formaat samen als bij **R-URI user part**. Bird vervangt dan het gebruikersdeel van `To` bij gesprekken naar die gateway. Je gateway moet oproepen van Bird accepteren zonder SIP Digest-challenge, omdat Bird daar niet op antwoordt. ## 4. Kies de groep waarin oproepen naar een gateway zoeken Bird levert een oproep af bij een groep gateways. Elke gateway zit in **All gateways (automatic)**, die de gateways probeert in de volgorde van hun **Priority** op het tabblad **Gateways**, de laagste eerst. Wil je via deze groep failover, geef de back-upgateway dan een hoger **Priority**-nummer dan de primaire gateway. Toont het tabblad **Groups** geen **All gateways (automatic)**, dan bevat de opgeslagen routering van de trunk op die plaats een eigen groep, en bepaalt **Priority** niet de volgorde in die groep. Zie [Use the automatic group](/docs/guides/voice/hunt-groups#use-the-automatic-group). Als je de eerste gateway toevoegt aan een trunk waarvan de routering nog nooit is opgeslagen, laat het dashboard de standaardroute naar **All gateways (automatic)** verwijzen. Wil je andere beltijden, gewichten of alleen een deel van de gateways, stel dan je eigen groep samen: selecteer op het tabblad **Groups** de optie **Add group**, geef de groep een naam en gebruik **Add gateway to group** voor elke gateway. [Inkomende gesprekken laten failoveren en verdelen](/docs/guides/voice/hunt-groups) legt elke volgorde uit, en ook de beltijd en wanneer het zoeken naar een gateway stopt. ## 5. Laat de standaardroute naar de groep verwijzen Zoek op het tabblad **Rules** de **Default route** (**No rule above matched**). Zet **Then** op **Route to group** en kies je groep. Selecteer **Review and save** en bevestig. De standaardroute behandelt elke oproep waarop geen regel van toepassing is, dus zonder regels behandelt hij elke oproep. Staat hij op **Reject**, dan worden die oproepen geweigerd voordat ze je apparatuur bereiken, ook als er gateways in een groep zitten. Bij de controle waarschuwt het dashboard met **Calls never reach some gateways** wanneer een gateway in geen enkele groep zit waarnaar een regel of de standaardroute oproepen stuurt. Los die waarschuwing op voordat je test. Deze standaardroute hoort bij de trunk. Hij staat los van de werkruimte-instelling **Calls to numbers without their own route** op de pagina **Numbers**, die bepaalt wat er gebeurt met nummers zonder eigen route. ## 6. Laat je nummers naar de trunk verwijzen Open **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), open het nummer en kies onder **Inbound routing** de optie **Deliver to a SIP trunk**. Kies de trunk en sla op. Een nummer zonder eigen route volgt de standaardroute van de werkruimte, die in het begin op weigeren staat. Wil je al zulke nummers in één keer naar deze trunk sturen, zet dan **Calls to numbers without their own route** op de trunk. Zie [Een standaardroute instellen](/docs/guides/voice/receiving-calls#set-a-default-route). Sla je deze stap over terwijl de standaardroute van de werkruimte nog op weigeren staat, dan worden inkomende oproepen geweigerd en toont het oproeprecord bij **Inbound route** de waarde **Reject the leg**. ## 7. Schakel uitgaande oproepen in en bepaal wie mag versturen Selecteer onder **Outbound calling** de optie **Enable outbound**. De sectie **Connection** verschijnt met het **SIP domain** van de trunk. Bird herkent je trunk aan dit domein, dus kopieer het volledig. Voeg daarna minstens één manier toe waarop de trunk je apparatuur herkent: - **Allowed IP addresses**: de openbare adressen waarvandaan je apparatuur SIP verstuurt. Zit je apparatuur achter NAT, gebruik dan het openbare adres van de router. - **Allowed API keys**: voor apparatuur die een Digest-challenge beantwoordt, met gebruikersnaam `bird` en het geheim van een API-sleutel als wachtwoord. Zolang uitgaand bellen niet aanstaat, weigert de trunk elk uitgaand gesprek. Zolang de trunk je apparatuur niet herkent, worden gesprekken geweigerd voordat er een gespreksrecord bestaat. Zie [Bepalen wie gesprekken mag versturen](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 8. Configureer je PBX of SBC Op je PBX of SBC: - **Stuur uitgaande gesprekken naar het SIP-domein van de trunk.** Zet het SIP-domein als host in de Request-URI. Gebruik poort `5060` (UDP of TCP) of `5061` (TLS). Een gesprek met een andere hostnaam in de Request-URI wordt geweigerd. - **Kies in internationaal formaat.** Zet het gebelde nummer in het gebruikersdeel van de Request-URI als `+` gevolgd door de landcode, bijvoorbeeld `+442071234567`. Voeg geen technisch voorvoegsel toe. Zie [Wat Bird verwacht in de INVITE](/docs/guides/voice/placing-calls#what-bird-expects-on-the-invite). - **Geef een toegestane beller-ID mee** in de `From`-header. - **Bied G.711 aan** (A-law of µ-law) en verstuur DTMF als RFC 4733-telefoongebeurtenissen. Hetzelfde gedeelte van die pagina behandelt media. - **Sta de adressen van Bird toe.** Als je firewall of SBC alleen vermelde adressen accepteert, sta dan de signalerings- en media-adressen van de regio van je trunk toe. Je vindt ze in [Netwerkvereisten voor SIP-trunks](/docs/guides/voice/network-requirements). ## 9. Zet de landen aan die je belt Open **Voice** > [**Destinations**](https://bird.com/dashboard/w/voice/destinations), vink elk land aan dat je belt en selecteer **Save changes**. In een nieuwe werkruimte staat geen enkel land aan, en een oproep naar een uitgeschakeld land wordt geweigerd met `destination_not_enabled`. Zie [Spraakbestemmingen](/docs/guides/voice/destinations). ## 10. Test beide richtingen 1. **Inkomend:** bel je Bird-nummer vanaf een gewone telefoon en open daarna **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) in dezelfde werkruimte. 2. **Uitgaand:** bel vanaf je apparatuur naar een bereikbaar nummer in een ingeschakeld land en gebruik je Bird-nummer of een geverifieerd nummer als nummerweergave. Je hebt hiervoor geen tweede Bird-nummer nodig. 3. Open elke leg. **Inbound route** laat zien wat het nummer moest doen. Bij een geweigerde oproep zie je de reden en, als je het met een eigen instelling kunt oplossen, een link naar die instelling. Bij een geslaagde oproep staat **Answered**. Bewaar de **Leg ID** als je contact opneemt met support. Ontbreekt een oproep, wordt die geweigerd of bereikt die je apparatuur nooit, volg dan [Probleemoplossing voor spraak](/docs/guides/voice/troubleshooting), dat vanuit het symptoom begint. ## Volgende stappen | Pagina | Wat er behandeld wordt | | ------------------------------------------------------------------- | ---------------------------------------------------------------------- | | [SIP-trunks](/docs/guides/voice/sip-trunks) | Alle trunkinstellingen, authenticatie en Digest | | [Oproepen ontvangen](/docs/guides/voice/receiving-calls) | Nummerroutes, gateways, groepen en de standaardroute van de werkruimte | | [Gesprekken plaatsen](/docs/guides/voice/placing-calls) | Wat Bird verwacht in de `INVITE` | | [Problemen met spraak oplossen](/docs/guides/voice/troubleshooting) | Een gesprek diagnosticeren vanuit 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)