Forbind en VoIP-udbyder

Forbind en udbyder, du allerede bruger (Twilio eller Telnyx med API-nøgle; SignalWire, Vonage, Plivo eller enhver SIP-trunk via SIP), eller opret en ny Telnyx-konto med guidet opsætning.

Produktionstrafik bør køre på numre, du ejer, gennem din egen VoIP-udbyder. Dashboardets side Forbindelser → VoIP (/dashboard/voip-connections) forbinder din udbyderkonto. Når den er forbundet, importerer du numre, der understøtter både indgående og udgående opkald.

Klik på Ny forbindelse, og vælg én af to muligheder: Forbind en udbyder, du allerede bruger, eller Opret en ny Telnyx-konto.

Forbind en udbyder, du allerede bruger#

Vælg den udbyder, dine numre er hos:

For Twilio og Telnyx skal du indsætte legitimationsoplysningerne og klikke på Forbind & test. ThunderPhone verificerer dem og konfigurerer udbydersiden for dig. For Telnyx tilføjer ThunderPhone sin egen SIP-forbindelse til din Telnyx-konto (med navnet thunderphone-production-<org>-outbound-<id>) og foretager udgående opkald gennem den, så Telnyx fakturerer disse opkald til dig. Den bruger den udgående stemmeprofil fra den Telnyx-forbindelse, dine numre er tilknyttet, så profilens tilladte lande og forbrugsgrænser gælder. Hvis den forbindelse ikke har en udgående stemmeprofil, og din konto har præcis én aktiveret profil, bruger ThunderPhone den. Hvis du vil bruge en anden, skal du tildele den til forbindelsen i Telnyx-portalen og gemme ThunderPhone- forbindelsen igen. Hvis kontoen ikke har nogen aktiveret profil eller flere, skal du tildele en til forbindelsen i Telnyx-portalen og gemme ThunderPhone-forbindelsen igen. Indtil da mislykkes udgående opkald med outbound_trunk_unavailable; indgående opkald fungerer fortsat.

Når Telnyx afviser et udgående opkald (for eksempel SIP 403 Forbidden), kommer afvisningen fra din egen Telnyx-konto. De typiske årsager er manglende tilgængelig kredit, et opkaldsnummer, der ikke findes på den pågældende Telnyx-konto, eller en udgående stemmeprofil, der ikke tillader destinationslandet.

SIP-opsætning til SignalWire, Vonage og Plivo#

Disse tre åbner den manuelle SIP-formular med trinene for den pågældende udbyder øverst, et link til udbyderens egen opsætningsvejledning og et eksempel på et SIP-domæne:

• SignalWire: opret SIP-legitimationsoplysninger til udgående opkald, indtast SIP-domænet, brugernavnet og adgangskoden, og tildel hvert nummer et SWML-script, der forbinder indgående opkald til ThunderPhone SIP-endepunktet.
• Vonage: opret en trunk med legitimationsoplysninger til udgående opkald i SIP Trunking-dashboardet, indtast dens domæne (for eksempel your-trunk.sip-us.vonage.com) og legitimationsoplysningerne, tilføj ThunderPhone SIP-endepunktet som trunkens indgående SIP-URI, og knyt dine numre til trunken.
• Plivo: opret en udgående trunk med legitimationsoplysninger, og indtast dens Termination SIP Domain (<trunk-id>.zt.plivo.com), brugernavn og adgangskode; opret en indgående trunk, hvis Primary URI er ThunderPhone SIP-endepunktet efterfulgt af ;transport=tcp; indstil derefter hvert nummers Application Type til den trunk.

Resultatet er en manuel SIP-forbindelse (provider: "manual" i API'et), som testes og verificeres på præcis samme måde som en, der er indtastet manuelt. Forbindelseskortet viser udbyderens navn, for eksempel SignalWire · SIP.

Opret en ny Telnyx-konto#

Har du endnu ikke en udbyder? Den guidede proces hjælper dig med at oprette en Telnyx-konto og forbinde den:

1. Opret kontoen

   Klik på Åbn Telnyx-tilmelding, opret din konto, og markér "Jeg har oprettet min konto."

2. Hent en API-nøgle

   Klik på Åbn siden med API-nøgler, opret en nøgle, og indsæt den i API-nøgle (v2). Du kan valgfrit navngive forbindelsen.

3. Forbind og test

   Klik på Forbind og test — ThunderPhone verificerer legitimationsoplysningerne og klargør det nødvendige hos Telnyx, før forbindelsen gemmes.

Hvad ThunderPhone konfigurerer i Telnyx#

Medmindre du indtaster dit eget forbindelses-id, efterlader begge Telnyx-ruter (den guidede opsætning og indsættelse af en API-nøgle) det samme i din Telnyx-konto: én SIP-forbindelse med navnet thunderphone-<your organization id>. Det er en FQDN-forbindelse, hvis FQDN-post peger på ThunderPhones SIP-slutpunkt, og hvert nummer, du importerer, tildeles den. Telnyx sender opkald til disse numre direkte til ThunderPhone over SIP.

• Dens webhook-felter er med vilje tomme. Ingen webhook, Call Control- applikation, TeXML-applikation eller registreret SIP-telefon er involveret.
• Flyt ikke importerede numre til en anden forbindelse eller applikation, og registrer ikke en enhed på den.
• Hvis du indtastede dit eget forbindelses-id ved tilslutning, bruger ThunderPhone den forbindelse i stedet og ændrer den aldrig; den skal være en FQDN- forbindelse, der peger på ThunderPhones SIP-slutpunkt.

Før den 30. august 2026 var forbindelsen thunderphone-…, som ThunderPhone oprettede, en forbindelse med legitimationsoplysninger, som ikke kan modtage opkald. Hvis din stadig vises som en forbindelse med legitimationsoplysninger, skal du kontakte support, så konverterer vi den.

Manuel SIP-konfiguration#

Felterne for SignalWire, Vonage og Plivo åbner denne formular, og det gør Jeg indtaster selv alle indstillinger under Anden udbyder også. Alle SIP-trunks fungerer, herunder DIDWW eller en PBX, du selv kører. Indtast forbindelsesnavnet, SIP-domæne / URI, valgfrit brugernavn og adgangskode, port og transport; Avancerede indstillinger tilføjer mediekryptering (SRTP). Formularen viser også den SIP- adresse, som din trunk skal sende indgående opkald til: sip.thunderphone.com, på port 5060 for UDP eller TCP eller 5061 for TLS. Over TLS forbliver SIP- signaleringen krypteret hele vejen til LiveKit Cloud, hvor ThunderPhone håndterer opkaldet; lyd passerer aldrig gennem sip.thunderphone.com, så SRTP fungerer som før. Adressér hvert opkald til det kaldte nummer i E.164-format med det samme nummer, inklusive +, i både anmodningslinjen og To-headeren: for eksempel sip:+14155550142@sip.thunderphone.com. + gør det muligt for ThunderPhone at håndtere opkaldet i den korrekte region (se bemærkningen under IP-godkendelsesliste). Trunks, der tidligere er konfigureret med en <your-project>.sip.livekit.cloud- adresse, fungerer fortsat, så længe Tilladte kilde-IP-adresser er tom; du behøver ikke at ændre dem. ThunderPhone omdanner disse indstillinger til et dedikeret par SIP-trunks på LiveKit Cloud: udgående opkald fra forbindelseens numre foretages til dit SIP-domæne med dine legitimationsoplysninger, og indgående opkald til disse numre accepteres fra enhver adresse, medmindre du udfylder det valgfri felt Tilladte kilde-IP-adresser. Udfyld det kun, hvis din udbyder offentliggør faste signalerings-IP-adresser: En forkert eller ufuldstændig liste får ThunderPhone til at afvise din udbyders indgående opkald. To knapper klarer det meste:

• Generer AI-opsætningsvejledning — skriver udbyderspecifikke instruktioner til den trunkkonfiguration, du har brug for.
• Test og gem forbindelse — kontrollerer, at SIP-endpointet opløses til en offentlig adresse og, for TCP/TLS, accepterer en forbindelse på den valgte port (UDP-værter får kun DNS-kontrollen), og gemmer derefter. Den kan endnu ikke placere et opkald, fordi forbindelsen ikke har nogen numre; den egentlige bekræftelse kommer ved import (nedenfor).

Når du senere redigerer en forbindelse, køres den samme kontrol igen for dine ændrede indstillinger, før noget gemmes, hvorefter trunk'en genopbygges, og alle numre på forbindelsen verificeres igen med et kort testopkald i baggrunden — numrene vises som Klargøring, indtil deres testopkald lykkes. Hvis du kun ændrer Tilladte kilde-IP-adresser på en Forbundet forbindelse, er det anderledes: Det påvirker aldrig udgående opkald, så ThunderPhone opdaterer straks listen på den indgående trunk, og numrene forbliver Aktiv. Deres test af indgående opkald nulstilles til ikke testet; kør den igen, eller foretag et rigtigt opkald gennem din udbyder, for at bekræfte, at den nye liste tillader opkald. Testen fejler, når dens opkald ville blive afvist af listen. Gemte adgangskoder vises aldrig igen; lad adgangskodefeltet være tomt for at beholde den, eller markér "Fjern den gemte adgangskode" for en IP-godkendt trunk.

IP-allowlisting og trunkgodkendelse#

Nogle udbydere (DIDWW, Telnyx-forbindelser med IP-godkendelse, de fleste PBX'er bag en firewall) accepterer kun SIP-trafik fra adresser, du har tilladt, eller godkender udgående opkald efter kilde-IP. ThunderPhone bruger to sæt adresser.

SIP-edge. Indgående opkald, du sender til sip.thunderphone.com, går via ThunderPhones SIP-edge, som kun håndterer SIP-signalering. Den første INVITE går til sip.thunderphone.com; resten af opkaldets signalering (ACK, afbrydelse, viderestillinger) foregår mellem din udbyder og den edge-server, der modtog opkaldet, sip-1 eller sip-2. Hvis din firewall filtrerer SIP-signalering, skal du tillade alle tre på UDP- og TCP-port 5060 samt TLS-port 5061:

LiveKit Cloud. Lyden (RTP) i hvert opkald og SIP-signaleringen for udgående opkald går mellem din udbyder og LiveKit Cloud, aldrig gennem SIP-edge. Tillad alle nedenstående intervaller for både SIP-signalering og medier:

LiveKit anvender disse intervaller på Realtime, SIP-signalering og medier samt Webhooks, og de dækker opkald, der håndteres i dets regioner i Canada, EU, Indien, Japan og USA. Regionsnavne for et fastlåst endpoint: canada, eu, india, japan, us.

Nogle tommelfingerregler for selve trunken:

• ThunderPhone registrerer ikke. Den sender aldrig SIP REGISTER til din udbyder, så konfigurer trunk'en til IP-baseret og/eller legitimationsbaseret godkendelse (brugernavn + adgangskode), ikke registrering.
• Udgående opkald bør bruge legitimationsoplysninger. Aktivér godkendelse med brugernavn/adgangskode hos udbyderen, og indtast de samme værdier i den manuelle SIP-formular. Betragt IP-tilladelseslisten som et ekstra lag, ikke det eneste — udgående opkald til destinationer uden for de dækkede regioner kan stamme fra andre adresser.
• Indgående er den modsatte retning. Det valgfrie felt Tilladte kilde-IP-adresser i formularen er, hvor du indtaster din udbyders signaleringsadresser, så ThunderPhone kun accepterer opkald fra dem. Indtast IP-adresser eller CIDR-intervaller; værtsnavne matcher aldrig. Lad det stå tomt, medmindre din udbyder offentliggør en fast liste. ThunderPhone kontrollerer listen ved hvert indgående opkald mod den adresse, som SIP-edge ser, så når listen er angivet, skal du sende dine opkald til sip.thunderphone.com. Et opkald fra en adresse, der ikke er på listen, eller et opkald sendt direkte til en <your-project>.sip.livekit.cloud-adresse, afvises: det mislykkes eller forbindes og afsluttes straks.

Intervallerne offentliggøres af LiveKit på Regioner, regionale endpoints og statiske IP-adresser; ThunderPhone kontrollerer siden hver uge og opdaterer denne vejledning, når den ændres.

Efter tilslutning#

Importér numre fra Telefonnumre → Tilføj nummer → Tilslut VoIP-udbyder (eller direkte fra forbindelsen). Hvert importeret nummer verificeres, før det aktiveres. For en manuel SIP-forbindelse foretager verificeringen et kort testopkald (på nogle få sekunder) fra dit nummer, gennem din SIP-trunk, til et ThunderPhone-nummer — så brugernavn, adgangskode, transport og din operatørs udgående routing alle afprøves i praksis. Din operatør fakturerer opkaldet som ethvert andet opkald. Hvis operatøren afviser det, forbliver nummeret i Klargøring, og siden med telefonnumre viser operatørens svar (for eksempel "ThunderPhone's legitimationsoplysninger afvist (SIP 401)"); ret forbindelsen, og verificér igen. Hvis din operatør accepterer trunk-forbindelsen, men dens routingplan ikke dækker ThunderPhone's testnummer (DIDWW svarer "Destinationsnummer er sortlistet af routingplanen"), vises nummeret som Verificeret · operatør accepteret: det kan bruges, men opkald til andre destinationer blev ikke testet. Det opkald beviser, at din trunk kan foretage opkald som nummeret; det er ikke bevis på, at du ejer nummeret, og det tester ikke opkald til nummeret; den valgfrie indgående test nedenfor gør det. Verificerede numre understøtter indgående og udgående opkald — hvilket åbner for udgående kampagner og programmatiske udgående opkald.

Test af indgående opkald#

Bekræft nummer åbner en dialog, der også kan teste indgående opkald. Testen foretager et opkald til dit nummer, kontrollerer, at opkaldet når ThunderPhone, og lægger derefter på uden at starte din agent:

• Numre med deres egen udgående SIP-trunk (manuelle SIP-numre og Twilio-numre, når ThunderPhone har konfigureret udgående opkald i din Twilio-konto) ringer først til sig selv: ThunderPhone ringer nummeret op fra nummeret gennem den trunk. Dialogen fortæller dig det, før den foretager opkaldet. Opkaldet går ud gennem din operatør og kommer, hvis din indgående routing er korrekt, direkte tilbage til ThunderPhone. Når det kommer tilbage med nummerets eget afsendernummer, beviser det ene opkald både, at din operatør accepterer ThunderPhones opkald med nummeret som afsendernummer, og at opkald til nummeret når ThunderPhone, i alle lande. Nogle operatører afviser eller forbinder ikke et opkald fra et nummer til sig selv; det siger intet om din routing, så ThunderPhone ringer derefter fra et af sine egne numre i stedet. Hvis dit nummer viderestiller et andet sted hen, kan den telefon ringe to gange: først med nummerets eget afsendernummer og derefter med ThunderPhones testnummer.
• Andre numre (og reservefunktionen ovenfor) ringes op fra et af ThunderPhones egne numre. ThunderPhone kan indtil videre kun foretage disse opkald til amerikanske og canadiske numre; for andre numre rapporterer testen, at den ikke kunne køres, med din operatørs svar, hvis opkaldet til sig selv blev afvist.

Hvis din operatør ændrer afsendernummeret undervejs, kan ThunderPhone ikke genkende opkaldet, så din agent kan besvare det et øjeblik. Den indgående test er valgfri. Spring den over, så virker nummeret stadig; siden med telefonnumre viser derefter Indgående opkald ikke testet, og du kan køre den senere med Test eller menupunktet Test indgående opkald for nummeret. Lige efter en import beder siden med telefonnumre dig også om at teste indgående opkald på de nye numre. Intet ringes op, før du bekræfter i dialogen.

Hvis din udbyder sender nummeret et andet sted hen, kan det, som nummeret peger på, ringe i op til 8 sekunder pr. opkald, før ThunderPhone lægger på. Hvis noget svarer først (en Twilio-app, der svarer og derefter viderestiller, en telefonmenu), venter testen på, at det viderestillede opkald når ThunderPhone: op til 8 sekunder for opkaldet til sig selv og 15 sekunder for et opkald fra et ThunderPhone-nummer. Resultatet bliver på nummeret (Indgående bestået eller ikke bestået), indtil du ændrer forbindelsen eller genimporterer nummeret, hvilket nulstiller det til ikke testet. Ændring af en forbindelse bekræfter udgående opkald igen i baggrunden, men ringer aldrig til dit nummer uden at spørge dig.

Fejlfinding af indgående opkald#

Forbindelsens Test-knap kontrollerer legitimationsoplysninger, og verificering kontrollerer udgående opkald. For at kontrollere indgående opkald skal du køre testen af indgående opkald ovenfor eller ringe til nummeret fra en telefon og finde opkaldet i Opkaldshistorik. Browsertests med Tal og bot-til-bot-simuleringer går ikke gennem din operatør, så de viser ikke, om indgående opkald fungerer. En simulering, der målretter telefonnummeret (SIP-loopback), ringer dog til det gennem din operatør, så et besvaret opkald tester indgående routing.

• Du hører din egen mobiloperatørs besked (for eksempel "Velkommen til Verizon" eller "det nummer, du har ringet til, er ikke i brug"): opkaldet mislykkedes, før det nåede ThunderPhone. Kontrollér, at nummeret er aktivt på din udbyderkonto og tildelt ThunderPhone-forbindelsen eller -trunken.
• Optagettone, eller opkaldet ringer ud: udbyderen accepterede opkaldet, men kunne ikke levere det. Med Telnyx skal du kontrollere nummerets Forbindelse i Telnyx-portalen: det skal være den thunderphone-…-FQDN-forbindelse, der er beskrevet ovenfor, eller din egen FQDN- forbindelse, der peger på ThunderPhone SIP-slutpunktet. Med Twilio skal nummeret være knyttet til ThunderPhone SIP-trunken i stedet for en Voice-webhook eller TwiML-app.
• Din operatørs logfiler viser 404 No trunk found (manuel SIP): opkaldet nåede ThunderPhone, men matchede ingen trunk. Kontrollér, at nummeret er importeret på denne forbindelse, og at trunken peger på sip.thunderphone.com. Hvis den peger på en <your-project>.sip.livekit.cloud-adresse, skal Tilladte kilde-IP-adresser være tomt: når der er angivet en liste, accepteres kun opkald, der sendes til sip.thunderphone.com.
• 404 Not Found fra sip.thunderphone.com (manuel SIP): opkaldet var ikke adresseret til et telefonnummer, eller anmodningslinjen og To-headeren angiver forskellige numre. Send det kaldte nummer i begge, som ovenfor.
• 403 Forbidden fra sip.thunderphone.com: anmodningslinjen angiver en anden vært. Adressér opkaldet til sip.thunderphone.com, for eksempel sip:+14155550142@sip.thunderphone.com.
• Opkaldet når ThunderPhone, men den forkerte agent svarer, eller ingen gør: kontrollér nummerets indgående agent under Telefonnumre.

Copiloten i appen kan kontrollere et nummer for dig: spørg den, hvorfor opkald til nummeret mislykkes. For Telnyx-forbindelser kan den også slå op, skrivebeskyttet og for organisationsadministratorer, hvilken forbindelse Telnyx har tildelt nummeret.

Næste trin#