Sign inGet Started

Einen SIP-Trunk zum Empfangen und Tätigen von Anrufen einrichten

Diese Seite beschreibt eine vollständige Trunk-Einrichtung in der Reihenfolge, die das Dashboard verlangt. Wenn ein übersprungener Schritt ein sichtbares Symptom hinterlässt, nennt der Schritt dieses Symptom. So können Sie die Seite auch als Checkliste nutzen, wenn ein Testanruf fehlschlägt. Was die einzelnen Einstellungen bedeuten, erfahren Sie unter SIP-Trunks, Anrufe empfangen und Anrufe tätigen.

Bevor Sie beginnen

  • Ein Bird-Workspace. Anrufe, Nummern und Trunks gehören zu genau einem Workspace. Führen Sie daher alle Schritte im selben Workspace aus.
  • Die öffentlichen Adressen Ihrer Geräte: die Hosts, an die Bird Anrufe zustellen soll, und die Adressen, von denen Ihre Geräte SIP senden.
  • Für eingehende Anrufe eine Bird-Nummer in diesem Workspace. Für ausgehende Anrufe eine Anrufer-ID: eine Bird-Nummer im Workspace oder eine Nummer, die Sie verifiziert haben.
  • Eine Bird-Nummer, deren status active ist. Eine Nummer, die noch auf ihre Eigentumsnachweise oder ihre Registrierung wartet, überträgt weder eingehende noch ausgehende Anrufe. Siehe Eigentumsnachweise für eine Nummer einreichen.

1. Trunk erstellen

Öffnen Sie Voice > SIP Trunks, wählen Sie Add new SIP trunk, geben Sie einen Namen ein und wählen Sie Create trunk.

Ein neuer Trunk überträgt in keiner Richtung Anrufe, bis Sie die jeweilige Richtung aktivieren.

2. Eingehende Anrufe aktivieren

Wählen Sie unter Inbound calling die Option Enable inbound. Darunter erscheint der Abschnitt Inbound routing.

Wenn Sie diesen Schritt überspringen, können Sie keine Nummern auf den Trunk leiten: Der Trunk fehlt in der Trunk-Liste der Nummer.

3. Gateways hinzufügen

Öffnen Sie in Inbound routing den Tab Gateways und wählen Sie Add gateway für jede Adresse, an die Bird Anrufe zustellen soll:

FeldWas Sie eingeben
NameEine Bezeichnung, die Sie wiedererkennen, zum Beispiel Primary SBC
HostDer Hostname oder die öffentliche IP-Adresse Ihres Geräts, ohne sip: und ohne Benutzerteil
PortLeer lassen für den Standardport des Transports, oder den Port eingeben, auf dem Ihre Geräte lauschen
TransportUDP, TCP oder TLS, passend zu Ihren Geräten
R-URI user partWie die gewählte Nummer in der Request-URI geschrieben wird. Standard ist E.164 mit +
Origination formatWie die anrufende Nummer geschrieben wird. Standard ist E.164 mit +
PriorityDie Position des Gateways in All gateways (automatic): Niedrigere Zahlen klingeln zuerst, gleiche Zahlen teilen sich die Anrufe. Standard ist 0

Wenn Ihre Geräte Nummern ohne führendes + erwarten, öffnen Sie die Liste des Formats und wählen Sie Without the plus oder ein internationales Präfix 00 oder 011. Was ein Gateway benötigt erklärt die Nummernformate.

Bird reicht den To-Header so weiter, wie ihn der Netzbetreiber des Anrufers gesendet hat. Wenn Ihre Geräte die gewählte Nummer aus To lesen, wählen Sie Rewrite To user part und bauen Sie dasselbe Format wie beim R-URI user part auf. Bird ersetzt dann bei Anrufen an dieses Gateway den Benutzerteil von To.

Ihr Gateway muss Anrufe von Bird ohne SIP-Digest-Challenge annehmen, da Bird eine solche Challenge nicht beantwortet.

4. Die Gruppe wählen, die Anrufe absucht

Bird stellt einen Anruf an eine Gruppe von Gateways zu. Jedes Gateway gehört zu All gateways (automatic). Diese Gruppe probiert die Gateways in der Reihenfolge ihrer Priority im Tab Gateways aus, die niedrigste zuerst. Für Failover über diese Gruppe geben Sie dem Backup-Gateway eine höhere Priority-Zahl als dem primären Gateway. Wenn der Tab Groups keine All gateways (automatic) zeigt, enthält das gespeicherte Routing des Trunks an ihrer Stelle eine eigene Gruppe, und Priority bestimmt nicht die Reihenfolge in dieser Gruppe. Siehe Die automatische Gruppe verwenden.

Wenn Sie einem Trunk, dessen Routing noch nie gespeichert wurde, das erste Gateway hinzufügen, richtet das Dashboard die Standardroute auf All gateways (automatic) aus.

Für andere Klingelzeiten, Gewichtungen oder nur einen Teil der Gateways erstellen Sie eine eigene Gruppe: Wählen Sie im Tab Groups die Option Add group, benennen Sie die Gruppe und verwenden Sie Add gateway to group für jedes Gateway. Eingehende Anrufe per Failover umleiten und verteilen erklärt jede Reihenfolge, die Klingelzeit und wann die Suche endet.

5. Die Standardroute auf die Gruppe richten

Suchen Sie im Tab Rules die Default route (No rule above matched). Setzen Sie Then auf Route to group und wählen Sie Ihre Gruppe. Wählen Sie Review and save und bestätigen Sie anschließend.

Die Standardroute nimmt jeden Anruf an, auf den keine Regel zutrifft. Ohne Regeln nimmt sie also jeden Anruf an. Steht sie auf Reject, werden diese Anrufe abgewiesen, bevor sie Ihre Geräte erreichen, auch wenn Gateways in einer Gruppe sind.

In der Überprüfung warnt das Dashboard mit Calls never reach some gateways, wenn ein Gateway in keiner Gruppe liegt, an die eine Regel oder die Standardroute Anrufe sendet. Beheben Sie diese Warnung vor dem Test.

Diese Standardroute gehört zum Trunk. Sie ist unabhängig von der Workspace-Einstellung Calls to numbers without their own route auf der Seite Numbers, die festlegt, was mit Nummern ohne eigene Route geschieht.

6. Ihre Nummern auf den Trunk richten

Öffnen Sie Voice > Numbers, öffnen Sie die Nummer und wählen Sie unter Inbound routing die Option Deliver to a SIP trunk. Wählen Sie den Trunk aus und speichern Sie.

Eine Nummer ohne eigene Route folgt der Standardroute des Workspace, die anfangs auf Abweisen steht. Um alle solchen Nummern auf einmal an diesen Trunk zu senden, setzen Sie Calls to numbers without their own route auf den Trunk. Siehe Standardroute festlegen.

Wenn Sie diesen Schritt überspringen, während die Standardroute des Workspace noch auf Abweisen steht, werden eingehende Anrufe abgewiesen, und die Inbound route im Anrufdatensatz zeigt Reject the leg.

7. Ausgehende Anrufe aktivieren und festlegen, wer senden darf

Wählen Sie unter Outbound calling die Option Enable outbound. Der Abschnitt Connection erscheint mit der SIP domain des Trunks. Bird erkennt Ihren Trunk an dieser Domain, kopieren Sie sie daher vollständig.

Fügen Sie dann mindestens eine Möglichkeit hinzu, an der der Trunk Ihre Geräte erkennt:

  • Allowed IP addresses: die öffentlichen Adressen, von denen Ihre Geräte SIP senden. Hinter NAT verwenden Sie die öffentliche Adresse des Routers.
  • Allowed API keys: für Geräte, die eine Digest-Challenge beantworten, mit dem Benutzernamen bird und einem API-Schlüsselgeheimnis als Passwort.

Solange ausgehende Anrufe nicht aktiviert sind, lehnt der Trunk jeden ausgehenden Anruf ab. Solange der Trunk Ihre Geräte nicht erkennen kann, werden Anrufe abgelehnt, bevor ein Anrufdatensatz entsteht. Siehe Festlegen, wer Anrufe senden darf.

8. Ihre PBX oder Ihren SBC konfigurieren

Auf Ihrer PBX oder Ihrem SBC:

  • Senden Sie ausgehende Anrufe an die SIP-Domain des Trunks. Tragen Sie die SIP-Domain als Host im Request-URI ein. Verwenden Sie Port 5060 (UDP oder TCP) oder 5061 (TLS). Ein Anruf, dessen Request-URI-Host einen anderen Namen enthält, wird abgelehnt.
  • Wählen Sie im internationalen Format. Tragen Sie die angerufene Nummer im User-Teil des Request-URI mit + und der Ländervorwahl ein, zum Beispiel +442071234567. Fügen Sie kein technisches Präfix hinzu. Siehe Was Bird im INVITE erwartet.
  • Übermitteln Sie eine zulässige Anrufer-ID im From-Header.
  • Bieten Sie G.711 an (A-law oder µ-law) und senden Sie DTMF als Telephone Events nach RFC 4733. Derselbe Abschnitt dieser Seite behandelt auch die Medien.
  • Lassen Sie die Adressen von Bird zu. Wenn Ihre Firewall oder Ihr SBC nur aufgelistete Adressen akzeptiert, lassen Sie die Signalisierungs- und Medienadressen der Region Ihres Trunks zu. Diese sind unter SIP-Trunk-Netzwerkanforderungen aufgeführt.

9. Die Länder aktivieren, die Sie anrufen

Öffnen Sie Voice > Destinations, markieren Sie jedes Land, das Sie anrufen, und wählen Sie Save changes. In einem neuen Workspace ist zunächst kein Land aktiviert, und ein Anruf in ein deaktiviertes Land wird mit destination_not_enabled abgelehnt. Siehe Sprachziele.

10. Beide Richtungen testen

  1. Eingehend: Rufen Sie Ihre Bird-Nummer von einem normalen Telefon aus an und öffnen Sie dann im selben Workspace Voice > Legs.
  2. Ausgehend: Rufen Sie von Ihrer Anlage aus eine beliebige erreichbare Nummer in einem aktivierten Land an und übermitteln Sie dabei Ihre Bird-Nummer oder eine verifizierte Nummer als Anrufer-ID. Eine zweite Bird-Nummer brauchen Sie dafür nicht.
  3. Öffnen Sie jedes Leg. Inbound route zeigt, wie die Nummer konfiguriert war. Ein abgelehnter Anruf zeigt seinen Grund und, wenn sich das Problem über eine Ihrer Einstellungen beheben lässt, einen Link zu dieser Einstellung. Ein erfolgreicher Anruf zeigt Answered. Notieren Sie die Leg ID, falls Sie den Support kontaktieren.

Wenn ein Anruf fehlt, abgelehnt wird oder Ihre Anlage nie erreicht, folgen Sie der Fehlerbehebung für Sprachanrufe, die vom Symptom ausgeht.

Nächste Schritte

SeiteInhalt
SIP-TrunksAlle Trunk-Einstellungen, Authentifizierung und Digest
Anrufe empfangenRufnummernrouten, Gateways, Gruppen und die Standardroute des Workspace
Anrufe tätigenWas Bird beim INVITE erwartet
Fehlerbehebung bei VoiceEinen Anruf anhand seines Symptoms diagnostizieren

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