# Oproepen ontvangen Een nummer dat je werkruimte bezit, kan een inkomende oproep op drie manieren beantwoorden: afleveren bij een van je SIP-trunks, doorsturen naar een nummer dat je hebt geverifieerd, of weigeren. Het antwoord is een instelling op het nummer, en een nummer heeft precies één antwoord tegelijk. Elk nummer begint op weigeren, dus een nummer dat niemand heeft geconfigureerd wijst bellers af in plaats van helemaal geen antwoord te hebben. ## Vereisten Voordat je een nummer aan een antwoord koppelt: - **Een nummer dat oproepen kan ontvangen.** Open **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers) en controleer de kolom **Directions** op een inbound-markering. Een nummer dat je als beller-ID van een andere provider hebt geregistreerd, ontvangt hier geen oproepen: die provider routeert de oproepen ernaartoe, dus het heeft geen antwoord. - **Voor aflevering bij een trunk:** een [SIP-trunk](/docs/guides/voice/sip-trunks) met inkomend bellen aan en minstens één aflevergateway. - **Voor doorsturen:** een [geverifieerd beller-ID](/docs/guides/voice/caller-ids) om naar door te sturen. - **Om de instelling via de API of CLI te wijzigen:** een API-sleutel met het `voice_management`-bereik op schrijfniveau. Dat bereik dekt spraakconfiguratie; het `voice`-bereik dekt oproepverkeer en statistieken, dus het oproeplogboek lezen vereist het andere bereik. ## Oproepen afleveren bij een SIP-trunk Aflevering belt je eigen telefoonsysteem op adressen die je op de trunk declareert. Zet de richting eerst aan, want een nummer kan alleen worden gekoppeld aan een trunk die al inkomende oproepen accepteert. 1. Open **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), open de trunk en selecteer onder **Inbound calling** de optie **Enable inbound**. 2. Voeg minstens één gateway toe in dezelfde sectie. Een trunk zonder gateway weigert elke inkomende oproep naar de nummers die hij beantwoordt. 3. Open **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), open het nummer en kies onder **Inbound routing** de optie **Deliver to a SIP trunk**. 4. Kies de trunk en selecteer **Save**. Alleen trunks met inkomend bellen aan verschijnen in de lijst. De kolom **Used for** in de **Numbers**-lijst toont het nummer vervolgens als afgeleverd bij die trunk, en de eigen pagina van de trunk vermeldt de nummers die hij beantwoordt. ### Wat een gateway nodig heeft Een gateway is één adres waarnaar een oproep wordt afgeleverd, en hoe die peer de twee nummers van de oproep weergegeven wil hebben: | Instelling | Wat het is | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **SIP URI** | De host van je telefoonsysteem, met een optionele poort, zoals `sip:pbx.example.com:5060`. Geef alleen de host op: een URI met een user-gedeelte wordt geweigerd | | **Priority** | De volgorde waarin gateways worden geprobeerd, laagste eerst | | **Destination format** | Hoe het gebelde nummer naar deze peer wordt weergegeven. Standaard E.164 | | **Origination format** | Hoe het bellende nummer naar deze peer wordt weergegeven, in de `P-Asserted-Identity`-header van de afgeleverde oproep. Standaard E.164 | Gateways met dezelfde prioriteit krijgen een gelijk aandeel van de oproepen, en elk van hen kan als eerste worden geprobeerd bij een bepaalde oproep. Om de aflevering over te laten vallen naar een tweede adres geef je die gateway een hoger prioriteitsnummer: hij wordt geprobeerd wanneer de eerste niet antwoordt. Beide nummerformaten zijn templates met één placeholder, `{number}`, die staat voor het nummer zonder de voorlooptekens `+`. Het bestemmingsformaat wordt voor de SIP URI-host geplaatst, dus `1234#{number}` levert een oproep naar `+31201234567` af als `sip:1234#31201234567@pbx.example.com:5060`. De standaardwaarde voor beide is `+{number}`, wat E.164 is. Een formaat dat helemaal geen `{number}` bevat, stuurt elk nummer dat de trunk beantwoordt naar één vast adres. > **Warning:** turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again. ## Oproepen doorsturen naar een ander nummer Een doorschakeling beantwoordt de inkomende oproep en plaatst een tweede oproep naar een nummer dat je hebt geverifieerd, en verbindt de twee vervolgens. 1. Open **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), open het nummer en kies onder **Inbound routing** de optie **Forward to another number**. 2. Kies het nummer om naar door te sturen. De lijst bevat je geverifieerde beller-ID's, omdat een doorschakeling alleen een nummer mag targeten waarvan je hebt bewezen dat je het beheert. 3. Kies welk nummer de doorgestuurde oproep als beller toont en selecteer vervolgens **Save**. Het doorschakeldoel wordt gecontroleerd wanneer je het instelt en opnieuw bij elke oproep die wordt doorgestuurd. Een beller-ID dat je later verwijdert stopt het doorsturen in plaats van door te gaan, en de inkomende oproepen worden vanaf dat moment geweigerd. De doorgestuurde oproep gaat 45 seconden over voordat hij wordt opgegeven, wat langer is dan bij een trunk-aflevering omdat het andere uiteinde meestal de telefoon van een persoon is in plaats van een telefoonsysteem. Doorsturen plaatst een oproep, dus de uitgaande regels gelden voor het tweede been: doorsturen naar een land dat je niet hebt ingeschakeld onder [Destinations](/docs/guides/voice/destinations) wordt geweigerd met `destination_not_enabled`. ### Eén doorschakeling, twee oproeprecords Een doorgestuurde oproep produceert twee records die een `session_id` delen: | Record | Wat het is | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | De binnenkomende oproep | `direction` is `inbound`, en `route` vermeldt dat het nummer was ingesteld op doorsturen, naar welk nummer, en welk nummer het doorgestuurde been presenteerde | | De doorgestuurde oproep | `direction` is `outbound`, van het nummer dat het been presenteerde naar het nummer waarnaar je doorstuurt. Het heeft geen eigen `route` | Groepeer ze op `session_id` om de volledige oproep te zien. Het binnenkomende record is het record dat aangeeft wat de instelling van het nummer was. ## Kiezen welk nummer een doorgestuurde oproep als beller toont Een doorgestuurde oproep heeft twee nummers die hij kan presenteren aan degene die opneemt, en de keuze bepaalt zowel wat diegene ziet als hoe waarschijnlijk het is dat een provider de oproep beïnvloedt: - **Bellend nummer** is het eigen nummer van de beller, zodat de telefoon overgaat alsof diegene rechtstreeks heeft gebeld en de oproep kan worden teruggebeld vanuit het oproeplogboek. Omdat het nummer niet van jou is, markeren sommige providers, vooral in de VS en delen van Europa, zulke oproepen als niet-geverifieerd, vervangen ze het nummer of screenen ze de oproep. - **Gebeld nummer** is het nummer dat de beller heeft gebeld, en dat is een van jouw nummers. Degene die opneemt ziet welk van jouw nummers is gebeld in plaats van wie er belde. Er is geen standaardwaarde. Geef de keuze op bij elke doorschakeling die je schrijft via de API of CLI. Welke waarden je werkruimte mag instellen staat op het nummer zelf, in `forward_as_options` op zijn `inbound_configuration`. Het gebelde nummer presenteren vereist dat je werkruimte is goedgekeurd om te bellen met nummers die je bij ons hebt gekocht, en die goedkeuring is nog niet beschikbaar, dus `forward_as_options` biedt alleen het bellende nummer en een doorschakeling presenteert het eigen nummer van de beller. Het gebelde nummer instellen wordt tot dan geweigerd. Bij het uitlezen is `forward_as` de waarde die de oproepen daadwerkelijk meesturen, wat kan afwijken van de laatst geschreven waarde. ## Bekijken wat een nummer met een oproep heeft gedaan Het record van een inkomende oproep bevat een `route` naast de status, en `route` is wat het nummer was ingesteld te doen op het moment dat de oproep werd afgehandeld. De instelling van het nummer achteraf wijzigen verandert niet wat de eerdere oproepen vermelden. | `route.type` | Wat het nummer deed | | ------------ | --------------------------------------------------------------------------------------------------------- | | `trunk` | De oproep is afgeleverd bij de SIP-trunk die in `trunk_id` staat | | `forward` | De oproep is doorgestuurd naar het nummer in `forward_to`, met het nummer in `forward_as` als presentatie | | `reject` | Het nummer heeft de oproep geweigerd | `route` geeft aan wat het nummer was ingesteld te doen, niet dat het gelukt is. Een `trunk`-route op een oproep die nooit verbinding maakte, is een nummer dat naar een trunk wees die de oproep niet aannam, en de status van de oproep draagt het resultaat. `route` ontbreekt bij uitgaande oproepen en bij oproepen die zijn vastgelegd voordat het veld bestond. Open in het dashboard de oproep via **Voice** > [**Calls**](https://bird.com/dashboard/w/voice/calls) en lees de rij **Inbound route**, die linkt naar het nummer waarvan de instellingen de beslissing namen. Via de API staat `route` op [`GET /v1/voice/calls/{call_id}`](/docs/api/reference/get-voice-call) en [`GET /v1/voice/calls`](/docs/api/reference/list-voice-calls), en `direction` filtert de lijst op inkomende oproepen. ## Een geweigerde inkomende oproep diagnosticeren Een inkomende oproep die is geweigerd, wordt vastgelegd met de status `rejected`. Twee verschillende dingen veroorzaken dit, en `rejection_reason` is wat ze onderscheidt: - **Geweigerd zonder `rejection_reason`.** Het nummer zelf heeft de oproep afgewezen. De oproep faalde op geen enkele controle van ons, dus er wordt geen reden vermeld, en `route` geeft aan wat het nummer was ingesteld te doen. Een `reject`-route is een nummer dat niemand ergens naartoe heeft gewezen, of een nummer dat bewust op weigeren staat. - **Geweigerd met een `rejection_reason`.** De oproep faalde op een van onze controles voordat hij je telefoonsysteem bereikte. De reden noemt de controle. [Geweigerde oproepen](/docs/guides/voice/call-log#rejected-calls) vermeldt elke reden en de bijbehorende oplossing. `failed` is een andere status en betekent niet geweigerd: het betekent dat de oproep is geprobeerd en niet is gelukt, waarbij `sip_response_code` het teruggekomen antwoord draagt. Lees `route` en `rejection_reason` samen om de weigeringen te onderscheiden: | `route` en reden | Oorzaak | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `reject`, geen reden | Het nummer is niet aan een antwoord gekoppeld. Een trunk verwijderen, of het inkomend bellen ervan uitzetten, plaatst elk nummer dat ernaar wees hier terug, dus een nummer dat eerder werkte kan hier belanden | | `trunk`, `no_route_found` | Het nummer is aan een trunk gekoppeld, maar die trunk heeft geen gateway om de oproep aan af te leveren. Voeg er een toe op de trunkpagina | | `forward`, geen reden | Het doorschakeldoel is niet langer een geverifieerd beller-ID. Verifieer het opnieuw onder [Caller IDs](/docs/guides/voice/caller-ids), of stuur door naar een ander nummer | | `forward`, `destination_not_enabled` | Het tweede been kon niet worden geplaatst naar het land van het doorschakeldoel. Schakel dat land in onder [Destinations](/docs/guides/voice/destinations) | De accountlimieten gelden ook voor inkomende oproepen: voorbij je walletsaldo, de dagelijkse spraaklimiet van je organisatie, of je gelijktijdigheids- en per-seconde-limieten wordt een inkomende oproep geweigerd met de bijbehorende reden. [Voice overview](/docs/guides/voice/overview#limits) behandelt de limieten zelf. ## Controleren wat een ontvangen oproep kost Het ontvangen van een oproep wordt in rekening gebracht. Het tarief hangt af van het land en het type van het ontvangende nummer en wordt per land gepubliceerd onder **Receiving calls** op de [spraakprijzenpagina](/pricing/voice), naast de tarieven voor oproepen die je plaatst. Een doorschakeling wordt gefactureerd als twee oproepen: de binnenkomende oproep tegen het ontvangsttarief, en het been dat wij plaatsen tegen het uitgaande tarief voor het nummer waarnaar je doorstuurt. Er wordt één afhandelingsvergoeding in rekening gebracht per oproep, niet per been. De wallet wordt gecontroleerd voordat een inkomende oproep wordt afgeleverd, dus een saldo dat de oproep niet kan dekken betekent dat de oproep wordt geweigerd in plaats van achteraf aan je gefactureerd. [Kosten en facturering](/docs/guides/voice/placing-calls#cost-and-billing) behandelt hoe factureerbare tijd, tarieven en de wallet werken voor beide richtingen. ## Volgende stappen | Pagina | Wat het behandelt | | ------------------------------------------------------------- | -------------------------------------------------------------------- | | [SIP-trunks](/docs/guides/voice/sip-trunks) | Een trunk aanmaken, de twee richtingen, en bepalen wie mag verzenden | | [Beller-ID's](/docs/guides/voice/caller-ids) | Een nummer registreren en bewijzen dat je het beheert | | [Oproeplogboek](/docs/guides/voice/call-log) | Elk veld in een oproeprecord en elke weigeringsreden | | [Voice-events](/docs/guides/voice/events) | Oproepresultaten laten pushen naar je eigen systemen | | [Voice-probleemoplossing](/docs/guides/voice/troubleshooting) | Een oproep diagnosticeren die niet doorkomt, vanuit het symptoom | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/products/voice) (product) [Get an implementation brief](/learn/workspace?topic=voice)