Voice-probleemoplossing

Begin bij het gesprekslog. Of er een record bestaat en welke velden het bevat, bepaalt welke controles je volgt.

Controleer bij gesprekken die via de API zijn gestart eerst het Create Call-antwoord en de uitvoeringsgeschiedenis. Volg probleemoplossing voor sequences voor previews, publicatie, toetsenpaden en inkomende sequenceroutes. De onderstaande verbindingscontroles gelden voor gesprekken via SIP-trunks.

Zie je helemaal geen gespreksrecords, controleer dan eerst het volgende:

1. Je zit in de juiste werkruimte. Gespreksrecords horen bij de werkruimte die het nummer of de trunk bevat. Schakel daarnaar over en open Voice > Legs.
2. Het gesprek heeft Bird bereikt. Bij een inkomend gesprek bepaalt de operator van de beller waar het gesprek heen gaat, en een nummer dat naar een trunk zonder opgeslagen gateway verwijst, weigert het gesprek voordat er een record bestaat. Zie voor een uitgaand gesprek Een uitgaand gesprek ontbreekt in het gesprekslog: een geweigerde toelating laat geen record achter.
3. De filters verbergen het niet. Wis het statusfilter en vergroot het datumbereik.

Een uitgaand gesprek ontbreekt in het gesprekslog

Bij een gesprek via een SIP-trunk kan een toelatingsfout optreden voordat er een leg-record bestaat. Controleer deze veelvoorkomende oorzaken:

• De trunk verwerkt nog geen uitgaande gesprekken. Een nieuwe trunk verwerkt geen enkel gesprek totdat je uitgaand bellen aanzet op de trunkpagina, en weigert elke poging totdat je dat doet, ongeacht welke inloggegevens het gesprek aanbiedt.
• De trunk kan je nog niet herkennen. Een nieuwe trunk weigert elk gesprek totdat je een IP-bereik, een toegestane API-sleutel of sessie-inloggegevens toevoegt.
• Het gesprek kwam van een adres buiten de IP-acceptatielijst van de trunk. Achter NAT: vergelijk het publieke adres van de router met de IP-acceptatielijst van de trunk. Het privéadres van het telefoonsysteem bereikt Bird niet.
• De wachtwoord-challenge is mislukt. Controleer of de gebruikersnaam bird is. Het wachtwoord moet het geheim van een toegestane API-sleutel zijn of niet-verlopen sessie-inloggegevens. De trunk moet ook het Digest-algoritme aanbieden dat je telefoonsysteem gebruikte.
• Het gesprek was gericht aan een SIP-domein dat Bird niet herkent. Je apparatuur moet het SIP-domein van de trunk in de host van de Request-URI zetten. Kopieer het domein in zijn geheel van de trunkpagina in plaats van het zelf samen te stellen. Een gesprek dat aan een andere Bird-hostnaam of een ander adres is gericht, bereikt je trunk niet.

Wat je apparatuur ontvangt, vertelt je welke controle mislukte. 407 Proxy Authentication Required betekent dat de trunk om een wachtwoord vraagt; met sessie-inloggegevens ingeschakeld vraagt hij dat aan elke beller. 403 Forbidden betekent dat de trunk het gesprek niet heeft toegelaten: een Request-URI-host die niet het SIP-domein van je trunk is, uitgaand bellen uitgeschakeld, een adres buiten de acceptatielijst of een wachtwoord dat niet is geverifieerd. 503 Auth Unavailable betekent dat Bird het gesprek niet kon controleren, dus probeer het opnieuw.

Controleer bij een sequencegesprek eerst of het gespreksverzoek is geaccepteerd en of er een uitvoering bestaat. Een simulatorpreview plaatst geen gesprek. Een echte test vereist een opgeslagen concept of actieve publicatie, schrijfrechten voor Voice-beheer en bellen, een geschikt beller-ID en een ingeschakelde bestemming. De gids voor de sequencebouwer legt deze controles uit.

Het gesprek is geweigerd met een weigeringsreden

Bird heeft het gesprek geweigerd voordat een carrier werd gebeld, en de reden noemt de controle die het niet doorstond. Open het gesprek en gebruik de link in het weigeringspaneel naar de relevante instelling. Geweigerde gesprekken somt elke reden en de bijbehorende oplossing op.

caller_id_not_verified is degene waar een nieuwe client het vaakst op stuit, meestal doordat de client de digest-gebruikersnaam invult waar het beller-ID thuishoort: het zijn verschillende velden.

Het gesprek is mislukt in plaats van geweigerd

Failed is geen weigering. Het gesprek is geprobeerd en lukte niet, en SIP response bevat de code die terugkwam. Een 486 is een bezet nummer, een 404 een niet-toegewezen nummer. Dit wijst meestal op het nummer dat je belde, niet op je configuratie.

Een gesprek dat Bird weigerde is Rejected, niet Failed. Filter het log dus op Rejected als je een gesprek zoekt dat een van de controles van Bird niet doorstond.

Het gesprek is geweigerd zonder weigeringsreden

Bij een uitgaand gesprek heeft de andere kant het ronduit afgewezen en SIP response bevat de code.

Bij een inkomend gesprek heeft het gebelde nummer het gesprek afgewezen, wat geen controle faalt en dus geen reden noemt. Open het gesprek en lees Inbound route: een reject-route is een nummer dat is ingesteld om te weigeren, of een nummer zonder eigen route terwijl de standaardroute van de werkruimte op weigeren staat. Gesprekken ontvangen behandelt elke inkomende weigering aan de hand van route en reden.

De persoon die je belde zag een ander nummer

Het gesprek heeft een record en geen weigeringsreden, dus het doorstond alle controles van Bird. Wat misging ligt na Bird: de afsluitende operator verving het beller-ID, of weigerde een gesprek dat het presenteert. Dezelfde oorzaak doet zich voor als een nummer dat in het ene land wel verbindt en in het andere nooit.

Verificatie bewijst dat je een beller-ID beheert. Het verplicht de operator die het gesprek aflevert niet om het te accepteren, en operators passen hun eigen nationale regels toe op een nummer dat niet via Bird is aangeschaft. Zie de disclaimer voor CLI-verificatie en -aflevering voor de betrokken praktijken, waaronder nationale CLI-vereisten, op herkomst gebaseerde blokkering en do-not-originate-lijsten.

Om te zien welk type nummer je presenteerde, open je het onder Voice > Numbers en lees je het paneel bovenaan de pagina. Een nummer dat je van Bird hebt gekocht, toont het abonnement, en dat geldt ook voor een nummer dat je hebt gekocht én geverifieerd. Alleen een nummer dat je ergens anders bezit, toont uitsluitend een verificatie. Een abonnement betekent dat het nummer via Bird is aangeschaft, dus de disclaimer is er niet op van toepassing. Een nummer presenteren dat via Bird is aangeschaft, is wat de aflever- en voltooiingspercentages verhoogt op bestemmingen die een geverifieerd nummer weigeren.

Een inkomend gesprek bereikt je telefoonsysteem niet

Het nummer heeft het gesprek beantwoord, en de aflevering is wat mislukte. Controleer in deze volgorde:

1. Lees de Inbound route van het gesprek. Daar staat naar welke trunk of doorschakeling het nummer verwees toen het gesprek binnenkwam. Een reject-route betekent dat het nummer een eigen route heeft die is ingesteld op weigeren, of dat het nummer geen eigen route heeft terwijl de standaardroute van de werkruimte op weigeren staat. Open het nummer om te zien welke situatie van toepassing is: een nummer dat is ingesteld op weigeren negeert de standaardroute. Een nummer waarvan de trunk is verwijderd of waarvan inkomend bellen is uitgeschakeld, valt terug op de standaardroute, en een standaardroute die naar die trunk verwijst valt terug op weigeren.
2. Controleer of de trunk kan afleveren. Open Inbound routing van de trunk. Een gateway moet in een groep zitten, en de Default route (of een regel) moet gesprekken naar die groep sturen. Een standaardroute die op Reject staat, weigert elk gesprek zonder weigeringsreden, en een trunk zonder opgeslagen gateway weigert het gesprek voordat er een record bestaat. Los de waarschuwing Calls never reach some gateways op als het dashboard die bij het opslaan toont.
3. Controleer het gateway-adres. Bird belt de gateways van de groep in de volgorde die de groep instelt en stopt als geen enkele antwoordt. Controleer de SIP URI-host, de poort, en of je telefoonsysteem daarop gesprekken van Bird accepteert.
4. Controleer bij een doorschakeling of het doel nog geverifieerd is. Het doorschakeldoel wordt bij elk gesprek opnieuw gecontroleerd, dus een beller-ID dat je hebt verwijderd stopt het doorschakelen vanaf dat moment.
5. Controleer het antwoord van je apparatuur. Een gesprek dat je gateway bereikte en daar werd geweigerd, is meestal Failed (een 6xx-antwoord verschijnt als Rejected), en SIP response bevat de code van je apparatuur, zoals 403 of 412. Bird heeft het gesprek geprobeerd, dus de oplossing ligt aan jouw kant: controleer of je SBC gesprekken accepteert van de signaleringsadressen van Bird en de nummernotatie die de gateway verstuurt.

Als het nummer Run a sequence gebruikt, inspecteer dan de gekoppelde sequence en het gespreksstartpunt in plaats van de trunk. Controleer of er een actieve publicatie is, of het startpunt lege gegevens accepteert en of de beller een concepttester is. Bekijk het uitvoeringsresultaat en de fouttak van de sequence. Een wijziging in het concept verandert niet de versie die gewone bellers gebruiken.

De browsertelefoon gaat niet over of kan niet bellen

Controleer eerst de status onderaan de telefoon:

1. Kies Online om gebeld te worden. Een belgroep slaat leden over die Offline of Busy zijn, al in gesprek zijn, of na drie gemiste gesprekken op rij op Not accepting calls staan. Je status legt elke status uit.
2. Ga online om te bellen. Met een Offline telefoon kun je geen gesprekken plaatsen. Met Online, Busy en Not accepting calls kan dat wel.
3. Haal gesprekken naar deze browser. In elke werkruimte ben je op één apparaat en in één tabblad tegelijk online. Offline · Active on another device biedt Take over aan, en Offline · Calls are handled in another tab biedt Use here aan.
4. Controleer de limiet voor online gebruikers. Offline · Limit of users online reached betekent dat je organisatie het maximale aantal online gebruikers heeft bereikt. Zie Limiet voor online gebruikers.
5. Zet het geluid aan. Na het herladen kan je browser de beltoon blokkeren totdat je iets op de pagina doet. Het statusmenu biedt dan Turn on sound aan.

Als de telefoon online is en een gesprek je nog steeds niet laat overgaan, lees dan de Inbound route van het gesprek in het gesprekslog. Daar staat de belgroep die het gesprek heeft gebeld, zodat je kunt controleren of je lid bent en of het nummer naar die groep routeert.

Je client antwoordt met MD5 en komt nergens

Sommige apparatuur verwerkt een challenge die begint met SHA-256 verkeerd. Stel de trunk in op alleen MD5.

Gesprekken verbinden maar audio is eenrichting

Je client zit achter NAT en de media gaat naar een privéadres. Schakel NAT- of STUN-afhandeling in de client in.

Als je apparatuur bereikbaar is en de audio nog steeds in één richting uitvalt, controleer dan of je firewall de media-adressen van Bird toestaat op UDP-poorten 2500 tot en met 32499.

Volgende stappen