Caller-ID's

Een caller-ID is een nummer dat je werkruimte kan presenteren bij een uitgaand gesprek. Bird controleert bij elk gesprek de SIP From-header aan de hand van de Bird-nummers die deze werkruimte mag presenteren en de geverifieerde externe nummers van de werkruimte. Gesprekken die een niet-toegestaan nummer presenteren, worden geweigerd.

Beheer caller-ID's onder Voice > Numbers. Hier staan alle nummers die je werkruimte kan gebruiken voor voice. Een nummer dat je bij ons hebt gekocht en een nummer dat je hebt geverifieerd verschijnen in dezelfde lijst, één rij per nummer. Een nummer dat beide is verschijnt één keer. Een nummer dat je bij ons hebt gekocht kun je direct presenteren zodra je het in bezit hebt, zonder verificatiegesprek: het bezit is het bewijs. De procedure hieronder is voor een nummer dat je elders bezit.

Elke rij toont de naam, het nummer en het land, de Provider, de ondersteunde gespreksrichtingen en waarvoor het nummer wordt gebruikt. Een nummer dat op de code wacht, toont Verifying; als de code is verlopen of de pogingen op zijn, toont het Failed. Elke pagina bevat maximaal 25 nummers. Selecteer een rij om de eigen pagina van het nummer te openen.

Een nummer registreren

1. Selecteer Add number > Verify a number you own.
2. Voer het nummer in in E.164-formaat: een + vooraan, landcode en nationaal nummer. Een nummer kan één keer worden geregistreerd in je werkruimte.
3. Sla het op. Er wordt direct een verificatiegesprek naar het nummer geplaatst.
4. Beantwoord de oproep en luister naar de zescijferige code.
5. Voer de code in het dashboard in. Je hebt vijf pogingen, en een geaccepteerde code wijzigt de status naar Verified.

Caller-ID-verificatie brengt je werkruimte geen kosten in rekening voor het verificatiegesprek. Registratie vereist nog wel Voice-beheerrechten en de goedkeuring van het account om geverifieerde nummers te registreren. Geef het nummer daarna een naam op zijn eigen pagina. Zie Een nummer een naam geven.

Controleer na verificatie het land dat je wilt bellen onder Voice > Destinations. Verificatie probeert het land van het geverifieerde nummer in te schakelen, maar niet-beschikbare landen of een mislukte instellingenupdate kunnen het uitgeschakeld laten. Een geverifieerde caller-ID en een ingeschakelde bestemming zijn afzonderlijke vereisten.

Registreer en verifieer via de API

Registreer een nummer om de verificatieoproep te starten en dien vervolgens de code in voor de ID die de registratie teruggeeft. Vraag de lijst met caller IDs op om een nummer te vinden dat in het dashboard is geregistreerd. Je kunt een caller ID ook hernoemen of verwijderen. Lezen vereist voice_management:read; registreren, verifiëren, hernoemen en verwijderen vereisen voice_management:write. De API-referentie bevat voorbeelden voor SDK, de Bird-opdrachtregel en MCP.

Als de oorspronkelijke verificatieoproep niet kon worden gestart, kan het indienen van de code een nieuwe oproep naar het geregistreerde nummer starten. Je organisatie moet nog steeds aan de registratievereisten voldoen. Als de code verloopt of de pogingen op zijn, verwijder je de caller ID en registreer je het nummer opnieuw. Dat start een nieuwe verificatieoproep; dien daarna de nieuwe code in voor de ID die die registratie teruggeeft. Als de code wordt geaccepteerd maar de activering 412 of 503 teruggeeft, is het eigendom nog steeds bewezen en staat de caller ID op verified met outbound_enabled: false. Een 412 betekent dat de identiteitsverificatie onvolledig is, wat je in het dashboard afrondt, of een geschiktheidsbeoordeling of afwijzing waarvoor support nodig is. Een 503 betekent dat de geschiktheidsbeoordeling nog loopt of niet beschikbaar is, dus probeer het later opnieuw. Dien daarna een lege verificatieaanvraag in voor dezelfde ID; verwijder en registreer hem niet opnieuw.

Controleer na de verificatie je Voice-bestemmingen en schakel het land van het nummer in wanneer dit wordt ondersteund en nodig is. De verificatie probeert dit in te schakelen, maar ook na een geslaagde caller-ID-verificatie kan de bestemming uitgeschakeld blijven en kunnen uitgaande gesprekken naar dat land geblokkeerd blijven.

Eén verificatie tegelijk

Registratie kan E21036 retourneren wanneer de verificatieprovider al een challenge heeft voor dat nummer van een andere werkruimte of een ander doel. Wacht tot die verificatie is afgerond of verlopen en registreer het nummer opnieuw. Een bewijs dat voor een andere werkruimte is verkregen verifieert het nummer niet in jouw werkruimte.

Dezelfde weigering geldt voor een nummer dat om een andere reden bezet is: een inlogcode of een Trust Hub-verificatie die er al naartoe onderweg is. Als geen andere werkruimte het nummer verifieert, is dat meestal de reden, en de wachttijd is dezelfde.

Een verificatie die elders al is afgerond blokkeert je niet: hetzelfde nummer kan in meer dan één werkruimte een geverifieerde caller-ID zijn, en elke werkruimte bewijst het afzonderlijk.

Statussen

Get a new code registreert het nummer opnieuw en belt het met een nieuwe code. Als het eerste gesprek nooit is aangekomen en het nummer nog steeds pending is, verwijder dan de caller-ID en voeg het nummer opnieuw toe.

Als je deze waarden uitleest met eigen tooling, verwerk de waarden die je herkent en behandel elke andere als een status die je niet verwerkt, niet als een fout.

CLI-verificatie en leveringsdisclaimer

Bird voert CLI-verificatie (Calling Line Identification) uit om te bevestigen dat een A-nummer geldig en geautoriseerd is voor gebruik voordat er uitgaande gesprekken vanaf het platform kunnen worden geplaatst. Deze verificatie garandeert dat het nummer legitiem is en onder controle van de klant.

Verificatie garandeert echter geen end-to-end-levering van de CLI of verbinding van het gesprek wanneer de CLI geen nummer is dat via Bird is verkregen. Downstream-carriers en internationale operators passen hun eigen nationale regelgeving en verkeersbeleid toe, die buiten de controle van Bird vallen. Dit kan het volgende omvatten:

• Anti-spoofing- en caller-ID-authenticatieframeworks (bijv. STIR/SHAKEN in de VS, Ofcom CLI-richtlijnen in het VK)
• Vereisten dat de CLI een lokaal geregistreerd of binnenlands nummer is
• Spam- en fraudefiltering toegepast door terminerende operators
• Beperkingen op specifieke verkeerscategorieën, zoals gokken, financiële promoties, incasso of politieke berichten
• Blokkering van internationale gesprekken die een binnenlandse CLI presenteren ("origin-based"-beperkingen)
• Do-not-originate-lijsten en door toezichthouders verplichte blokkering

Om deze redenen kan Bird een CLI verifiëren, maar niet garanderen dat (1) de CLI behouden blijft en getoond wordt aan de gebelde partij, of (2) het gesprek verbinding maakt via binnenlandse trunks of internationale Tier 1-partners en operators. Om de levering van CLI en het slagingspercentage van gesprekken te maximaliseren, raden we aan nummers te gebruiken die via Bird zijn verkregen en die zijn ingericht en gerouteerd conform lokale regelgevingsvereisten.

Een nummer een naam geven

Een naam labelt het nummer in het dashboard en in de Call from-lijst van de dialer. De naam wordt niet meegestuurd met het gesprek.

Selecteer het nummer in de Numbers-lijst om de pagina te openen, stel Name in en sla op. Laat het veld leeg om alleen het nummer te tonen. Een naam geven werkt bij elke status en verandert niets aan het nummer of de verificatie.

Een nummer verifiëren dat je niet kunt beantwoorden

Iemand moet het verificatiegesprek beantwoorden en de code horen. Als het nummer normaal een onbemand systeem bereikt, routeer het dan tijdelijk naar een telefoon die je kunt beantwoorden en zet het daarna terug. Neem contact op met support als het nummer geen gesprekken kan ontvangen.

Een caller-ID verwijderen

Gebruik Remove caller ID op de rij van het nummer. Het verwijderen van de verificatie neemt dat bewijs weg voor nieuwe gesprekken. Een nummer dat je werkruimte via Bird bezit kan in aanmerking blijven via de toewijzing; een extern nummer dat zijn bewijs verliest wordt geweigerd met caller_id_not_verified. Lopende gesprekken gaan door, en bestaande gespreksrecords veranderen niet.

Volgende stappen