Anrufe tätigen

Ihre Telefonanlage sendet ein SIP INVITE an die SIP-Domain des Trunks, um einen Anruf zu tätigen. Bird prüft die Anfrage, leitet sie an einen Carrier weiter und überträgt das Audio. Diese Seite behandelt die Voraussetzungen, Anfragefelder, Authentifizierung und Kosten.

Bevor Sie einen Anruf tätigen

Vier Dinge müssen bereit sein, in beliebiger Reihenfolge, und drei davon richten Sie selbst ein:

Ein Trunk, der Ihren Traffic annimmt. Erstellen Sie einen SIP-Trunk und aktivieren Sie ausgehende Anrufe. Fügen Sie die IP-Bereiche Ihrer Geräte, einen erlaubten API-Schlüssel oder beides hinzu. Clients, die kein langlebiges Geheimnis speichern können, verwenden ein Session-Credential.
Eine verifizierte Anrufer-ID. Registrieren Sie die Nummer, die Sie präsentieren, und schließen Sie den Verifizierungsanruf ab – so weist ein Workspace nach, dass er die präsentierten Nummern besitzt. Die Verifizierung garantiert weder die durchgehende Zustellung der CLI noch den Verbindungsaufbau des Anrufs, wenn die CLI keine über Bird beschaffte Nummer ist: siehe den Haftungsausschluss zur CLI-Verifizierung und -Zustellung.
Das Zielland aktiviert. Schalten Sie die Länder, die Sie bedienen, auf der Seite Destinations ein.
Routing an Ihren Workspace angebunden. Bird richtet dies für Sie ein und legt fest, welche Carrier welche Ziele bedienen. Solange das Routing nicht eingerichtet ist, werden Anrufe mit routing_not_configured abgewiesen – einer der Gründe, die unter Abgelehnte Anrufe beschrieben sind.

Was Bird im INVITE erwartet

Senden Sie die Anfrage an die SIP-Domain Ihres Trunks auf einem der unterstützten Ports. Zwei Header enthalten alles, was Bird benötigt:

Header	Was Bird damit macht
To	Die angerufene Nummer. Bird liest das Land daraus, um einen Carrier zu wählen und den Anruf zu bepreisen
From	Die Nummer, die Sie als Anrufer präsentieren. Sie muss eine verifizierte Anrufer-ID in diesem Workspace sein

Verwenden Sie vollständige internationale Nummern im E.164-Format – ein führendes + gefolgt von Ländervorwahl und nationaler Nummer – in beiden Headern. Das ist das Format, das Bird im Anrufdatensatz speichert und für den Zielabgleich erwartet.

Abgesehen von diesen beiden Headern ist dies ein gewöhnlicher SIP-Anruf, ohne zusätzliche Header in irgendeiner Richtung.

Authentifizierung jedes Anrufs

Was ein Anruf durchläuft, hängt davon ab, wie der Trunk geöffnet ist:

Nur IP-Allowlist. Eine Anfrage. Bird gleicht die Quelladresse mit der Liste ab und leitet den Anruf weiter, ohne eine Challenge zu senden.
Nur erlaubte API-Schlüssel. Bird fordert den Anruf zuerst zur Authentifizierung auf, über den SIP-Digest-Austausch.
Beides. Die Quelladresse wird geprüft, bevor Bird überhaupt eine Challenge sendet. Ein Anruf von einer nicht gelisteten Adresse wird abgewiesen, egal welche Credentials er mitbringt.
Session-Credentials aktiv. Bird fordert den Anruf unabhängig von der Herkunft zur Authentifizierung auf, auch von einer Adresse, die die Allowlist nicht abdeckt, und ein wenige Minuten zuvor ausgestelltes Credential antwortet. Geräte, die bereits über die Allowlist auf einem Trunk ohne erlaubte Schlüssel zugelassen sind, verbinden sich weiterhin ohne Challenge.

Wenn der Trunk erlaubte API-Schlüssel hat, antwortet Ihre Telefonanlage mit einem Hash des API-Schlüsselgeheimnisses anstelle des Geheimnisses selbst – genau das leistet die SIP-Digest-Authentifizierung:

Ihre Telefonanlage sendet das INVITE.
Bird antwortet mit 407 Proxy Authentication Required und einer Challenge-Zeile pro Algorithmus, den der Trunk anbietet, standardmäßig SHA-256 und dann MD5.
Ihre Telefonanlage sendet das INVITE erneut mit einem Proxy-Authorization-Header, berechnet mit dem Benutzernamen bird und dem Geheimnis des API-Schlüssels als Passwort.
Bird verifiziert die Antwort und setzt das Routing fort.

Ein präemptiver Proxy-Authorization-Header wird vor der Challenge gesendet, daher muss Ihr Gerät einen Algorithmus wählen, den der Trunk anbietet. Wenn der Trunk auch eine IP-Allowlist hat, muss die Anfrage trotzdem von einer gelisteten Adresse kommen.

Bird beantwortet einen fehlgeschlagenen Handshake auf der SIP-Ebene, sodass der Versuch abgewiesen wird, bevor die Plattform einen Anrufdatensatz erstellt. Wenn Ihre Anrufe im Anrufprotokoll vollständig fehlen, prüfen Sie die Credentials statt das Routing.

Anruf-Attestierung

Anrufe in die Vereinigten Staaten und nach Frankreich tragen eine STIR/SHAKEN-Attestierung. Carrier verwenden diese Signatur bei der Kennzeichnung von Anrufen. Bird wendet standardmäßig Level B ohne zusätzliche Konfiguration an. Kontaktieren Sie den Support, um Level A anzufordern.

Wenn ein Anruf abgewiesen wird

Bird prüft die Anrufer-ID, das Ziel, die Limits und das Wallet-Guthaben, bevor ein Carrier angewählt wird. Eine Ablehnung erreicht Ihre Telefonanlage als SIP 503; die genaue Ursache steht im authentifizierten Anrufdatensatz. Öffnen Sie den Anruf im Anrufprotokoll, oder sehen Sie unter Abgelehnte Anrufe Grund und Lösung für jeden Fall.

Beheben Sie die aufgezeichnete Ursache, bevor Sie es erneut versuchen. Beispielsweise setzt sich calls_per_second_exceeded fort, bis Sie die Wählrate drosseln.

Notrufe werden nicht übertragen

Bird Voice überträgt keine Anrufe an Notdienste. Ein Anruf an 112, 911, 999 oder eine andere Notrufnummer wird abgewiesen, auf jedem Trunk, in jedem Land. Ihre Telefonanlage muss Notdienste über einen anderen Weg erreichen.

Dieses Verhalten hängt nicht von Ihrem Tarif, Guthaben oder Ihren Zielen ab. Konfigurieren Sie Ihre Telefonanlage so, dass Notrufe über einen Dienst geleitet werden, der sie unterstützt, etwa einen lokalen PSTN-Anschluss, ein Vor-Ort-Gateway oder einen anderen Anbieter. Testen Sie diese Route. Bird gibt 503 für einen abgewiesenen Notruf zurück, sodass eine Telefonanlage mit einer alternativen Wählplan-Route diese nutzen kann.

Notdienste hängen vom registrierten Standort des Anrufers ab, den Bird für einen Trunk nicht speichert. Verlassen Sie sich nicht auf eine Bird-Route für Notrufe.

Kosten und Abrechnung

Voice wird aus dem Wallet Ihrer Organisation vorausbezahlt, wie bei den anderen Kanälen:

Die abrechenbare Zeit läuft von der Annahme bis zum Ende, unabhängig davon, wie lange der Anruf zuvor geklingelt hat. Der Anrufdatensatz zeigt sie neben der Gesamtdauer, die ab dem Moment läuft, in dem Bird den Anruf empfangen hat.
Der Tarif hängt vom Zielland ab. Ihre Tarifkarte bepreist jedes Land in der Währung des Wallets. Ein Tarif definiert eine abgerechnete Mindestzeit und das danach verwendete Inkrement. Beispiel: Ein Tarif mit einer Minute Minimum und Sechs-Sekunden-Inkrementen berechnet einen 10-Sekunden-Anruf als eine Minute.
Das Wallet wird geprüft, bevor der Carrier angewählt wird. Ein Anruf, den Ihr Guthaben nicht deckt, wird vorab mit insufficient_balance abgewiesen, statt Ihnen nachträglich berechnet zu werden. Halten Sie einen Puffer vor, oder aktivieren Sie automatische Aufladungen.
Ein tägliches Voice-Ausgabenlimit gilt. Darüber hinaus werden Anrufe mit daily_spend_exceeded abgewiesen, bis der nächste UTC-Tag beginnt. Die Höhe hängt von Ihrem Tarif ab.
Die Kosten erscheinen am Anruf, sobald er bewertet wurde, in voller Präzision, netto ohne Steuer.

Um die Ausgaben über mehrere Anrufe zu summieren, exportieren Sie die gefilterte Anrufliste als CSV von der Seite Calls, oder lesen Sie Ihre Rechnungen und Nutzungsdaten.

Nächste Schritte

Seite	Was sie behandelt
Anrufprotokoll	Durchsuchen, Filtern und Exportieren Ihrer Anrufdatensätze
Voice-Events	Anrufergebnisse an Ihre eigenen Systeme pushen lassen
Zahlungsmethoden & Wallet	Aufladen, automatische Aufladungen und wie das Wallet belastet wird

Verwandte Ressourcen