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 op elk moment één ingestelde actie voor inkomende oproepen: de oproep afleveren bij een van je SIP-trunks, doorsturen naar een geverifieerd nummer, een gepubliceerde sequence uitvoeren of weigeren. Elk nieuw nummer weigert standaard oproepen, dus een nummer dat niemand heeft ingesteld wijst bellers af.
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 sta bellers toe op de trunk: een IP-bereik of een API-sleutel voor je eigen apparatuur, sessiecredentials voor een browser of de CLI.
- Kies een geschikt beller-ID: gebruik een nummer dat je werkruimte bezit via Bird, of registreer een extern nummer en bevestig het met een verificatieoproep.
- Schakel je bestemmingen in: zet de landen aan 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, caller IDs en sequenties 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
| Pagina | Waarvoor |
|---|---|
| Metrics | Oproepvolume en beantwoordingspercentage in de tijd, oproepuitkomsten, toplanden, en de verdeling inkomend/uitgaand. Zie Voice-metrics |
| Legs | Leg-records per werkruimtegesprek, met verbruikstotalen voor de maand |
| Calls | Gerelateerde legs en deelnemers gegroepeerd in één gesprek |
| Numbers | Elk nummer dat de werkruimte kan gebruiken voor voice, en wat elk nummer doet met een inkomende oproep |
| SIP Trunks | Je trunks, hun SIP-domein, wie er verkeer naartoe mag sturen, en waar inkomende oproepen worden afgeleverd |
| Destinations | De landen waarnaar je werkruimte mag bellen, standaard uitgeschakeld |
| Sequences | Oproepworkflows bouwen, vooraf bekijken, publiceren en hun uitvoeringen inspecteren |
| Phone | Een zwevende telefoon die vanuit de browser belt, via een van je trunks |
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. Status, beide nummers, de trunk waarover de leg binnenkwam, het SIP-antwoord waarmee de leg eindigde, de tijdstippen van beantwoorden en beëindigen, factureerbare tijd en kosten. Filter de records en exporteer het resultaat als CSV.
- Voice-events: voice_call.initiated, voice_call.answered en voice_call.ended afgeleverd op je eigen endpoint, zodat je systemen over een oproep leren 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
Drie plafonds gelden voor je oproepen, in beide richtingen: hoeveel je er tegelijk actief mag hebben, hoeveel nieuwe oproepen per seconde, en hoeveel je aan voice mag besteden op een UTC-dag. Elk plafond wordt per organisatie ingesteld en de bedragen hangen af van je plan. Een oproep boven een van deze plafonds wordt bij het opzetten geweigerd, en het record vermeldt welk plafond, onder Geweigerde oproepen.
Het plafond per seconde is het voice_call-beleid in Limieten, dat ook uitlegt hoe je effectieve limiet wordt bepaald en hoe je meer capaciteit aanvraagt.
Volgende stappen
| Pagina | Wat het behandelt |
|---|---|
| Plaats je eerste oproep | Van een lege werkruimte tot een rinkelende telefoon |
| Phone | Bellen vanuit het dashboard, wat het nodig heeft, en wat je kunt doen tijdens een oproep |
| SIP-trunks | Een trunk aanmaken, de verbindingsgegevens, en bepalen wie er mag sturen |
| Oproepen plaatsen | Wat Bird verwacht van de INVITE, en wat een oproep kost |
| Oproepen ontvangen | Een nummer aan een trunk of doorschakeling koppelen, en wat er wordt geregistreerd |
| Beller-ID's | Een nummer registreren en bewijzen dat het van jou is met een verificatieoproep |
| Voice-bestemmingen | De landen waarnaar je belt inschakelen, en wat hoog risico betekent |
| Leg-log | Leg-records bekijken, filteren en exporteren |
| Voice-events | De drie oproep-events en hun payloads |
| Probleemoplossing | Een oproep diagnosticeren die niet doorkomt, aan de hand van het symptoom |
| Webhooks & events | Endpoint-instelling, handtekeningverificatie, opnieuw proberen en replay |
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.