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 zeigt, wie die Nummer eingestellt war. Siehe Abgelehnte Anrufe.

Ein Anruf, der die maximale Anrufdauer der Plattform von 4 Stunden erreicht hat, hat den Status Answered, weil er verbunden war und dann am Zeitlimit endete. Seine abrechenbare Zeit läuft von der Annahme bis zu dem Moment, in dem Bird aufgelegt hat. Wenn der Anruf eine Sequenz durchlaufen hat, zeigt seine Zeitleiste Time limit reached als Ende des Legs.

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 mit 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. Keiner der beiden wird bisher ausgegeben, und beide Ergebnisse werden 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 eingestellt ist, oder an eine Nummer ohne eigene Route, während die Workspace-Standardroute auf Ablehnung steht, wird ohne jeglichen Grund abgelehnt: Er ist an keiner unserer Prüfungen gescheitert. Inbound route zeigt das an. Anrufe empfangen geht diese Ablehnungen im Detail 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. Die SIP response enthält den Code 503, den Ihre Telefonanlage empfangen hat. Beheben Sie das im Grund genannte Konto- oder Routingproblem. Bei einem ausgehenden Anruf enthält diese 503 einen X-BIRD-CALL-ID-Header mit der Leg ID des Datensatzes. So können Sie die Ablehnung ihrem Datensatz zuordnen, ohne Zeiten und Nummern abzugleichen.
• 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 seitenübergreifend die Datensätze, die Ihren aktuellen Filtern entsprechen, bis zu 10.000 Legs. Bei einer größeren Auswahl erhalten Sie einen Fehler und keine Datei. Grenzen Sie den Datumsbereich oder die Filter ein und exportieren Sie jede Auswahl separat. Die Datei enthält Dauer und abrechenbare Zeit, aber keine Kostenspalte. Prüfen Sie die Gebühren unter Nutzung, Ausgaben und Rechnungen.
• Über die API auslesen. Mit GET /v1/voice/legs und GET /v1/voice/legs/{leg_id} lesen Sie einzelne Legs aus. GET /v1/voice/calls und GET /v1/voice/calls/{call_id} liefern die gruppierten Anrufdaten, die das Dashboard und die CLI abrufen. Alle erfordern einen API-Schlüssel mit dem Scope voice auf der Berechtigungsstufe read. Die API-Referenz enthält die veröffentlichten Operationen für andere Voice-Ressourcen und deren erforderliche Scopes.
• Im Terminal auslesen. Die Bird CLI bietet bird voice calls list, bird voice calls get, bird voice legs list, bird voice legs get und bird voice stats. Der MCP-Server stellt Agenten dieselben Lesezugriffe bereit.
• 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