Koble til en VoIP-leverandør

Koble til en leverandør du allerede bruker (Twilio eller Telnyx med API-nøkkel; SignalWire, Vonage, Plivo eller en hvilken som helst SIP-trunk via SIP), eller opprett en ny Telnyx-konto med veiledet oppsett.

Produksjonstrafikk bør kjøres på numre du eier, gjennom din egen VoIP-leverandør. Dashbordets side Tilkoblinger → VoIP (/dashboard/voip-connections) kobler til leverandørkontoen din. Når den er koblet til, importerer du numre som støtter både innkommende og utgående anrop.

Klikk på Ny tilkobling og velg én av to veier: Koble til en leverandør du allerede bruker eller Opprett en ny Telnyx-konto.

Koble til en leverandør du allerede bruker#

Velg leverandøren numrene dine er hos:

For Twilio og Telnyx limer du inn påloggingsopplysningene og klikker på Koble til og test. ThunderPhone verifiserer dem og konfigurerer leverandørsiden for deg. For Telnyx legger ThunderPhone til én egen SIP-tilkobling i Telnyx-kontoen din (med navnet thunderphone-production-<org>-outbound-<id>) og ringer utgående samtaler gjennom den, slik at Telnyx fakturerer deg for disse samtalene. Den bruker den utgående taleprofilen for Telnyx-tilkoblingen numrene dine er på, slik at profilens tillatte land og forbruksgrenser gjelder. Hvis denne tilkoblingen ikke har noen utgående taleprofil og kontoen din har nøyaktig én aktivert profil, bruker ThunderPhone den. Hvis du vil bruke en annen, tilordner du den til tilkoblingen i Telnyx-portalen og lagrer ThunderPhone- tilkoblingen på nytt. Hvis kontoen ikke har noen aktivert profil, eller flere, tilordner du én til tilkoblingen i Telnyx-portalen og lagrer ThunderPhone-tilkoblingen på nytt. Frem til da mislykkes utgående samtaler med outbound_trunk_unavailable; innkommende samtaler fortsetter å fungere.

Når Telnyx avviser en utgående samtale (for eksempel SIP 403 Forbidden), kommer avvisningen fra din egen Telnyx-konto. Vanlige årsaker er ingen tilgjengelig kreditt, et oppringernummer som ikke finnes på denne Telnyx-kontoen, eller en utgående taleprofil som ikke tillater destinasjonslandet.

SIP-oppsett for SignalWire, Vonage og Plivo#

Disse tre åpner det manuelle SIP-skjemaet med trinnene for den aktuelle leverandøren øverst, en lenke til leverandørens egen oppsettsveiledning og et eksempel på et SIP-domene:

• SignalWire: opprett SIP-påloggingsopplysninger for utgående samtaler, oppgi SIP-domenet, brukernavnet og passordet, og gi hvert nummer et SWML-skript som kobler innkommende samtaler til ThunderPhone SIP-endepunktet.
• Vonage: opprett en trunk med påloggingsopplysninger for utgående samtaler i SIP Trunking-dashbordet, oppgi domenet (for eksempel your-trunk.sip-us.vonage.com) og påloggingsopplysningene, legg til ThunderPhone SIP-endepunktet som trunkens innkommende SIP-URI, og koble numrene dine til trunk-en.
• Plivo: opprett en utgående trunk med påloggingsopplysninger og oppgi dens Termination SIP Domain (<trunk-id>.zt.plivo.com), brukernavn og passord; opprett en innkommende trunk med ThunderPhone SIP-endepunktet etterfulgt av ;transport=tcp som Primary URI; angi deretter hvert nummers Application Type til denne trunk-en.

Resultatet er en manuell SIP-tilkobling (provider: "manual" i API-et), testet og verifisert på nøyaktig samme måte som en som er lagt inn manuelt. Tilkoblingskortet viser leverandørens navn, for eksempel SignalWire · SIP.

Opprett en ny Telnyx-konto#

Har du ingen leverandør ennå? Den veiledede prosessen hjelper deg med å opprette en Telnyx-konto og koble den til:

1. Opprett kontoen

   Klikk på Åpne Telnyx-registrering, opprett kontoen din, og velg "Jeg har opprettet kontoen min."

2. Hent en API-nøkkel

   Klikk på Åpne siden for API-nøkler, opprett en nøkkel, og lim den inn i API-nøkkel (v2). Du kan eventuelt gi tilkoblingen et navn.

3. Koble til og test

   Klikk på Koble til og test — ThunderPhone verifiserer påloggingsopplysningene og klargjør det som trengs hos Telnyx før tilkoblingen lagres.

Hva ThunderPhone setter opp i Telnyx#

Med mindre du oppgir din egen Connection ID, etterlater begge Telnyx-rutene (veiledet oppsett og innliming av en API-nøkkel) det samme i Telnyx-kontoen din: én SIP-tilkobling med navnet thunderphone-<your organization id>. Det er en FQDN-tilkobling der FQDN-oppføringen peker til ThunderPhones SIP-endepunkt, og hvert nummer du importerer, tilordnes den. Telnyx sender anrop for disse numrene direkte til ThunderPhone over SIP.

• Webhook-feltene er tomme med hensikt. Ingen webhook, Call Control- applikasjon, TeXML-applikasjon eller registrert SIP-telefon er involvert.
• Ikke flytt importerte numre til en annen tilkobling eller applikasjon, og ikke registrer en enhet mot den.
• Hvis du oppga din egen Connection ID da du koblet til, bruker ThunderPhone den tilkoblingen i stedet og endrer den aldri; den må være en FQDN- tilkobling som peker til ThunderPhones SIP-endepunkt.

Før 30. august 2026 var thunderphone-…-tilkoblingen ThunderPhone opprettet en Credential-tilkobling, som ikke kan motta anrop. Hvis din fortsatt vises som en Credential-tilkobling, kontakt kundestøtte, så konverterer vi den.

Manuell SIP-konfigurasjon#

SignalWire-, Vonage- og Plivo-flisene åpner dette skjemaet, det samme gjør Jeg legger inn alle innstillingene selv under Annen leverandør. Alle SIP-trunker fungerer, inkludert DIDWW eller en PBX du kjører selv. Oppgi tilkoblingsnavn, SIP-domene / URI, valgfritt brukernavn og passord, port og transport; Avanserte innstillinger legger til mediekryptering (SRTP). Skjemaet viser også SIP- adressen trunk-en din må sende innkommende anrop til: sip.thunderphone.com, på port 5060 for UDP eller TCP, eller 5061 for TLS. Med TLS forblir SIP- signaleringen kryptert hele veien til LiveKit Cloud, der ThunderPhone håndterer anropet; lyd går aldri gjennom sip.thunderphone.com, så SRTP fungerer som før. Adresser hvert anrop til det oppringte nummeret i E.164-format, med samme nummer, inkludert +, både i forespørselslinjen og To-headeren: for eksempel sip:+14155550142@sip.thunderphone.com. + gjør det mulig for ThunderPhone å håndtere anropet i riktig region (se merknaden under IP-tillatelser). Trunker som tidligere er satt opp med en <your-project>.sip.livekit.cloud- adresse, fortsetter å fungere så lenge Tillatte kilde-IP-adresser er tomt; du trenger ikke endre dem. ThunderPhone gjør disse innstillingene om til et dedikert par SIP-trunker i LiveKit Cloud: utgående anrop fra tilkoblingens numre plasseres til SIP-domenet ditt med påloggingsopplysningene dine, og innkommende anrop til disse numrene godtas fra enhver adresse med mindre du fyller ut det valgfrie feltet Tillatte kilde-IP-adresser. Fyll det bare ut hvis operatøren din publiserer faste signalerings-IP-adresser: En feil eller ufullstendig liste gjør at ThunderPhone avviser operatørens innkommende anrop. To knapper gjør mesteparten av arbeidet:

• Generer AI-oppsettveiledning — skriver leverandørspesifikke instruksjoner for trunkkonfigurasjonen du trenger.
• Test og lagre tilkobling — kontrollerer at SIP-endepunktet løses til en offentlig adresse og, for TCP/TLS, godtar en tilkobling på den valgte porten (UDP-verter får bare DNS-kontrollen), og lagrer deretter. Den kan ikke foreta et anrop ennå fordi tilkoblingen ikke har noen numre; den reelle bekreftelsen kommer ved import (nedenfor).

Når du redigerer en tilkobling senere, kjører den samme kontrollen på nytt for de endrede innstillingene dine før noe lagres, bygger deretter trunk-en på nytt og verifiserer hvert nummer i tilkoblingen på nytt med et kort testanrop i bakgrunnen — numrene vises som Klargjøring til testanropet deres lykkes. Å bare endre Tillatte kilde-IP-adresser på en Tilkoblet tilkobling er annerledes: Det påvirker aldri utgående anrop, så ThunderPhone oppdaterer listen på den innkommende trunk-en umiddelbart, og numrene forblir Aktiv. Testen av innkommende anrop tilbakestilles til ikke testet; kjør den på nytt, eller foreta et faktisk anrop via operatøren din, for å bekrefte at den nye listen slipper anrop inn. Testen mislykkes når anropet ville blitt avvist av listen. Lagrede passord vises aldri igjen; la passordet stå tomt for å beholde det, eller huk av for "Fjern det lagrede passordet" for en IP-autentisert trunk.

IP-tillating og trunkautentisering#

Noen operatører (DIDWW, Telnyx-tilkoblinger med IP-autentisering, de fleste PBX-er bak en brannmur) godtar bare SIP-trafikk fra adresser du har tillatt, eller autentiserer utgående samtaler etter kilde-IP. ThunderPhone bruker to sett med adresser.

SIP-edge. Innkommende samtaler du sender til sip.thunderphone.com, går via ThunderPhones SIP-edge, som kun håndterer SIP-signalering. Den første INVITE-en går til sip.thunderphone.com; resten av samtalens signalering (ACK, avslutning, overføringer) går mellom operatøren din og edge-serveren som tok imot samtalen, sip-1 eller sip-2. Hvis brannmuren din filtrerer SIP-signalering, tillater du alle tre på UDP- og TCP-port 5060 og TLS-port 5061:

LiveKit Cloud. Lyden (RTP) i hver samtale, og SIP-signaleringen for utgående samtaler, går mellom operatøren din og LiveKit Cloud, aldri via SIP-edgen. Tillat alle områdene nedenfor, for både SIP- signalering og medier:

LiveKit bruker disse områdene for Realtime, SIP-signalering og media samt Webhooks, og de dekker anrop som håndteres i regionene Canada, EU, India, Japan og USA. Regionsnavn for et festet endepunkt: canada, eu, india, japan, us.

Noen tommelfingerregler for selve trunken:

• ThunderPhone registrerer seg ikke. Den sender aldri SIP REGISTER til operatøren din, så konfigurer trunken for IP-basert og/eller autentisering med påloggingsopplysninger (brukernavn + passord), ikke registrering.
• Utgående samtaler bør bruke påloggingsopplysninger. Aktiver autentisering med brukernavn/passord hos operatøren, og angi de samme verdiene i det manuelle SIP-skjemaet. Behandle IP-tillatelseslisten som et ekstra lag, ikke det eneste — utgående samtaler til destinasjoner utenfor de dekkede regionene kan komme fra andre adresser.
• Innkommende samtaler går motsatt vei. Det valgfrie feltet Tillatte kilde- IP-er i skjemaet er der du angir signaleringsadressene til operatøren din, slik at ThunderPhone bare godtar samtaler fra dem. Angi IP- adresser eller CIDR-områder; vertsnavn samsvarer aldri. La feltet stå tomt med mindre operatøren din publiserer en fast liste. ThunderPhone kontrollerer listen for hver innkommende samtale mot adressen SIP-edgen ser, så når listen er angitt, sender du samtaler til sip.thunderphone.com. En samtale fra en adresse som ikke står på listen, eller en som sendes direkte til en <your-project>.sip.livekit.cloud-adresse, avvises: den mislykkes eller kobles opp og avsluttes umiddelbart.

Områdene publiseres av LiveKit på Regioner, regionale endepunkter og statiske IP-adresser; ThunderPhone kontrollerer denne siden ukentlig og oppdaterer denne veiledningen når den endres.

Etter tilkobling#

Importer numre fra Telefonnumre → Legg til nummer → Koble til VoIP-leverandør (eller direkte fra tilkoblingen). Hvert importerte nummer verifiseres før det aktiveres. For en manuell SIP-tilkobling foretar verifiseringen et kort testanrop (på noen sekunder) fra nummeret ditt, gjennom SIP-trunken din, til et ThunderPhone-nummer — slik at brukernavn, passord, transport og operatørens utgående ruting faktisk testes. Operatøren din fakturerer dette anropet som ethvert annet anrop. Hvis operatøren avviser det, forblir nummeret i Klargjøring, og siden for telefonnumre viser operatørens svar (for eksempel «rejected ThunderPhone's credentials (SIP 401)»); rett opp tilkoblingen og verifiser på nytt. Hvis operatøren godtar trunken, men rutingplanen ikke dekker ThunderPhones testnummer (DIDWW svarer «Destination number blacklisted by routing plan»), vises nummeret som Verifisert · operatør godtok: det kan brukes, men anrop til andre destinasjoner ble ikke testet. Dette anropet beviser at trunken din kan ringe ut med nummeret; det beviser ikke at du eier nummeret, og det tester ikke anrop til nummeret. Den valgfrie testen for innkommende anrop nedenfor gjør det. Verifiserte numre støtter innkommende og utgående anrop — noe som åpner for utgående kampanjer og programmatisk utgående anrop.

Test av innkommende anrop#

Bekreft nummer åpner en dialog som også kan teste innkommende anrop. Testen ringer nummeret ditt, kontrollerer at anropet når ThunderPhone, og legger deretter på uten å starte stemmeagenten din:

• Numre med egen utgående SIP-trunk (manuelle SIP-numre og Twilio-numre etter at ThunderPhone har satt opp utgående anrop i Twilio-kontoen din) ringer først seg selv: ThunderPhone ringer nummeret fra nummeret, gjennom denne trunk-en. Dialogen forteller deg dette før anropet foretas. Anropet går ut via operatøren din og kommer, hvis den innkommende rutingen er riktig, rett tilbake til ThunderPhone. Når det kommer tilbake med nummerets egen anrops-ID, beviser dette ene anropet både at operatøren din godtar ThunderPhones anrop som nummeret, og at anrop til nummeret når ThunderPhone, i alle land. Enkelte operatører avviser eller kobler ikke opp et anrop fra et nummer til seg selv; det sier ingenting om rutingen din, så ThunderPhone ringer i stedet fra ett av sine egne numre. Hvis nummeret ditt videresendes et annet sted, kan den telefonen ringe to ganger: først med nummerets egen anrops-ID, deretter ThunderPhones testnummer.
• Andre numre (og reservealternativet over) ringes fra ett av ThunderPhones egne numre. ThunderPhone kan foreløpig bare foreta disse anropene til amerikanske og kanadiske numre; for andre numre rapporterer testen at den ikke kunne kjøres, med operatørens svar dersom selvoppringingen ble avvist.

Hvis operatøren din endrer anrops-ID-en underveis, kan ikke ThunderPhone gjenkjenne anropet, så stemmeagenten din kan svare på det et øyeblikk. Testen av innkommende anrop er valgfri. Hopp over den, så fungerer nummeret fortsatt; siden for telefonnumre viser da Innkommende ikke testet, og du kan kjøre den senere med Test eller menyelementet Test innkommende anrop for nummeret. Rett etter en import ber siden for telefonnumre deg også om å teste innkommende anrop på de nye numrene. Ingenting ringes opp før du bekrefter i dialogen.

Hvis leverandøren din videresender nummeret et annet sted, kan det nummeret peker på ringe i opptil 8 sekunder per anrop før ThunderPhone legger på. Hvis noe svarer først (en Twilio-app som svarer og deretter videresender, en telefonmeny), venter testen på at det videresendte anropet skal nå ThunderPhone: opptil 8 sekunder ved selvoppringing og 15 sekunder ved et anrop fra et ThunderPhone-nummer. Resultatet blir stående på nummeret (Innkommende bestått eller mislykket) til du endrer tilkoblingen eller importerer nummeret på nytt, noe som tilbakestiller det til ikke testet. Å endre en tilkobling bekrefter utgående anrop på nytt i bakgrunnen, men ringer aldri nummeret ditt uten at du blir spurt.

Feilsøking av innkommende samtaler#

Tilkoblingens Test-knapp kontrollerer påloggingsopplysninger, og verifisering kontrollerer utgående oppringing. For å kontrollere innkommende samtaler kjører du testen for innkommende samtaler ovenfor, eller ringer nummeret fra en telefon og ser etter samtalen i Anropshistorikk. Talk-tester i nettleseren og bot-til-bot-simuleringer går ikke via operatøren din, så de viser ikke om innkommende samtaler fungerer. En simulering som er rettet mot telefonnummeret (SIP-loopback), ringer det via operatøren din, så en besvart simulering tester innkommende ruting.

• Du hører en melding fra mobiloperatøren din (for eksempel «Velkommen til Verizon» eller «nummeret du har ringt, er ikke i bruk»): samtalen mislyktes før den nådde ThunderPhone. Kontroller at nummeret er aktivt i leverandørkontoen din og tilordnet ThunderPhone- tilkoblingen eller -trunken.
• Opptattsignal eller samtalen ringer ut: leverandøren godtok samtalen, men kunne ikke levere den. Med Telnyx kontrollerer du nummerets Tilkobling i Telnyx-portalen: den skal være FQDN-tilkoblingen thunderphone-… som er beskrevet ovenfor, eller din egen FQDN- tilkobling som peker til ThunderPhone SIP-endepunktet. Med Twilio skal nummeret være knyttet til ThunderPhone SIP-trunken i stedet for en Voice-webhook eller TwiML-app.
• Operatørloggene dine viser 404 No trunk found (manuell SIP): samtalen nådde ThunderPhone, men samsvarte ikke med noen trunk. Kontroller at nummeret er importert på denne tilkoblingen, og at trunken peker til sip.thunderphone.com. Hvis den peker til en <your-project>.sip.livekit.cloud-adresse, må Tillatte kilde-IP-adresser være tomme: når en liste er angitt, godtas bare samtaler sendt til sip.thunderphone.com.
• 404 Not Found fra sip.thunderphone.com (manuell SIP): samtalen var ikke adressert til et telefonnummer, eller forespørselslinjen og To-headeren angir forskjellige numre. Send det oppringte nummeret i begge, som ovenfor.
• 403 Forbidden fra sip.thunderphone.com: forespørselslinjen angir en annen vert. Adresser samtalen til sip.thunderphone.com, for eksempel sip:+14155550142@sip.thunderphone.com.
• Samtalen når ThunderPhone, men feil agent svarer, eller ingen svarer: kontroller nummerets agent for innkommende samtaler under Telefonnumre.

Copiloten i appen kan kontrollere et nummer for deg: spør hvorfor samtaler til nummeret mislykkes. For Telnyx-tilkoblinger slår den også opp, skrivebeskyttet og for organisasjonsadministratorer, hvilken tilkobling Telnyx tilordner nummeret til.

Neste trinn#