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 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 met inkomend bellen aan en minstens één aflevergateway.
- Voor doorsturen: een geverifieerd beller-ID 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.
- Open Voice > SIP Trunks, open de trunk en selecteer onder Inbound calling de optie Enable inbound.
- Voeg minstens één gateway toe in dezelfde sectie. Een trunk zonder gateway weigert elke inkomende oproep naar de nummers die hij beantwoordt.
- Open Voice > Numbers, open het nummer en kies onder Inbound routing de optie Deliver to a SIP trunk.
- 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.
- Open Voice > Numbers, open het nummer en kies onder Inbound routing de optie Forward to another number.
- 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.
- 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 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 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} en GET /v1/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 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, 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 |
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 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, 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 behandelt hoe factureerbare tijd, tarieven en de wallet werken voor beide richtingen.
Volgende stappen
| Pagina | Wat het behandelt |
|---|---|
| SIP-trunks | Een trunk aanmaken, de twee richtingen, en bepalen wie mag verzenden |
| Beller-ID's | Een nummer registreren en bewijzen dat je het beheert |
| Oproeplogboek | Elk veld in een oproeprecord en elke weigeringsreden |
| Voice-events | Oproepresultaten laten pushen naar je eigen systemen |
| Voice-probleemoplossing | Een oproep diagnosticeren die niet doorkomt, vanuit het symptoom |
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.