Een VoIP-provider koppelen

Koppel een provider die je al gebruikt (Twilio of Telnyx via API-sleutel; SignalWire, Vonage, Plivo of een SIP-trunk via SIP), of open een nieuw Telnyx-account met begeleide configuratie.

Productieverkeer moet verlopen via nummers die je bezit, via je eigen VoIP-provider. Op de dashboardpagina Connections → VoIP (/dashboard/voip-connections) koppel je je provideraccount. Zodra dit is gekoppeld, importeer je nummers die zowel inkomende als uitgaande gesprekken ondersteunen.

Klik op Nieuwe verbinding en kies een van twee opties: Een provider verbinden die je al gebruikt of Een nieuw Telnyx-account instellen.

Verbind een provider die je al gebruikt#

Kies de provider waarbij je nummers zijn ondergebracht:

Plak voor Twilio en Telnyx de toegangsgegevens en klik op Verbinden en testen. ThunderPhone verifieert ze en configureert de providerzijde voor je. Voor Telnyx voegt ThunderPhone een eigen SIP-verbinding toe aan je Telnyx-account (met de naam thunderphone-production-<org>-outbound-<id>) en plaatst uitgaande gesprekken via deze verbinding, zodat Telnyx deze gesprekken bij je in rekening brengt. Hiervoor gebruikt het het spraakprofiel voor uitgaande gesprekken van de Telnyx-verbinding waarop je nummers staan, zodat de toegestane landen en bestedingslimieten van dat profiel van toepassing zijn. Als die verbinding geen spraakprofiel voor uitgaande gesprekken heeft en je account precies één ingeschakeld profiel heeft, gebruikt ThunderPhone dat profiel. Als je een ander profiel wilt gebruiken, wijs het dan toe aan de verbinding in het Telnyx-portaal en sla de ThunderPhone- verbinding opnieuw op. Als het account geen ingeschakeld profiel heeft, of meerdere, wijs er dan een toe aan de verbinding in het Telnyx-portaal en sla de ThunderPhone-verbinding opnieuw op. Tot die tijd mislukken uitgaande gesprekken met outbound_trunk_unavailable; inkomende gesprekken blijven werken.

Wanneer Telnyx een uitgaand gesprek weigert (bijvoorbeeld SIP 403 Forbidden), komt de weigering vanuit je eigen Telnyx-account. De gebruikelijke oorzaken zijn geen beschikbaar tegoed, een oproepnummer dat niet op dat Telnyx-account staat, of een spraakprofiel voor uitgaande gesprekken dat het bestemmingsland niet toestaat.

SIP-configuratie voor SignalWire, Vonage en Plivo#

Deze drie openen het handmatige SIP-formulier met de stappen voor die provider bovenaan, een link naar de eigen configuratiehandleiding van de provider en een voorbeeld van een SIP-domein:

• SignalWire: maak SIP-toegangsgegevens voor uitgaande gesprekken, voer het SIP-domein, de gebruikersnaam en het wachtwoord in, en geef elk nummer een SWML-script dat inkomende gesprekken verbindt met het SIP-eindpunt van ThunderPhone.
• Vonage: maak in het SIP Trunking-dashboard een trunk met toegangsgegevens voor uitgaande gesprekken, voer het domein in (bijvoorbeeld your-trunk.sip-us.vonage.com) en de toegangsgegevens, voeg het SIP-eindpunt van ThunderPhone toe als de inkomende SIP-URI van de trunk, en koppel je nummers aan de trunk.
• Plivo: maak een uitgaande trunk met toegangsgegevens en voer het Termination SIP Domain (<trunk-id>.zt.plivo.com), de gebruikersnaam en het wachtwoord in; maak een inkomende trunk waarvan de Primary URI het SIP-eindpunt van ThunderPhone is, gevolgd door ;transport=tcp; stel vervolgens voor elk nummer het Applicatietype in op die trunk.

Het resultaat is een handmatige SIP-verbinding (provider: "manual" in de API), die precies hetzelfde wordt getest en geverifieerd als een verbinding die handmatig is ingevoerd. De verbindingskaart toont de naam van de provider, bijvoorbeeld SignalWire · SIP.

Een nieuw Telnyx-account instellen#

Nog geen provider? De begeleide flow helpt je een Telnyx-account te openen en te verbinden:

1. Account aanmaken

   Klik op Telnyx-aanmelding openen, maak je account aan en vink "Ik heb mijn account aangemaakt" aan.

2. Een API-sleutel ophalen

   Klik op Pagina met API-sleutels openen, genereer een sleutel en plak deze in API-sleutel (v2). Geef de verbinding desgewenst een naam.

3. Koppelen en testen

   Klik op Koppelen en testen — ThunderPhone controleert de inloggegevens en richt aan de Telnyx-zijde in wat nodig is voordat de verbinding wordt opgeslagen.

Wat ThunderPhone instelt in Telnyx#

Tenzij je je eigen verbindings-ID invoert, laten beide Telnyx-routes (begeleide instelling en het plakken van een API-sleutel) hetzelfde achter in je Telnyx- account: één SIP-verbinding met de naam thunderphone-<your organization id>. Dit is een FQDN-verbinding waarvan het FQDN-record naar het SIP-eindpunt van ThunderPhone wijst, en elk nummer dat je importeert eraan wordt toegewezen. Telnyx stuurt oproepen voor die nummers rechtstreeks via SIP naar ThunderPhone.

• De webhookvelden zijn bewust leeg. Er is geen webhook, Call Control- applicatie, TeXML-applicatie of geregistreerde SIP-telefoon betrokken.
• Verplaats geïmporteerde nummers niet naar een andere verbinding of applicatie, en registreer er geen apparaat voor.
• Als je bij het verbinden je eigen verbindings-ID hebt ingevoerd, gebruikt ThunderPhone die verbinding in plaats daarvan en wijzigt deze nooit; het moet een FQDN-verbinding zijn die naar het SIP-eindpunt van ThunderPhone wijst.

Vóór 30 augustus 2026 was de door ThunderPhone gemaakte thunderphone-…-verbinding een Credential-verbinding, die geen oproepen kan ontvangen. Als die van jou nog steeds als een Credential-verbinding wordt weergegeven, neem dan contact op met support zodat we deze kunnen omzetten.

Handmatige SIP-configuratie#

De SignalWire-, Vonage- en Plivo-tegels openen dit formulier, net als Ik voer elke instelling zelf in onder Andere provider. Elke SIP-trunk werkt, inclusief DIDWW of een PBX die je zelf beheert. Voer de verbindingsnaam, het SIP-domein / de URI, optionele gebruikersnaam en wachtwoord, poort en transport in; Geavanceerde instellingen voegt mediaversleuteling (SRTP) toe. Het formulier toont ook het SIP- adres waar je trunk inkomende oproepen naartoe moet sturen: sip.thunderphone.com, op poort 5060 voor UDP of TCP, of 5061 voor TLS. Via TLS blijft de SIP- signalering versleuteld tot aan LiveKit Cloud, waar ThunderPhone de oproep afhandelt; audio gaat nooit via sip.thunderphone.com, dus SRTP werkt zoals voorheen. Richt elke oproep aan het gekozen nummer in E.164-notatie, met hetzelfde nummer, inclusief de +, in zowel de aanvraagregel als de To-header: bijvoorbeeld sip:+14155550142@sip.thunderphone.com. Met de + kan ThunderPhone de oproep in de juiste regio afhandelen (zie de opmerking onder IP-toelating). Trunks die eerder zijn ingesteld met een adres van <your-project>.sip.livekit.cloud blijven werken zolang Toegestane bron-IP-adressen leeg is; je hoeft ze niet te wijzigen. ThunderPhone zet deze instellingen om in een toegewezen paar SIP-trunks op LiveKit Cloud: uitgaande oproepen vanaf de nummers van de verbinding worden met je inloggegevens naar je SIP-domein geplaatst, en inkomende oproepen naar die nummers worden vanaf elk adres geaccepteerd, tenzij je het optionele veld Toegestane bron-IP-adressen invult. Vul dit alleen in als je provider vaste signalerings-IP-adressen publiceert: een onjuiste of onvolledige lijst zorgt ervoor dat ThunderPhone de inkomende oproepen van je provider weigert. Twee knoppen doen het meeste werk:

• AI-configuratiegids genereren — schrijft providerspecifieke instructies voor de trunkconfiguratie die je nodig hebt.
• Verbinding testen en opslaan — controleert of het SIP-eindpunt naar een openbaar adres verwijst en, voor TCP/TLS, een verbinding op de gekozen poort accepteert (UDP-hosts krijgen alleen de DNS-controle), en slaat vervolgens op. Er kan nog geen oproep worden geplaatst omdat de verbinding geen nummers heeft; het echte bewijs komt tijdens het importeren (hieronder).

Wanneer je later een verbinding bewerkt, wordt dezelfde controle opnieuw uitgevoerd op je gewijzigde instellingen voordat er iets wordt opgeslagen. Daarna wordt de trunk opnieuw opgebouwd en wordt elk nummer op de verbinding opnieuw geverifieerd met een korte testoproep op de achtergrond — de nummers worden als Inrichten weergegeven totdat hun testoproep slaagt. Alleen Toegestane bron-IP-adressen wijzigen op een Verbonden verbinding is anders: dit heeft nooit invloed op uitgaande oproepen, dus ThunderPhone werkt de lijst op de inkomende trunk direct bij en de nummers blijven Actief. De test voor inkomende oproepen wordt teruggezet naar niet getest; voer deze opnieuw uit of plaats een echte oproep via je provider om te bevestigen dat de nieuwe lijst oproepen doorlaat. De test mislukt wanneer de oproep op basis van de lijst zou worden geweigerd. Opgeslagen wachtwoorden worden nooit opnieuw weergegeven; laat het wachtwoord leeg om het te behouden, of vink "Het opgeslagen wachtwoord verwijderen" aan voor een trunk met IP-authenticatie.

IP-toelating en trunkverificatie#

Sommige providers (DIDWW, Telnyx-verbindingen met IP-authenticatie, de meeste PBX'en achter een firewall) accepteren alleen SIP-verkeer van adressen die je op de toelatingslijst zet, of authenticeren uitgaande oproepen op basis van het bron-IP. ThunderPhone gebruikt twee groepen adressen.

SIP-edge. Inkomende oproepen die je naar sip.thunderphone.com stuurt, lopen via de SIP-edge van ThunderPhone, die alleen SIP-signalering verwerkt. De eerste INVITE gaat naar sip.thunderphone.com; de overige signalering van de oproep (ACK, ophangen, doorverbinden) verloopt tussen je provider en de edgeserver die de oproep aannam, sip-1 of sip-2. Als je firewall SIP-signalering filtert, sta dan alle drie toe op UDP- en TCP-poort 5060 en TLS-poort 5061:

LiveKit Cloud. De audio (RTP) van elke oproep en de SIP-signalering van uitgaande oproepen verlopen tussen je provider en LiveKit Cloud, nooit via de SIP-edge. Sta elk bereik hieronder toe, voor zowel SIP-signalering als media:

LiveKit gebruikt deze bereiken voor Realtime, SIP-signalering en media en Webhooks, en ze dekken oproepen af die worden afgehandeld in de regio's Canada, EU, India, Japan en VS. Regionamen voor een vastgezet eindpunt: canada, eu, india, japan, us.

Enkele vuistregels voor de trunk zelf:

• ThunderPhone registreert niet. Het stuurt nooit SIP REGISTER naar je provider, dus configureer de trunk voor IP-gebaseerde en/of verificatie op basis van inloggegevens (gebruikersnaam + wachtwoord), niet voor registratie.
• Uitgaande oproepen moeten inloggegevens gebruiken. Schakel authenticatie met gebruikersnaam/wachtwoord in aan de kant van de provider en voer dezelfde waarden in het handmatige SIP-formulier in. Beschouw de IP-toelatingslijst als een tweede laag, niet als de enige — uitgaande oproepen naar bestemmingen buiten de gedekte regio's kunnen van andere adressen afkomstig zijn.
• Inkomend is de omgekeerde richting. Het optionele veld Toegestane bron-IP's in het formulier is waar je de signaleringsadressen van je provider invoert, zodat ThunderPhone alleen oproepen daarvan accepteert. Voer IP-adressen of CIDR-bereiken in; hostnamen komen nooit overeen. Laat het leeg tenzij je provider een vaste lijst publiceert. ThunderPhone controleert de lijst bij elke inkomende oproep aan de hand van het adres dat de SIP-edge ziet, dus stuur je oproepen, zodra de lijst is ingesteld, naar sip.thunderphone.com. Een oproep van een adres dat niet op de lijst staat, of een oproep die rechtstreeks naar een adres van <your-project>.sip.livekit.cloud wordt gestuurd, wordt geweigerd: deze mislukt of maakt verbinding en wordt onmiddellijk beëindigd.

De bereiken worden door LiveKit gepubliceerd op Regio's, regionale eindpunten en statische IP's; ThunderPhone controleert die pagina wekelijks en werkt deze gids bij wanneer deze verandert.

Na het verbinden#

Importeer nummers via Telefoonnummers → Nummer toevoegen → VoIP-provider verbinden (of rechtstreeks vanuit de verbinding). Elk geïmporteerd nummer wordt geverifieerd voordat het actief wordt. Bij een handmatige SIP-verbinding plaatst die verificatie een korte testoproep van enkele seconden vanaf je nummer, via je SIP-trunk, naar een ThunderPhone-nummer — zodat de gebruikersnaam, het wachtwoord, het transport en de uitgaande routering van je provider allemaal daadwerkelijk worden getest. Je provider factureert die oproep zoals elke andere oproep.

Als de provider deze weigert, blijft het nummer in Inrichten staan en toont de pagina met telefoonnummers het antwoord van de provider (bijvoorbeeld "ThunderPhone-referenties geweigerd (SIP 401)"); herstel de verbinding en verifieer opnieuw. Als je provider de trunk accepteert maar het routeringsplan het testnummer van ThunderPhone niet dekt (DIDWW antwoordt "Bestemmingsnummer geblokkeerd door routeringsplan"), wordt het nummer weergegeven als Geverifieerd · provider geaccepteerd: het is bruikbaar, maar oproepen naar andere bestemmingen zijn niet getest. Die oproep bewijst dat je trunk oproepen kan plaatsen als het nummer; het bewijst niet dat je eigenaar bent van het nummer en test geen oproepen naar het nummer; de optionele inkomende test hieronder doet dat wel. Geverifieerde nummers ondersteunen inkomend en uitgaand — waarmee je uitgaande campagnes en programmatische uitgaande oproepen kunt gebruiken.

Test voor inkomende oproepen#

Nummer verifiëren opent een dialoogvenster dat ook inkomende oproepen kan testen. De test belt je nummer, controleert of de oproep ThunderPhone bereikt en hangt vervolgens op zonder je spraakagent te starten:

• Nummers met hun eigen uitgaande SIP-trunk (handmatige SIP-nummers en Twilio-nummers zodra ThunderPhone uitgaand bellen in je Twilio-account heeft ingesteld) bellen eerst zichzelf: ThunderPhone belt het nummer vanaf het nummer, via die trunk. Het dialoogvenster vertelt je dit voordat de oproep wordt geplaatst. De oproep gaat via je provider naar buiten en komt, als je inkomende routering juist is, rechtstreeks terug bij ThunderPhone. Wanneer deze terugkomt met de eigen beller-ID van het nummer, bewijst die ene oproep zowel dat je provider oproepen van ThunderPhone accepteert als afkomstig van het nummer als dat oproepen naar het nummer ThunderPhone bereiken, in elk land. Sommige providers weigeren of verbinden geen oproep van een nummer naar zichzelf; dat zegt niets over je routering, dus belt ThunderPhone dan vanaf een van zijn eigen nummers. Als je nummer naar een andere bestemming doorschakelt, kan die telefoon twee keer overgaan: eerst met de eigen beller-ID van het nummer, daarna met het testnummer van ThunderPhone.
• Andere nummers (en de bovenstaande terugvaloptie) worden gebeld vanaf een van ThunderPhone's eigen nummers. ThunderPhone kan deze oproepen voorlopig alleen naar Amerikaanse en Canadese nummers plaatsen; voor andere nummers meldt de test dat deze niet kon worden uitgevoerd, met het antwoord van je provider als de oproep naar zichzelf werd geweigerd.

Als je provider onderweg de beller-ID wijzigt, kan ThunderPhone de oproep niet herkennen, waardoor je spraakagent deze mogelijk even beantwoordt. De inkomende test is optioneel. Sla deze over en het nummer werkt nog steeds; de pagina met telefoonnummers toont dan Inkomend niet getest, en je kunt de test later uitvoeren met Testen of het menu-item Inkomende oproepen testen van het nummer. Direct na een import vraagt de pagina met telefoonnummers je ook om inkomende oproepen op de nieuwe nummers te testen. Er wordt niets gebeld totdat je dit in het dialoogvenster bevestigt.

Als je provider het nummer ergens anders naartoe stuurt, kan wat er ook op is ingesteld per oproep maximaal 8 seconden overgaan voordat ThunderPhone ophangt. Als iets eerder opneemt (een Twilio-app die opneemt en daarna doorstuurt, een telefoonmenu), wacht de test tot de doorgestuurde oproep ThunderPhone bereikt: maximaal 8 seconden bij de oproep naar zichzelf en 15 seconden bij een oproep vanaf een ThunderPhone-nummer. Het resultaat blijft bij het nummer staan (Inkomend geslaagd of mislukt) totdat je de verbinding wijzigt of het nummer opnieuw importeert, waarna het wordt teruggezet op niet getest. Het wijzigen van een verbinding verifieert uitgaande oproepen opnieuw op de achtergrond, maar belt je nummer nooit zonder dat je erom vraagt.

Problemen met inkomende oproepen oplossen#

De knop Testen van de verbinding controleert de inloggegevens en de verificatie controleert uitgaand bellen. Voer de test voor inkomende oproepen hierboven uit om inkomende oproepen te controleren, of bel het nummer vanaf een telefoon en zoek de oproep in Oproepgeschiedenis. Praten-tests in de browser en bot-naar-botsimulaties verlopen niet via je provider, dus ze tonen niet of inkomende oproepen werken. Een simulatie die het telefoonnummer als doel heeft (SIP-loopback) belt wel via je provider, dus een beantwoorde oproep test de routering van inkomende oproepen.

• Je hoort het bericht van je eigen mobiele provider (bijvoorbeeld "Welkom bij Verizon" of "het nummer dat je hebt gebeld, is niet in gebruik"): de oproep is mislukt voordat deze ThunderPhone bereikte. Controleer of het nummer actief is in je provideraccount en is toegewezen aan de ThunderPhone- verbinding of -trunk.
• Bezettoon of de oproep blijft overgaan: de provider heeft de oproep geaccepteerd, maar kon deze niet afleveren. Controleer bij Telnyx de Verbinding van het nummer in het Telnyx-portaal: dit moet de hierboven beschreven thunderphone-… FQDN-verbinding zijn, of je eigen FQDN- verbinding die naar het ThunderPhone SIP-eindpunt verwijst. Bij Twilio moet het nummer zijn gekoppeld aan de ThunderPhone SIP-trunk in plaats van aan een Voice-webhook of TwiML-app.
• In de logs van je provider staat 404 No trunk found (handmatige SIP): de oproep heeft ThunderPhone bereikt, maar kwam niet overeen met een trunk. Controleer of het nummer in deze verbinding is geïmporteerd en of de trunk verwijst naar sip.thunderphone.com. Als deze naar een <your-project>.sip.livekit.cloud-adres verwijst, moeten Toegestane bron-IP's leeg zijn: als er een lijst is ingesteld, worden alleen oproepen naar sip.thunderphone.com geaccepteerd.
• 404 Not Found van sip.thunderphone.com (handmatige SIP): de oproep was niet geadresseerd aan een telefoonnummer, of de aanvraagregel en de To-header vermelden verschillende nummers. Stuur het gebelde nummer in beide mee, zoals hierboven.
• 403 Forbidden van sip.thunderphone.com: de aanvraagregel vermeldt een andere host. Adresseer de oproep aan sip.thunderphone.com, bijvoorbeeld sip:+14155550142@sip.thunderphone.com.
• De oproep bereikt ThunderPhone, maar de verkeerde spraakagent neemt op of niemand: controleer de inkomende spraakagent van het nummer onder Telefoonnummers.

De Copilot in de app kan een nummer voor je controleren: vraag waarom oproepen naar het nummer mislukken. Voor Telnyx-verbindingen zoekt deze ook alleen-lezen en voor organisatiebeheerders op aan welke verbinding Telnyx het nummer toewijst.

Volgende stappen#