Sign inGet Started

Eingehende Trunk-Anrufe nach Herkunft und Nummer des Anrufers routen

Mit dem Inbound routing eines SIP-Trunks behandeln Sie Anrufe unterschiedlich, je nachdem, wer anruft und welche Nummer gewählt wurde. Regeln prüfen Merkmale jedes Anrufs, etwa den Anschlusstyp oder das Land des Anrufers, und legen fest, was geschieht: den Anruf an eine Gruppe von Gateways senden, die Nummer ändern, die Ihre Anlage empfängt, ihn ablehnen oder ihn weiterleiten. Diese Seite zeigt funktionierende Konfigurationen für die häufigsten Fälle.

Voraussetzungen

  • Ein SIP-Trunk mit aktivierten eingehenden Anrufen, dessen Gateways in mindestens einer Gruppe sind und auf den Ihre Nummern verweisen. SIP-Trunk einrichten beschreibt alle drei Schritte.
  • Öffnen Sie Voice > SIP Trunks, öffnen Sie den Trunk und wechseln Sie zu Inbound routing > Rules.

So funktionieren Regeln

Bird prüft die Regeln für jeden eingehenden Anruf von oben nach unten. Die erste Regel, deren When zutrifft, entscheidet über den Anruf. Ein Anruf, auf den keine Regel zutrifft, verwendet die Default route (No rule above matched). Jede Regel und die Standardroute haben ein Then: Route to group, Reject oder Forward to number. Ein Trunk enthält bis zu 50 Regeln.

Ein When ist eine Bedingung über die folgenden Anrufmerkmale. Wählen Sie ein Merkmal aus der Liste oder schreiben Sie die Bedingung mit Edit expression selbst.

MerkmalInhalt
orig.line_typeDer Leitungstyp des Anrufers: LINE_FIXED, LINE_MOBILE, LINE_TOLL_FREE, LINE_PAYPHONE oder LINE_UNKNOWN
orig.countryDer zweibuchstabige Ländercode des Anrufers, etwa GB. Leer, wenn der Anrufer seine Nummer unterdrückt hat
orig.anonymoustrue, wenn der Anrufer seine Nummer unterdrückt hat
orig.numberDie Nummer des Anrufers im E.164-Format, mit +
orig.digitsDie Nummer des Anrufers ohne das führende +
dest.numberDie gewählte Nummer im E.164-Format, mit +
dest.digitsDie gewählte Nummer ohne führendes +
call.local_hourDie Stunde des Anrufs, 0 bis 23, in der Zeitzone des Routings
call.weekdayDer Wochentag des Anrufs, in der Zeitzone des Routings

Schreiben Sie Leitungstypen als Konstanten, etwa orig.line_type == LINE_MOBILE. Eine unbekannte Konstante führt beim Speichern zu einem Fehler, während ein falsch geschriebener String wie "LINE_MOBLE" akzeptiert wird und nie zutrifft.

Anrufer aus Mobil- und Festnetz an unterschiedliche Gateways senden

Nutzen Sie diese Einrichtung, wenn zum Beispiel Anrufer aus dem Mobilfunknetz einen SBC erreichen sollen und alle anderen einen anderen.

  1. Legen Sie unter Groups für jedes Ziel eine Gruppe an, zum Beispiel mobile mit Ihrem SBC für Mobilfunkanrufe und landline mit dem anderen.
  2. Wählen Sie unter Rules die Option Add rule und nennen Sie die Regel Mobile callers. Setzen Sie When auf Line type mit dem Wert LINE_MOBILE.
  3. Setzen Sie Then auf Route to group und wählen Sie mobile.
  4. Setzen Sie die Default route auf Route to group und wählen Sie landline. Sie übernimmt jeden Anruf, auf den die Regel nicht zutrifft.
  5. Wählen Sie Review and save und bestätigen Sie dann.

Nach demselben Muster routen Sie nach Land: Setzen Sie When über Edit expression auf eine Bedingung wie orig.country == GB.

Präfix nach Herkunft des Anrufers hinzufügen

Ihr SBC erwartet möglicherweise vor der gewählten Nummer ein Präfix, das ihm die Herkunft des Anrufers mitteilt, zum Beispiel 801 für Festnetz, 802 für Mobilfunk und 800 für alles andere. Bird ändert den User-Teil der Request-URI, die an Ihr Gateway gesendet wird. Host und Port des Gateways bleiben gleich. Bei einem Anruf an +44 808 157 0123 kommt ein Mobilfunkanrufer dann als sip:802448081570123@198.51.100.20 an.

Sie können dies auf zwei gleichwertige Arten einrichten.

Eine Regel pro Herkunft

Verwenden Sie diese Variante, wenn jede Herkunft im Editor als eigener Eintrag erscheinen soll oder wenn sich die Herkünfte nicht nur im Präfix unterscheiden, etwa durch eine andere Gruppe.

  1. Wählen Sie in Rules die Option Add rule, nennen Sie die Regel Landline und setzen Sie When auf Line type mit dem Wert LINE_FIXED.
  2. Setzen Sie Then auf Route to group, wählen Sie unter Group Ihre Gruppe und dann Override R-URI user part. Geben Sie 801 ein und fügen Sie danach mit Insert dest.digits hinzu.
  3. Wiederholen Sie dies für Mobile (LINE_MOBILE, Präfix 802).
  4. Setzen Sie die Default route auf Route to group mit dem User-Teil 800, gefolgt von dest.digits.
  5. Wählen Sie Review and save und bestätigen Sie anschließend.

Ein einzelner Ausdruck

Nutzen Sie diese Variante, wenn sich nur das Präfix ändert. Lassen Sie Rules leer, setzen Sie die Default route auf Route to group mit Ihrer Gruppe, wählen Sie Override R-URI user part, fügen Sie diesen Ausdruck ein und ergänzen Sie danach dest.digits:

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

Beide Konfigurationen liefern dasselbe INVITE. Der R-URI user part eines Gateways akzeptiert nur festen Text um die gewählte Nummer herum. Legen Sie ein Präfix, das vom Anrufer abhängt, deshalb wie oben in einer Regel oder in der Standardroute fest.

Konfiguration prüfen

  1. Review and save prüft jede Bedingung und jede Vorlage und listet die Fehler mit ihrer Position auf. Erst wenn Sie alle Fehler behoben haben, wird gespeichert.
  2. Rufen Sie eine Ihrer Nummern von einem Mobiltelefon, von einem Festnetzanschluss und mit unterdrückter Rufnummer an. Vergleichen Sie an Ihrem SBC den Request-URI jedes empfangenen INVITE mit dem erwarteten Wert.
  3. Öffnen Sie jeden Anruf unter Voice > Legs und finden Sie denselben Anruf anhand seiner SIP Call-ID in den Logs Ihres SBC.

Nächste Schritte

SeiteInhalt
Anrufe empfangenNummernrouten, Gruppen, die Standardroute und abgelehnte Anrufe
Einen SIP-Trunk einrichtenDie vollständige Einrichtung eines Trunks der Reihe nach, vom Anlegen bis zum Testanruf
Anrufe tätigenWas Bird bei dem INVITE erwartet, das Ihr Equipment sendet

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.