Oproeplogboek
Het oproeplogboek onder Voice > Calls toont elke oproep die je werkruimte heeft geplaatst en elke oproep die op een van zijn nummers binnenkwam, nieuwste eerst. Elke vermelding is een gespreksdetailrecord (CDR), inclusief oproepen die verbonden werden, onbeantwoord bleven of werden geweigerd. Gebruik het om de duur, het definitieve SIP-antwoord en de kosten te bekijken.
Bird schrijft elk record wanneer de oproep eindigt, dus elke oproep in het logboek heeft een definitieve uitkomst. Het tabblad Live ernaast toont de oproepen die nog actief zijn.
De oproeplijst
Elke rij is één oproep:
| Kolom | Wat het toont |
|---|---|
| Status | Hoe de oproep is beëindigd (zie Statussen) |
| From | Het bellende nummer, de caller ID die je apparatuur presenteerde |
| To | Het nummer dat werd gebeld |
| Direction | Outbound voor oproepen die je apparatuur plaatste, inbound voor oproepen die op je nummers binnenkwamen |
| Duration | Totale duur van de oproep, vanaf het moment dat Bird de oproep ontving tot het ophangen |
| Started | Wanneer Bird de oproep ontving |
De lijst is gepagineerd, 25 oproepen per pagina. Selecteer een rij om de oproep te openen.
Live-oproepen
Het tabblad Live toont de oproepen die nu actief zijn en bevat een teller zodat je kunt zien hoeveel er actief zijn zonder het te openen. Een live-oproep heeft een van twee statussen:
| Status | Wat er gebeurt |
|---|---|
| Ringing | De oproep heeft de bestemming bereikt, die nog niet heeft opgenomen |
| In progress | De bestemming heeft opgenomen en de oproep is verbonden |
De kolommen komen overeen met het oproeplogboek, behalve Elapsed, dat Duration vervangt. Het telt vanaf het opnemen voor een verbonden oproep en vanaf het begin voor een rinkelende oproep. Het tabblad ververst elke paar seconden. Wanneer een oproep eindigt, verhuist deze naar het oproeplogboek met de definitieve uitkomst.
Zoeken en filteren
De pagina begint met een nummerzoekveld en de filters. Ze combineren: een statusfilter plus een datumbereik beperkt tot de oproepen die aan beide voldoen.
Zoeken op nummer. Het zoekveld vergelijkt een nummer met beide kanten van de oproep, zodat één zoekopdracht de oproepen ernaar en de oproepen ervan vindt.
Direction. Filter op uitgaande of inkomende oproepen.
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:
| Tegel | Wat het telt |
|---|---|
| Calls | Voltooide oproeprecords in de maand, inclusief onbeantwoorde en geweigerde |
| Total duration | De volledige duur van elke oproep bij elkaar opgeteld, vanaf het moment dat Bird de oproep ontving tot het ophangen |
| Billable time | De beantwoorde tijd van elke oproep bij elkaar opgeteld |
Het verschil tussen totale duur en factureerbare tijd is onbeantwoorde beltijd. Een onbeantwoorde oproep 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 oproep in het logboek is beëindigd met een van deze uitkomsten:
| Status | Wat er is gebeurd |
|---|---|
| Answered | De bestemming heeft opgenomen. Factureerbare tijd loopt van opnemen tot ophangen |
| No answer | De oproep rinkelde bij de bestemming en werd niet opgenomen voordat de tijd verstreek |
| Rejected | De oproep werd geweigerd in plaats van doorverbonden |
| Failed | De oproep werd geprobeerd maar lukte niet, en SIP response is wat terugkwam |
| Unknown | De uitkomst kon niet worden vastgesteld, bijvoorbeeld wanneer er nooit een definitief antwoord binnenkwam |
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
Een oproep openen toont wat Bird erover heeft vastgelegd:
| Veld | Wat het je vertelt |
|---|---|
| Status | De uitkomst van de oproep (zie Statussen). Een oproep die Bird weigerde, toont ook de reden en wat je eraan kunt doen |
| SIP response | De definitieve SIP-code van de oproep, bijvoorbeeld 200 of 486. Een oproep die Bird weigerde, bevat 503, zonder carrier erbij |
| From / To | Beide nummers, elk kopieerbaar |
| Inbound route | Bij een inkomende oproep, wat het gebelde nummer zou doen: afleveren aan een trunk, doorschakelen of weigeren. Linkt naar dat nummer |
| Trunk | De SIP-trunk waarop de oproep binnenkwam of werd afgeleverd, handig als meerdere locaties een werkruimte delen |
| Started | Wanneer Bird de oproep ontving |
| Answered | Wanneer de oproep werd opgenomen, of Not answered |
| Ended | Wanneer de oproep werd afgebroken |
| Call ID | Het eigen id van het record (vcl_…). Vermeld dit bij support en gebruik het om te correleren met je eigen logs |
| Session ID | Gedeeld door elk been van één oproep (vcs_…), zodat gerelateerde records gegroepeerd kunnen worden. Een doorgeschakelde oproep heeft twee benen die er een delen |
| Billing | Factureerbare tijd, totale duur en de kosten van de oproep zodra deze is berekend |
Inbound route verschijnt alleen bij inkomende oproepen en vermeldt wat het nummer zou doen, niet of het gelukt is: een trunk-route bij een geweigerde oproep is een nummer dat naar een trunk wees die de oproep niet aannam. Oproepen ontvangen behandelt de drie antwoorden 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
| Reden | Wat er is gebeurd | Wat te doen |
|---|---|---|
| source_not_allowed | De oproep kwam binnen vanaf een adres dat niet op de IP-allowlist van de trunk staat | Voeg het adres toe waarvandaan je telefoonsysteem verstuurt aan de trunk |
| caller_id_not_verified | Het nummer in de From-header is geen geverifieerde caller ID voor deze werkruimte | Verifieer dat nummer, of presenteer er een dat al geverifieerd is |
| destination_not_enabled | Bellen naar dat land is uitgeschakeld voor je werkruimte | Zet het land aan onder Destinations |
| insufficient_balance | Je wallet dekte de oproep niet, dus Bird weigerde de oproep vooraf | Laad op, of schakel automatisch opwaarderen in zodat een laag saldo het bellen niet onderbreekt |
| daily_spend_exceeded | De oproep zou het dagelijkse bestedingsplafond voor spraak van je organisatie overschrijden | Wacht tot het plafond wordt gereset aan het begin van de volgende UTC-dag, of vraag Bird om het te verhogen |
| concurrent_calls_exceeded | Je hebt net zoveel gelijktijdige oproepen als je account toestaat | Wacht tot er een oproep eindigt, of neem contact op met support om het plafond te verhogen |
| calls_per_second_exceeded | Je plaatste nieuwe oproepen sneller dan je account toestaat | Verlaag je belsnelheid en probeer het opnieuw. Direct opnieuw proberen levert hetzelfde antwoord op |
| number_ownership_not_verified | Je hebt dit nummer gekocht, maar het land dat het heeft uitgegeven heeft de documentatie die je eigendom bewijst nog niet geaccepteerd | Voltooi wat het veld ownership van het nummer vraagt en plaats de oproep opnieuw |
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 liggen aan de kant van Bird. Neem contact op met support en vermeld het Call ID uit het record:
| Reden | Wat er is gebeurd |
|---|---|
| routing_not_configured | De routering van je werkruimte wordt nog gekoppeld, wat normaal is zolang een nieuwe spraakopstelling wordt afgerond |
| no_route_found | Routering is gekoppeld, maar dekt het nummer dat je belde niet. Neem contact op met support met het call ID om de route te controleren |
| destination_blocked | De routeringsconfiguratie van Bird blokkeert oproepen naar die bestemming |
| call_not_permitted | Bird kon de oproep niet voltooien voor je account en weigerde de oproep in plaats van deze op onbekende voorwaarden te plaatsen |
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 Call log exporteert elk record dat overeenkomt met je huidige filters over alle pagina's. Gebruik het voor reconciliatie en ad-hocrapportages.
- Uitlezen via de API. GET /v1/voice/calls geeft de gefilterde lijst terug en GET /v1/voice/calls/{call_id} geeft één record terug. Beide vereisen een API-key met de scope voice op read-niveau. Trunk-, caller-ID- en bestemmingsinstellingen maken geen deel uit van de publieke API.
- Uitlezen vanuit de terminal. De Bird CLI biedt bird voice list, bird voice 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
| Pagina | Wat het behandelt |
|---|---|
| Spraakevents | De drie oproepevents, hun payloads en hoe je ze verwerkt |
| Oproepen plaatsen | Wat Bird verwacht op de INVITE, en hoe een oproep wordt geprijsd |
| Oproepen ontvangen | Een nummer koppelen aan een trunk of een doorschakeling, en wat het vastlegt |
| SIP-trunks | De IP-allowlist, toegestane API-keys en Digest-instellingen |
| Spraakbestemmingen | Landen inschakelen, en wat beschikbaarheid betekent |
| Fouten | Het API-foutantwoord en de bijbehorende herstelvelden |
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.