Anrufprotokoll

Das Anrufprotokoll unter Voice > Calls listet jeden Anruf auf, den Ihr Workspace getätigt hat, und jeden Anruf, der auf einer seiner Nummern eingegangen ist, neueste zuerst. Jeder Eintrag ist ein Anrufdetaildatensatz (CDR), einschließlich Anrufe, die verbunden wurden, ohne Antwort blieben oder abgelehnt wurden. Nutzen Sie ihn, um Dauer, die endgültige SIP-Antwort und Kosten zu prüfen.

Bird schreibt jeden Datensatz, wenn der Anruf endet, sodass jeder Anruf im Protokoll ein endgültiges Ergebnis hat. Der Tab Live daneben zeigt die Anrufe, die noch aktiv sind.

Die Anrufliste

Jede Zeile ist ein Anruf:

Spalte	Was sie zeigt
Status	Wie der Anruf endete (siehe Status)
From	Die anrufende Nummer, die Anrufer-ID, die Ihre Anlage übermittelt hat
To	Die angerufene Nummer
Direction	Outbound für Anrufe, die Ihre Anlage getätigt hat, Inbound für Anrufe, die auf Ihren Nummern eingegangen sind
Duration	Gesamtdauer des Anrufs, ab dem Moment, in dem Bird ihn empfangen hat, bis zum Auflegen
Started	Wann Bird den Anruf empfangen hat

Die Liste ist paginiert, 25 Anrufe pro Seite. Wählen Sie eine Zeile aus, um den Anruf zu öffnen.

Live-Anrufe

Der Tab Live listet die gerade aktiven Anrufe und zeigt einen Zähler, sodass Sie sehen können, wie viele aktiv sind, ohne den Tab zu öffnen. Ein Live-Anruf hat einen von zwei Status:

Status	Was passiert
Ringing	Der Anruf hat sein Ziel erreicht, das noch nicht abgenommen hat
In progress	Das Ziel hat abgenommen, und der Anruf ist verbunden

Die Spalten entsprechen dem Anrufprotokoll, mit Ausnahme von Elapsed, das Duration ersetzt. Es zählt ab der Annahme bei einem verbundenen Anruf und ab dem Start bei einem klingelnden Anruf. Der Tab aktualisiert sich alle paar Sekunden. Wenn ein Anruf endet, wandert er mit seinem endgültigen Ergebnis ins Anrufprotokoll.

Suchen und Filtern

Die Seite beginnt mit einer Nummernsuche und ihren Filtern. Sie lassen sich kombinieren: Ein Statusfilter plus ein Datumsbereich grenzt auf die Anrufe ein, die beiden entsprechen.

Suche nach Nummer. Das Suchfeld gleicht eine Nummer mit beiden Seiten des Anrufs ab, sodass eine Abfrage die Anrufe an diese Nummer und die Anrufe von dieser Nummer findet.

Direction. Filtern Sie nach ausgehenden oder eingehenden Anrufen.

Status. Filtern Sie nach Answered, No answer, Failed, Rejected oder Unknown. Jeder Wert ist unter Status definiert. Im Tab Live stehen Ringing und In progress zur Wahl.

Date. Wählen Sie im Anrufprotokoll eine Vorgabe (die letzten 24 Stunden, 7 Tage oder 30 Tage) oder legen Sie über den Kalender einen eigenen Bereich fest.

Nutzung in diesem Monat

Die Monatszusammenfassung enthält drei Kacheln für den aktuellen Kalendermonat in UTC:

Kachel	Was sie zählt
Calls	Abgeschlossene Anrufdatensätze im Monat, einschließlich unbeantworteter und abgelehnter
Total duration	Gesamtdauer aller Anrufe addiert, ab dem Moment, in dem Bird den Anruf empfangen hat, bis zum Auflegen
Billable time	Beantwortete Zeit aller Anrufe addiert

Die Differenz zwischen Gesamtdauer und abrechenbarer Zeit ist unbeantwortete Klingelzeit. Ein unbeantworteter Anruf hat keine abrechenbare Zeit.

Jeder Zieltarif rundet die abrechenbare Zeit auf sein Abrechnungsinkrement. Preisdetails finden Sie unter Kosten und Abrechnung.

Diese Kacheln decken den gesamten Monat ab, unabhängig davon, wie Sie die Liste filtern.

Status

Ein Anruf im Protokoll endete mit einem dieser Ergebnisse:

Status	Was passiert ist
Answered	Das Ziel hat abgenommen. Abrechenbare Zeit läuft von der Annahme bis zum Auflegen
No answer	Der Anruf klingelte am Ziel und wurde nicht angenommen, bevor die Zeit ablief
Rejected	Der Anruf wurde abgelehnt statt durchgestellt
Failed	Der Anruf wurde versucht und schlug fehl, und SIP response ist die zurückgegebene Antwort
Unknown	Das Ergebnis konnte nicht ermittelt werden, zum Beispiel wenn nie eine endgültige Antwort eintraf

Rejected umfasst zwei Ablehnungsarten, und der Ablehnungsgrund unterscheidet sie. Entweder hat Bird den Anruf abgelehnt, bevor ein Carrier beteiligt war – dann nennt der Grund die fehlgeschlagene Prüfung –, oder die Gegenseite hat ihn direkt abgewiesen – dann enthält SIP response deren Antwort, und es gibt keinen Grund. Ein eingehender Anruf, den die angerufene Nummer abgewiesen hat, ist ebenfalls Rejected ohne Grund, weil er keine Prüfung verfehlt hat: die Inbound route sagt, was die Nummer tun sollte. Siehe Abgelehnte Anrufe.

Failed ist keine Ablehnung. Es bedeutet, dass der Anruf versucht wurde und fehlschlug: Eine besetzte Nummer ist Failed mit Carrier-Antwort 486, und eine nicht vergebene Nummer ist Failed mit 404.

Wenn Sie diese Werte aus eigenen Tools auslesen, verarbeiten Sie die Ihnen bekannten und behandeln Sie jeden anderen als einen Status, den Sie nicht verarbeiten, statt als Fehler. Die Liste enthält auch busy und canceled, reserviert für eingehende Anrufe auf Ihren eigenen Nummern. Beide werden noch nicht ausgegeben, und beide Ergebnisse werden derzeit als failed gemeldet.

Einen Anruf untersuchen

Wenn Sie einen Anruf öffnen, sehen Sie, was Bird dazu aufgezeichnet hat:

Feld	Was es Ihnen sagt
Status	Das Ergebnis des Anrufs (siehe Status). Ein von Bird abgelehnter Anruf zeigt auch den Grund und was Sie dagegen tun können
SIP response	Der endgültige SIP-Code des Anrufs, zum Beispiel 200 oder 486. Ein von Bird abgelehnter Anruf trägt 503, ohne Carrier-Beteiligung
From / To	Beide Nummern, jeweils kopierbar
Inbound route	Bei einem eingehenden Anruf, was die angerufene Nummer tun sollte: an einen Trunk zustellen, weiterleiten oder ablehnen. Verlinkt auf diese Nummer
Trunk	Der SIP-Trunk, über den der Anruf einging oder zugestellt wurde, nützlich wenn mehrere Standorte einen Workspace teilen
Started	Wann Bird den Anruf empfangen hat
Answered	Wann der Anruf angenommen wurde, oder Not answered
Ended	Wann der Anruf abgebaut wurde
Call ID	Die eigene ID des Datensatzes (vcl_…). Geben Sie diese beim Support an und nutzen Sie sie zum Abgleich mit Ihren eigenen Logs
Session ID	Wird von jedem Abschnitt eines Anrufs geteilt (vcs_…), sodass zusammengehörige Datensätze gruppiert werden können. Ein weitergeleiteter Anruf hat zwei Abschnitte mit einer gemeinsamen Session ID
Billing	Abrechenbare Zeit, Gesamtdauer und die Kosten des Anrufs, sobald er bepreist wurde

Inbound route erscheint nur bei eingehenden Anrufen und sagt, was die Nummer tun sollte, nicht ob es funktioniert hat: Eine Trunk-Route bei einem abgelehnten Anruf ist eine Nummer, die auf einen Trunk zeigt, der den Anruf nicht angenommen hat. Anrufe empfangen beschreibt die drei Antworten und was jede aufzeichnet.

Abgelehnte Anrufe

Ein abgelehnter Anruf wurde abgewiesen statt durchgestellt, und zwei verschiedene Dinge verursachen das.

Bird hat ihn abgelehnt, bevor ein Carrier beteiligt war. Vor dem Wählen prüft Bird die Anrufer-ID, das Ziel, Kontolimits und das Guthaben und lehnt einen Anruf ab, der eine dieser Prüfungen nicht besteht. Ihre Telefonanlage empfängt SIP 503, während der authentifizierte Anrufdatensatz den spezifischen Grund speichert. Das verhindert, dass nicht authentifizierte Anrufer Kontodaten erfahren. Öffnen Sie den Anruf, um die Ursache und einen Link zur betreffenden Einstellung zu sehen.

Die angerufene Nummer hat den Anruf abgewiesen. Ein eingehender Anruf an eine Nummer, die auf Ablehnung gesetzt ist, oder an eine Nummer, die nirgendwohin zeigt, wird ohne Grund abgelehnt: Er hat keine unserer Prüfungen verfehlt. Inbound route sagt das aus. Anrufe empfangen geht diese Ablehnungen durch.

Die folgenden Gründe gehören zur ersten Art. Sie gelten für eingehende ebenso wie für ausgehende Anrufe, weil Kontolimits und Guthaben in beiden Fällen geprüft werden.

Gründe, die Sie beheben können

Grund	Was passiert ist	Was zu tun ist
source_not_allowed	Der Anruf kam von einer Adresse, die die IP-Zulassungsliste des Trunks nicht abdeckt	Fügen Sie die Adresse, von der Ihre Telefonanlage sendet, zum Trunk hinzu
caller_id_not_verified	Die Nummer im From-Header ist keine verifizierte Anrufer-ID für diesen Workspace	Verifizieren Sie diese Nummer, oder verwenden Sie eine bereits verifizierte
destination_not_enabled	Anrufe in dieses Land sind für Ihren Workspace deaktiviert	Aktivieren Sie das Land unter Destinations
insufficient_balance	Ihr Guthaben deckte den Anruf nicht, deshalb hat Bird ihn vorab abgelehnt	Laden Sie auf, oder aktivieren Sie automatische Aufladungen, damit ein niedriges Guthaben keine Anrufe unterbricht
daily_spend_exceeded	Der Anruf hätte das tägliche Voice-Ausgabenlimit Ihrer Organisation überschritten	Warten Sie, bis das Limit am Beginn des nächsten UTC-Tages zurückgesetzt wird, oder bitten Sie Bird, es anzuheben
concurrent_calls_exceeded	Sie haben so viele gleichzeitige Anrufe, wie Ihr Konto zulässt	Warten Sie, bis ein Anruf endet, oder kontaktieren Sie den Support, um das Limit anzuheben
calls_per_second_exceeded	Sie haben neue Anrufe schneller getätigt, als Ihr Konto zulässt	Reduzieren Sie Ihre Wählrate und versuchen Sie es erneut. Sofortiges erneutes Versuchen liefert dieselbe Antwort
number_ownership_not_verified	Sie haben diese Nummer erworben, aber das Land, das sie vergeben hat, hat die Nachweise noch nicht akzeptiert	Erledigen Sie, was das Feld ownership der Nummer verlangt, und tätigen Sie den Anruf erneut

Ein Kampagnen-Dialer kann calls_per_second_exceeded auslösen, obwohl er weit unter dem Limit für gleichzeitige Anrufe liegt. Prüfen Sie daher, welchen der beiden Gründe Sie erhalten haben, bevor Sie etwas ändern.

Gründe, die Bird für Sie löst

Diese liegen auf der Seite von Bird. Kontaktieren Sie den Support und geben Sie die Call ID aus dem Datensatz an:

Grund	Was passiert ist
routing_not_configured	Das Routing Ihres Workspace wird noch eingerichtet, was erwartet ist, solange ein neues Voice-Setup abgeschlossen wird
no_route_found	Routing ist eingerichtet, deckt aber die von Ihnen gewählte Nummer nicht ab. Kontaktieren Sie den Support mit der Call ID, um die Route zu prüfen
destination_blocked	Die Routing-Konfiguration von Bird blockiert Anrufe zu diesem Ziel
call_not_permitted	Bird konnte den Anruf für Ihr Konto nicht abschließen und hat ihn abgelehnt, statt ihn zu unbekannten Bedingungen zu tätigen

So liest sich eine Ablehnung

Lesen Sie den Status und den Ablehnungsgrund zusammen:

Rejected mit Ablehnungsgrund. Bird hat den Anruf abgelehnt, und der Grund nennt die fehlgeschlagene Prüfung. SIP response ist der 503, den Ihre Telefonanlage empfangen hat. Folgen Sie der Konto- oder Routing-Lösung des Grundes.
Rejected ohne Ablehnungsgrund. Bei einem ausgehenden Anruf hat die Gegenseite ihn direkt abgewiesen, und SIP response enthält deren Code. Bei einem eingehenden Anruf hat die angerufene Nummer ihn abgewiesen, und Inbound route sagt, was diese Nummer tun sollte.
Failed. Der Anruf wurde versucht und schlug fehl, und SIP response enthält den zurückgegebenen Code. 486 bedeutet besetzt, während 404 bedeutet, dass die Nummer nicht vergeben ist. Das deutet in der Regel auf die Nummer hin, nicht auf Ihr Setup.

Ein Anruf, den Bird gar nicht zulassen kann, wird abgewiesen, bevor ein Datensatz existiert, und erreicht daher nie das Protokoll. Voice-Fehlerbehebung behandelt diese Anrufe.

Datensätze exportieren

Vier Wege, um mit diesen Datensätzen außerhalb des Dashboards zu arbeiten:

CSV exportieren. Download CSV im Tab Call log exportiert jeden Datensatz, der Ihren aktuellen Filtern entspricht, über alle Seiten hinweg. Nutzen Sie es für Abgleich und Ad-hoc-Reporting.
Über die API abrufen. GET /v1/voice/calls gibt die gefilterte Liste zurück, und GET /v1/voice/calls/{call_id} gibt einen einzelnen Datensatz zurück. Beide erfordern einen API-Schlüssel mit dem Scope voice auf read-Ebene. Trunk-, Anrufer-ID- und Zieleinstellungen sind nicht Teil der öffentlichen API.
Vom Terminal aus abrufen. Die Bird CLI bietet bird voice list, bird voice get und bird voice stats. Der MCP-Server stellt Agents dieselben Lesezugriffe zur Verfügung.
Events abonnieren. voice_call.initiated, voice_call.answered und voice_call.ended werden an Ihren Endpunkt gepusht, sobald Anrufe stattfinden, sodass Ihre eigenen Systeme ohne Polling aktuell bleiben. Siehe Voice-Events.

Nächste Schritte

Seite	Was sie behandelt
Voice-Events	Die drei Anruf-Events, ihre Payloads und wie Sie sie nutzen
Anrufe tätigen	Was Bird auf dem INVITE erwartet und wie ein Anruf bepreist wird
Anrufe empfangen	Eine Nummer auf einen Trunk oder eine Weiterleitung zeigen, und was dabei aufgezeichnet wird
SIP-Trunks	Die IP-Zulassungsliste, erlaubte API-Schlüssel und Digest-Einstellungen
Voice-Ziele	Länder aktivieren und was Verfügbarkeit bedeutet
Errors	Die API-Fehlerantwort und ihre Recovery-Felder

Verwandte Ressourcen