Voice-overzicht

Met Bird Voice bel je telefoonnummers en beantwoord je oproepen naar nummers die je bezit. Verbind een telefoonsysteem via SIP, bel vanuit de browser of gebruik de sequentiebouwer om een opgeslagen gespreksflow uit te voeren. Bird verbindt gesprekken met het openbare telefoonnetwerk, het PSTN.

De verbinding tussen je telefoonsysteem en Bird is een SIP-trunk. SIP (Session Initiation Protocol) zet oproepen op tussen telefoonsystemen. Bird geeft je werkruimte een trunk-adres, dat je telefoonsysteem gebruikt voor uitgaande oproepen naar het telefoonnetwerk, en dat Bird in omgekeerde richting gebruikt om oproepen op je nummers af te leveren.

Je hebt geen telefoonsysteem nodig om de eerste oproep te doen: de telefoon in het dashboard belt rechtstreeks vanuit de browser, via een van je trunks.

Je kunt ook een sequence bouwen in het dashboard en deze starten met de Create Call-API. De sequence verwerkt prompts, toetsenkeuzes en oproeproutering nadat de ontvanger opneemt.

Hoe een oproep wordt geplaatst

Je telefoonsysteem stuurt een SIP INVITE naar het trunk-adres om een gesprek te starten. Bird controleert het beller-ID, het bestemmingsland, de limieten en het walletsaldo voordat er contact met een carrier wordt opgenomen. Als het gesprek slaagt, routeert Bird het en stuurt de audio door. Elke verbinding is een leg. Wanneer een leg eindigt, schrijft Bird het record weg onder Voice > Legs en verstuurt een voice_call.ended event.

Een gesprek dat een controle niet doorstaat, wordt geweigerd voordat er een carrier bij betrokken is, en de specifieke reden wordt op het leg-record vermeld. Gesprekken plaatsen beschrijft wat Bird bij elk gesprek uitleest, en Geweigerde gesprekken somt elke weigeringsreden op en wat je eraan kunt doen.

Hoe een inkomende oproep wordt beantwoord

Een nummer in je werkruimte heeft steeds één antwoord, ingesteld op het nummer zelf of, als het nummer er geen heeft, overgenomen van de standaardroute van je werkruimte: lever de oproep af bij een van je SIP-trunks, schakel hem door naar een nummer dat je hebt geverifieerd, voer een gepubliceerde sequence uit, laat een belgroep overgaan van mensen die online zijn in de browsertelefoon, of wijs de oproep af. De standaardroute staat in eerste instantie op afwijzen, dus een nummer dat niemand heeft geconfigureerd weigert bellers.

Wanneer een oproep binnenkomt, controleert Bird de accountlimieten en de wallet op dezelfde manier als bij een oproep die je plaatst, handelt vervolgens naar het antwoord van het nummer en registreert dat antwoord op de oproep. Oproepen ontvangen beschrijft hoe je een nummer aan een antwoord koppelt, wat een doorschakeling toont aan degene die opneemt, en hoe je een weigering leest.

Voor je eerste oproep

Bereid het volgende voor bij oproepen via je eigen SIP-apparatuur. Voor API-oproepen gelden de Create Call-vereisten.

• Maak een SIP-trunk aan, schakel uitgaand bellen in en bepaal wie via de trunk mag bellen: gebruik een IP-bereik of een API-sleutel voor je eigen apparatuur en sessiegegevens voor een browser of de CLI.
• Kies een toegestaan beller-ID: gebruik een nummer dat je werkruimte via Bird heeft, of registreer een extern nummer en bevestig het met een verificatieoproep.
• Schakel je bestemmingen in: schakel de landen in waarnaar je belt.

Plaats je eerste oproep doorloopt alle drie de vereisten en eindigt met een echte oproep.

Het lezen van gespreksrecords vereist voice:read; het plaatsen van gesprekken vereist voice:write. Het beheren van trunks, nummerroutes, beller-ID's en sequences gebruikt voice_management-rechten. Toegang tot een pagina geeft geen recht om de instellingen te wijzigen of een factureerbaar gesprek te plaatsen.

De Voice-app in het dashboard

Zichtbaarheid

Een gesprek kan meerdere legs bevatten. Het logboek bevat één record per leg, ongeacht of de verbinding tot stand kwam, onbeantwoord bleef of werd geweigerd. Doorgeschakelde gesprekken of gesprekken met meerdere deelnemers kunnen daarom meerdere vermeldingen hebben:

• Leg-logboek: de weergave per leg op de pagina Legs. Hier zie je de status, beide nummers, de trunk waarop de leg binnenkwam, het SIP-antwoord waarmee deze eindigde, de tijdstippen van beantwoorden en beëindigen, de factureerbare tijd en de kosten. Filter het logboek en exporteer de overeenkomende records als CSV. De CSV bevat gespreksduren en factureerbare tijd, maar geen kostenkolom; bekijk de kosten in Gebruik, uitgaven en facturen.
• Voice-events: voice_call.initiated, voice_call.answered en voice_call.ended afgeleverd op je eigen endpoint, zodat je systemen van een oproep op de hoogte zijn zonder te pollen.

De API-referentie vermeldt de ondersteunde openbare HTTP-contracten en SDK-methoden. De CLI-referentie en MCP-toolreferentie beschrijven hun gepubliceerde bewerkingen. Deze interfaces kunnen verschillende bewerkingen aanbieden; een dashboardactie of CLI-opdracht betekent op zichzelf niet dat er een openbare SDK-methode bestaat.

Limieten

Voor je oproepen gelden in beide richtingen drie limieten: hoeveel oproepen tegelijk actief mogen zijn, hoeveel nieuwe oproepen per seconde je mag starten en hoeveel je per UTC-dag aan voice mag uitgeven. Je Voice-abonnement bepaalt de limieten voor gelijktijdige oproepen en oproepen per seconde voor je organisatie. Bij betalen naar gebruik gelden de standaardwaarden; hogere Voice-abonnementen verhogen deze limieten. De dagelijkse uitgavenlimiet werkt anders. Elke werkruimte stelt een eigen limiet in onder Voice > Spend limit, en per land onder Voice > Destinations, tot het maximum van je organisatie. De grootste Voice-abonnementen verhogen dat maximum. Een oproep die een van deze limieten overschrijdt, wordt bij het opzetten geweigerd. Het bijbehorende record vermeldt welke limiet is overschreden, onder Geweigerde oproepen. De waarden per abonnement staan op de Voice-prijspagina; upgrade onder Billing and payments > Overview.

De maximale oproepduur op het platform is 4 uur. Bird verbreekt beide kanten van een oproep die zo lang duurt, dus verdeel een langere sessie over meerdere oproepen. Bij een oproep die een oproepsequence uitvoert, begint de tijd te lopen zodra Bird de oproep accepteert of ontvangt. De wachttijd vóór het kiezen en de tijd dat de telefoon overgaat, tellen dus mee voor de 4 uur. Statussen beschrijft hoe zo'n oproep in het logboek verschijnt.

Het plafond per seconde is het voice_call-beleid in Limieten, dat ook uitlegt hoe je effectieve limiet wordt bepaald en hoe je die verhoogt.

Volgende stappen