Sign inGet Started

Inkomende trunkoproepen routeren op herkomst en nummer van de beller

Met Inbound routing kan een SIP-trunk oproepen verschillend behandelen, afhankelijk van wie er belt en welk nummer diegene heeft gekozen. Regels controleren gegevens van elke oproep, zoals het lijntype of het land van de beller, en bepalen wat er gebeurt: de oproep naar een groep gateways sturen, het nummer wijzigen dat je apparatuur ontvangt, de oproep weigeren of doorschakelen. Deze pagina geeft werkende configuraties voor de meest voorkomende situaties.

Voordat je begint

  • Een SIP-trunk met inkomende oproepen ingeschakeld, de gateways in minstens één groep en je nummers die naar de trunk verwijzen. Een SIP-trunk instellen behandelt alle drie.
  • Open Voice > SIP Trunks, open de trunk en ga naar Inbound routing > Rules.

Hoe regels werken

Bird controleert de regels voor elke inkomende oproep van boven naar beneden. De eerste regel waarvan de When overeenkomt, bepaalt wat er met de oproep gebeurt. Een oproep die met geen enkele regel overeenkomt, gebruikt de Default route (No rule above matched). Elke regel en de standaardroute hebben een Then: Route to group, Reject of Forward to number. Een trunk bevat maximaal 50 regels.

Een When is een voorwaarde op basis van deze oproepgegevens. Kies een gegeven uit de lijst of gebruik Edit expression om de voorwaarde zelf te schrijven.

GegevenWat het bevat
orig.line_typeHet lijntype van de beller: LINE_FIXED, LINE_MOBILE, LINE_TOLL_FREE, LINE_PAYPHONE of LINE_UNKNOWN
orig.countryDe landcode van twee letters van de beller, zoals GB. Leeg als de beller zijn nummer heeft afgeschermd
orig.anonymoustrue als de beller zijn nummer heeft afgeschermd
orig.numberHet nummer van de beller in E.164, met +
orig.digitsHet nummer van de beller zonder de voorloop-+
dest.numberHet gekozen nummer in E.164, met +
dest.digitsHet gekozen nummer, zonder de voorloop-+
call.local_hourHet uur van de oproep, 0 tot en met 23, in de tijdzone van de routering
call.weekdayDe dag van de oproep, in de tijdzone van de routering

Schrijf lijntypes als constanten, zoals orig.line_type == LINE_MOBILE. Een onbekende constante geeft een fout bij het opslaan. Een verkeerd gespelde string zoals "LINE_MOBLE" wordt wel geaccepteerd, maar komt nooit overeen.

Mobiele bellers en bellers met een vaste lijn naar verschillende gateways sturen

Gebruik dit bijvoorbeeld als mobiele bellers bij de ene SBC moeten uitkomen en alle andere bellers bij een andere.

  1. Maak in Groups een groep voor elke bestemming, bijvoorbeeld mobile met je mobiele SBC en landline met de andere.
  2. Selecteer in Rules de optie Add rule en noem de regel Mobile callers. Stel When in op Line type met de waarde LINE_MOBILE.
  3. Stel Then in op Route to group en kies mobile.
  4. Stel de Default route in op Route to group en kies landline. Deze route krijgt elke oproep die niet aan de regel voldeed.
  5. Selecteer Review and save en bevestig.

Op dezelfde manier routeer je op land: stel When met Edit expression in op een voorwaarde zoals orig.country == GB.

Een prefix toevoegen op basis van de herkomst van de beller

Je SBC verwacht mogelijk een prefix voor het gekozen nummer dat aangeeft waar de beller vandaan komt, bijvoorbeeld 801 voor vast, 802 voor mobiel en 800 voor al het andere. Bird wijzigt het user-deel van de Request-URI die het naar je gateway stuurt; host en poort van de gateway blijven gelijk. Bij een oproep naar +44 808 157 0123 komt een mobiele beller dan binnen als sip:802448081570123@198.51.100.20.

Je kunt dit op twee gelijkwaardige manieren instellen.

Eén regel per herkomst

Gebruik dit als elke herkomst als eigen item in de editor moet verschijnen, of als herkomsten meer verschillen dan alleen de prefix, bijvoorbeeld een andere groep.

  1. Selecteer in Rules de optie Add rule, noem de regel Landline en stel When in op Line type met de waarde LINE_FIXED.
  2. Stel Then in op Route to group, kies je groep onder Group en selecteer Override R-URI user part. Typ 801 en voeg daarna met Insert dest.digits toe.
  3. Herhaal dit voor Mobile (LINE_MOBILE, prefix 802).
  4. Stel de Default route in op Route to group met als user-deel 800 gevolgd door dest.digits.
  5. Selecteer Review and save en bevestig.

Eén expressie

Gebruik dit als alleen het voorvoegsel verandert. Laat Rules leeg, stel de Default route in op Route to group met je groep, selecteer Override R-URI user part, voeg deze expressie in en zet dest.digits erachter:

Codevoorbeeld
orig.line_type == LINE_FIXED ? "801" : orig.line_type == LINE_MOBILE ? "802" : "800"

Beide opzetten leveren dezelfde INVITE af. Het eigen R-URI user part van een gateway accepteert alleen vaste tekst rond het gekozen nummer. Zet een voorvoegsel dat van de beller afhangt daarom in een regel of in de standaardroute, zoals hierboven.

Je opzet controleren

  1. Review and save controleert elke voorwaarde en elk sjabloon en toont de fouten met hun locatie. Er wordt niets opgeslagen totdat je ze hebt opgelost.
  2. Bel een van je nummers vanaf een mobiele telefoon, vanaf een vaste lijn en met afgeschermd nummer. Vergelijk op je SBC de Request-URI van elke ontvangen INVITE met wat je verwacht.
  3. Open elk gesprek onder Voice > Legs en gebruik de SIP Call-ID ervan om hetzelfde gesprek in de logs van je SBC te vinden.

Volgende stappen

PaginaWat er behandeld wordt
Gesprekken ontvangenNummerroutes, groepen, de standaardroute en geweigerde oproepen
Een SIP-trunk instellenEen volledige trunkconfiguratie in volgorde, van aanmaken tot testoproep
Oproepen plaatsenWat Bird verwacht in de INVITE die je apparatuur verstuurt

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.