Oproeplogboek

Het leg-logboek onder Voice > Legs toont elke verbinding die je werkruimte heeft geplaatst of ontvangen, nieuwste eerst. Een gesprek kan meerdere legs bevatten, zoals de inkomende en doorgeschakelde verbindingen. Elke vermelding is een gespreksdetailrecord (CDR), inclusief verbindingen die onbeantwoord bleven of werden geweigerd. Gebruik het om de duur, het uiteindelijke SIP-antwoord en de kosten te bekijken.

Bird schrijft elk record wanneer de leg eindigt, dus elk item in het logboek heeft een definitieve uitkomst. Het tabblad Live ernaast toont de legs die nog actief zijn.

Open Voice > Calls voor de volledige interactie. Een call groepeert gerelateerde legs en deelnemers. Gebruik het Call ID voor correlatie en het Leg ID wanneer je één verbinding onderzoekt; ze verwijzen naar verschillende records.

De oproeplijst

Elke rij is één leg. Een gesprek met meerdere legs heeft meerdere rijen:

De lijst is gepagineerd, 25 legs per pagina. Selecteer een rij om het leg-record te openen.

Live-oproepen

Het tabblad Live toont de legs die nu actief zijn, inclusief een teller zodat je kunt zien hoeveel er actief zijn zonder het tabblad te openen. Een live leg heeft een van twee statussen:

De kolommen komen overeen met het leg-logboek, behalve Elapsed, dat Duration vervangt. Het telt vanaf het antwoord voor een verbonden leg en vanaf het begin voor een rinkelende leg. Het tabblad ververst elke paar seconden. Wanneer een leg eindigt, verplaatst deze naar het leg-logboek met de definitieve uitkomst.

Zoeken en filteren

De pagina begint met een nummerzoekveld en filters. Ze combineren: een statusfilter plus een datumbereik beperkt de resultaten tot legs die aan beide voldoen.

Zoeken op nummer. Het zoekveld matcht een nummer aan beide kanten van de leg, dus één zoekopdracht vindt zowel de legs ernaar als de legs ervan.

Direction. Filter op outbound of inbound legs.

Status. Filter op answered, no answer, failed, rejected of unknown. Elk is gedefinieerd in Statussen. Op het tabblad Live zijn de keuzes ringing en in progress.

Date. Kies in het oproeplogboek een voorinstelling (de laatste 24 uur, 7 dagen of 30 dagen) of kies een aangepast bereik op de kalender.

Gebruik deze maand

De maandelijkse samenvatting bevat drie tegels voor de lopende kalendermaand in UTC:

Het verschil tussen totale duur en factureerbare tijd is onbeantwoorde beltijd. Een onbeantwoorde leg heeft geen factureerbare tijd.

Elk bestemmingstarief rondt de factureerbare tijd af op het factureringsinterval. Zie Kosten en facturering voor prijsdetails.

Deze tegels dekken de hele maand, ongeacht waarop je de lijst filtert.

Statussen

Een leg in het logboek is geëindigd met een van deze uitkomsten:

Rejected dekt twee soorten weigeringen, en de weigeringsreden onderscheidt ze. Ofwel Bird weigerde de oproep voordat er een carrier bij betrokken was, en dan noemt de reden de controle die mislukte, ofwel de andere kant wees de oproep direct af, en dan bevat SIP response het antwoord en is er geen reden. Een inkomende oproep die het gebelde nummer afwees, is ook Rejected zonder reden, omdat er geen controle mislukte: de Inbound route vermeldt wat het nummer zou doen. Zie Geweigerde oproepen.

Failed is geen weigering. Het betekent dat de oproep werd geprobeerd en niet lukte: een bezet nummer is Failed met carrier-antwoord 486, en een niet-toegewezen nummer is Failed met 404.

Als je deze waarden vanuit je eigen tooling uitleest, vang dan de waarden op die je verwerkt en behandel elke andere als een status die je niet verwerkt in plaats van als een fout. De lijst bevat ook busy en canceled, gereserveerd voor inkomende oproepen op je eigen nummers. Geen van beide wordt nu al verstuurd, en beide uitkomsten worden op dit moment gerapporteerd als failed.

Een oproep inspecteren

Als je een leg opent, zie je wat Bird over die verbinding heeft vastgelegd:

Inbound route verschijnt bij inkomende oproepen en vermeldt de geselecteerde route. Een trunk-route bij een geweigerde oproep betekent dat de oproep geen werkend antwoord bereikte. Oproepen ontvangen legt de routes uit en wat elk vastlegt.

Geweigerde oproepen

Een geweigerde oproep werd niet doorgelaten, en twee verschillende situaties veroorzaken dat.

Bird weigerde de oproep voordat er een carrier bij betrokken was. Voordat er wordt uitgebeld, controleert Bird de caller-ID, bestemming, accountlimieten en walletsaldo, en weigert een oproep die op een ervan faalt. Je telefoonsysteem ontvangt SIP 503, terwijl het geauthenticeerde oproeprecord de specifieke reden opslaat. Dit voorkomt dat niet-geauthenticeerde bellers accountdetails te weten komen. Open de oproep om de oorzaak en een link naar de relevante instelling te bekijken.

Het gebelde nummer wees de oproep af. Een inkomende oproep naar een nummer dat op weigeren staat, of naar een nummer waar niemand iets aan heeft gekoppeld, wordt geweigerd zonder reden: er is geen controle van ons mislukt. Inbound route vertelt je dat. Oproepen ontvangen behandelt die weigeringen.

De redenen hieronder zijn van het eerste type. Ze gelden voor inkomende en uitgaande oproepen, omdat de accountlimieten en de wallet in beide gevallen worden gecontroleerd.

Redenen die je zelf kunt oplossen

Een campagnedialer kan calls_per_second_exceeded raken terwijl hij lang niet aan het plafond voor gelijktijdige oproepen zit. Controleer dus welke van de twee je kreeg voordat je iets wijzigt.

Redenen die Bird voor je oplost

Deze zitten aan de kant van Bird. Neem contact op met support en vermeld het Leg ID uit het record:

Hoe een weigering eruitziet

Lees de status en de weigeringsreden samen:

• Rejected met een weigeringsreden. Bird weigerde de oproep en de reden noemt de mislukte controle. De SIP response is de 503 die je telefoonsysteem ontving. Volg de account- of routeringsoplossing bij de reden.
• Rejected zonder weigeringsreden. Bij een uitgaande oproep wees de andere kant de oproep direct af en SIP response bevat de code. Bij een inkomende oproep wees het gebelde nummer de oproep af en Inbound route vermeldt wat dat nummer zou doen.
• Failed. De oproep werd geprobeerd en lukte niet, en SIP response bevat de code die terugkwam. Een 486 betekent bezet, terwijl 404 betekent dat het nummer niet is toegewezen. Dit wijst meestal op het nummer en niet op je configuratie.

Een oproep die Bird helemaal niet kan toelaten, wordt afgewezen voordat er een record bestaat en verschijnt dus nooit in het logboek. Spraakprobleemoplossing behandelt die oproepen.

De records exporteren

Vier manieren om met deze records buiten het dashboard te werken:

• CSV exporteren. Download CSV op het tabblad Leg log exporteert de records die overeenkomen met je huidige filters over alle pagina's, tot maximaal 10.000 legs. Een grotere selectie levert een fout op zonder bestand; beperk je datumbereik of filters en exporteer elke selectie apart. Gebruik het voor reconciliatie en ad-hocrapportages.
• Uitlezen via de API. GET /v1/voice/legs retourneert de gefilterde lijst en GET /v1/voice/legs/{leg_id} retourneert één record. Beide vereisen een API-sleutel met het voice-bereik op read-niveau. Raadpleeg de API-referentie voor de gepubliceerde bewerkingen voor andere Voice-resources en hun vereiste bereiken.
• Uitlezen vanuit de terminal. De Bird CLI biedt bird voice legs list, bird voice legs get en bird voice stats. De MCP-server stelt dezelfde uitleesmogelijkheden beschikbaar voor agents.
• Abonneren op de events. voice_call.initiated, voice_call.answered en voice_call.ended worden naar je endpoint gepusht zodra oproepen plaatsvinden, zodat je eigen systemen actueel blijven zonder te pollen. Zie Spraakevents.

Volgende stappen