Anrufprotokoll

Das Leg-Protokoll unter Voice > Legs listet jede Verbindung auf, die Ihr Workspace hergestellt oder empfangen hat, die neueste zuerst. Ein Anruf kann mehrere Legs enthalten, etwa die eingehende und die weitergeleitete Verbindung. Jeder Eintrag ist ein Call Detail Record (CDR), einschließlich Verbindungen, die nicht angenommen oder abgelehnt wurden. Nutzen Sie ihn, um Dauer, die endgültige SIP-Antwort und Kosten zu prüfen.

Bird schreibt jeden Datensatz, wenn das Leg endet, sodass jeder Eintrag im Protokoll ein endgültiges Ergebnis hat. Der Tab Live daneben zeigt die Legs, die noch aktiv sind.

Für die vollständige Interaktion öffnen Sie Voice > Calls. Ein Call fasst zusammengehörige Legs und Teilnehmer zusammen. Verwenden Sie die Call ID zur Korrelation und die Leg ID zur Untersuchung einer einzelnen Verbindung; sie identifizieren unterschiedliche Datensätze.

Die Anrufliste

Jede Zeile ist ein Leg. Ein Anruf mit mehreren Legs hat mehrere Zeilen:

Die Liste ist paginiert, 25 Legs pro Seite. Wählen Sie eine beliebige Zeile aus, um den Leg-Datensatz zu öffnen.

Live-Anrufe

Der Tab Live listet die gerade aktiven Legs auf und zeigt einen Zähler, damit Sie ohne Öffnen sehen, wie viele aktiv sind. Ein aktives Leg hat einen von zwei Status:

Die Spalten entsprechen dem Leg-Protokoll, außer Elapsed, das Duration ersetzt. Es zählt ab der Annahme bei einem verbundenen Leg und ab dem Start bei einem klingelnden Leg. Der Tab aktualisiert sich alle paar Sekunden. Wenn ein Leg endet, wechselt es mit seinem endgültigen Ergebnis ins Leg-Protokoll.

Suchen und Filtern

Die Seite beginnt mit einer Nummernsuche und Filtern. Sie lassen sich kombinieren: Ein Statusfilter zusammen mit einem Datumsbereich grenzt auf die Legs ein, die beides erfüllen.

Suche nach Nummer. Das Suchfeld gleicht eine Nummer mit beiden Seiten des Legs ab, sodass eine Abfrage sowohl die Legs dorthin als auch die Legs davon findet.

Richtung. Filtern Sie nach ausgehenden oder eingehenden Legs.

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:

Die Differenz zwischen Gesamtdauer und abrechenbarer Zeit ist unbeantwortete Klingelzeit. Ein unbeantwortetes Leg 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 Leg im Protokoll endete mit einem dieser Ergebnisse:

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 ein Leg öffnen, sehen Sie, was Bird zu dieser Verbindung aufgezeichnet hat:

Inbound route erscheint bei eingehenden Anrufen und zeigt die gewählte Route. Eine Trunk-Route bei einem abgelehnten Anruf bedeutet, dass der Anruf keine funktionierende Annahme erreicht hat. Anrufe empfangen erklärt die Routen 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

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 Seiten von Bird. Kontaktieren Sie den Support und nennen Sie die Leg ID aus dem Datensatz:

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 Leg log exportiert die Datensätze, die Ihren aktuellen Filtern entsprechen, über alle Seiten hinweg, bis zu 10.000 Legs. Eine größere Auswahl gibt einen Fehler ohne Datei zurück; schränken Sie Ihren Datumsbereich oder Ihre Filter ein und exportieren Sie jede Auswahl einzeln. Nutzen Sie es für den Abgleich und Ad-hoc-Berichte.
• Über die API abrufen. GET /v1/voice/legs gibt die gefilterte Liste zurück, und GET /v1/voice/legs/{leg_id} gibt einen einzelnen Datensatz zurück. Beide erfordern einen API-Schlüssel mit dem Scope voice auf read-Ebene. Die veröffentlichten Operationen für andere Voice-Ressourcen und deren erforderliche Scopes finden Sie in der API-Referenz.
• Vom Terminal aus abrufen. Die Bird CLI bietet bird voice legs list, bird voice legs get und bird voice stats. Der MCP-Server stellt Agenten 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