Conectați un furnizor VoIP

Conectați un furnizor pe care îl utilizați deja (Twilio sau Telnyx prin cheie API; SignalWire, Vonage, Plivo sau orice trunk SIP prin SIP) sau deschideți un cont Telnyx nou cu configurare ghidată.

Traficul de producție ar trebui să ruleze pe numere pe care le dețineți, prin propriul furnizor VoIP. Pagina Connections → VoIP din tabloul de bord (/dashboard/voip-connections) vă conectează contul de furnizor; după conectare, importați numere care acceptă apeluri de intrare și de ieșire.

Faceți clic pe Conexiune nouă și alegeți una dintre cele două opțiuni: Conectați un furnizor pe care îl utilizați deja sau Configurați un cont Telnyx nou.

Conectați un furnizor pe care îl utilizați deja#

Alegeți furnizorul la care aveți numerele:

Pentru Twilio și Telnyx, lipiți datele de autentificare și faceți clic pe Conectați și testați. ThunderPhone le verifică și configurează partea furnizorului pentru dumneavoastră. Pentru Telnyx, ThunderPhone adaugă o conexiune SIP proprie la contul dumneavoastră Telnyx (denumită thunderphone-production-<org>-outbound-<id>) și efectuează apeluri efectuate prin aceasta, astfel încât Telnyx vă facturează acele apeluri. Utilizează profilul vocal pentru apeluri efectuate al conexiunii Telnyx la care sunt asociate numerele dumneavoastră, astfel încât se aplică țările permise și limitele de cheltuieli ale acelui profil. Dacă acea conexiune nu are un profil vocal pentru apeluri efectuate, iar contul dumneavoastră are exact un profil activat, ThunderPhone îl utilizează pe acela. Pentru a utiliza altul, atribuiți-l conexiunii în portalul Telnyx și salvați din nou conexiunea ThunderPhone. Dacă contul nu are niciun profil activat sau are mai multe, atribuiți unul conexiunii în portalul Telnyx și salvați din nou conexiunea ThunderPhone. Până atunci, apelurile efectuate eșuează cu outbound_trunk_unavailable; apelurile primite continuă să funcționeze.

Când Telnyx refuză un apel efectuat (de exemplu SIP 403 Forbidden), refuzul provine din propriul dumneavoastră cont Telnyx. Cauzele obișnuite sunt lipsa creditului disponibil, un număr de apelant care nu se află în acel cont Telnyx sau un profil vocal pentru apeluri efectuate care nu permite țara de destinație.

Configurare SIP pentru SignalWire, Vonage și Plivo#

Aceste trei opțiuni deschid formularul SIP manual, cu pașii pentru furnizorul respectiv în partea de sus, un link către ghidul propriu de configurare al furnizorului și un exemplu de domeniu SIP:

• SignalWire: creați date de autentificare SIP pentru apeluri efectuate, introduceți domeniul SIP, numele de utilizator și parola și atribuiți fiecărui număr un script SWML care conectează apelurile primite la endpointul SIP ThunderPhone.
• Vonage: în tabloul de bord SIP Trunking, creați un trunk cu date de autentificare pentru apeluri efectuate, introduceți domeniul acestuia (de exemplu your-trunk.sip-us.vonage.com) și datele de autentificare, adăugați endpointul SIP ThunderPhone ca URI SIP pentru apeluri primite al trunkului și asociați numerele dumneavoastră cu trunkul.
• Plivo: creați un trunk pentru apeluri efectuate cu date de autentificare și introduceți domeniul SIP de terminare (<trunk-id>.zt.plivo.com), numele de utilizator și parola; creați un trunk pentru apeluri primite al cărui URI principal este endpointul SIP ThunderPhone urmat de ;transport=tcp; apoi setați tipul aplicației fiecărui număr la acel trunk.

Rezultatul este o conexiune SIP manuală (provider: "manual" în API), testată și verificată exact ca una introdusă manual. Cardul conexiunii afișează numele furnizorului, de exemplu SignalWire · SIP.

Configurați un cont Telnyx nou#

Nu aveți încă un furnizor? Fluxul ghidat vă ajută să deschideți un cont Telnyx și să îl conectați:

1. Creați contul

   Faceți clic pe Open Telnyx Signup, creați-vă contul și bifați "I've created my account."

2. Obțineți o cheie API

   Faceți clic pe Open API Keys Page, generați o cheie și lipiți-o în API Key (v2). Opțional, denumiți conexiunea.

3. Conectați și testați

   Faceți clic pe Connect & Test — ThunderPhone verifică datele de autentificare și configurează ce este necesar în Telnyx înainte de salvare.

Ce configurează ThunderPhone în Telnyx#

Cu excepția cazului în care introduceți propriul ID de conexiune, ambele rute Telnyx (configurarea ghidată și lipirea unei chei API) lasă același element în contul dumneavoastră Telnyx: o conexiune SIP numită thunderphone-<your organization id>. Este o conexiune FQDN al cărei înregistrare FQDN indică endpointul SIP ThunderPhone, iar fiecare număr pe care îl importați îi este atribuit. Telnyx trimite apelurile pentru aceste numere direct către ThunderPhone prin SIP.

• Câmpurile sale webhook sunt goale intenționat. Nu este implicat niciun webhook, nicio aplicație Call Control, nicio aplicație TeXML și niciun telefon SIP înregistrat.
• Nu mutați numerele importate la o altă conexiune sau aplicație și nu înregistrați un dispozitiv pentru aceasta.
• Dacă ați introdus propriul ID de conexiune la conectare, ThunderPhone utilizează acea conexiune și nu o modifică niciodată; aceasta trebuie să fie o conexiune FQDN care indică endpointul SIP ThunderPhone.

Înainte de 30 august 2026, conexiunea thunderphone-… creată de ThunderPhone era o conexiune cu acreditări, care nu poate primi apeluri. Dacă a dumneavoastră încă apare ca o conexiune cu acreditări, contactați asistența, iar noi o vom converti.

Configurare manuală SIP#

Cardurile SignalWire, Vonage și Plivo deschid acest formular, la fel ca Voi introduce eu toate setările din Alt furnizor. Funcționează orice trunk SIP, inclusiv DIDWW sau un PBX pe care îl administrați dumneavoastră. Introduceți numele conexiunii, domeniul / URI-ul SIP, numele de utilizator și parola opționale, portul și transportul; Setări avansate adaugă criptarea media (SRTP). Formularul afișează și adresa SIP către care trunkul dumneavoastră trebuie să trimită apelurile de intrare: sip.thunderphone.com, pe portul 5060 pentru UDP sau TCP ori 5061 pentru TLS. Prin TLS, semnalizarea SIP rămâne criptată până la LiveKit Cloud, unde ThunderPhone gestionează apelul; datele audio nu trec niciodată prin sip.thunderphone.com, astfel încât SRTP funcționează ca înainte. Adresați fiecare apel către numărul format în format E.164, cu același număr, inclusiv +, atât în linia de cerere, cât și în antetul To: de exemplu sip:+14155550142@sip.thunderphone.com. Caracterul + permite ThunderPhone să gestioneze apelul în regiunea corectă (consultați nota de la permiterea IP-urilor). Trunkurile configurate anterior cu o adresă <your-project>.sip.livekit.cloud continuă să funcționeze cât timp câmpul IP-uri sursă permise este gol; nu este necesar să le modificați. ThunderPhone transformă aceste setări într-o pereche dedicată de trunkuri SIP în LiveKit Cloud: apelurile de ieșire de la numerele conexiunii sunt plasate către domeniul dumneavoastră SIP folosind datele dumneavoastră de autentificare, iar apelurile de intrare către acele numere sunt acceptate de la orice adresă, cu excepția cazului în care completați câmpul opțional IP-uri sursă permise. Completați-l numai dacă operatorul dumneavoastră publică IP-uri fixe de semnalizare: o listă greșită sau incompletă face ca ThunderPhone să respingă apelurile de intrare ale operatorului dumneavoastră. Două butoane efectuează operațiunile principale:

• Generați ghidul de configurare AI — creează instrucțiuni specifice furnizorului pentru configurația necesară pe partea trunchiului.
• Testați și salvați conexiunea — verifică dacă endpointul SIP se rezolvă către o adresă publică și, pentru TCP/TLS, acceptă o conexiune pe portul ales (gazdele UDP primesc doar verificarea DNS), apoi salvează. Nu poate iniția încă un apel deoarece conexiunea nu are numere; confirmarea reală apare la import (mai jos).

Editarea ulterioară a unei conexiuni rulează din nou aceeași verificare pentru setările modificate înainte ca orice modificare să fie salvată, apoi reconstruiește trunkul și reverifică fiecare număr din conexiune cu un apel de test scurt în fundal — numerele apar ca În curs de configurare până când apelul lor de test reușește. Modificarea numai a câmpului IP-uri sursă permise pentru o conexiune Conectată este diferită: nu afectează niciodată apelurile de ieșire, astfel încât ThunderPhone actualizează imediat lista pe trunkul de intrare, iar numerele rămân Active. Testul lor pentru apeluri de intrare este resetat la netestat; rulați-l din nou sau efectuați un apel real prin operatorul dumneavoastră pentru a confirma că noua listă permite apelurile. Testul eșuează atunci când apelul său ar fi refuzat conform listei. Parolele stocate nu sunt afișate niciodată; lăsați câmpul parolei gol pentru a o păstra sau bifați „Eliminați parola stocată” pentru un trunk autentificat prin IP.

Permiterea adreselor IP și autentificarea trunchiului#

Unii furnizori (DIDWW, conexiuni Telnyx cu autentificare IP, majoritatea centralelor PBX din spatele unui firewall) acceptă trafic SIP numai de la adrese pe care le includeți într-o listă de permisiuni sau autentifică apelurile de ieșire după IP-ul sursă. ThunderPhone utilizează două seturi de adrese.

Marginea SIP. Apelurile de intrare pe care le trimiteți la sip.thunderphone.com trec prin marginea SIP ThunderPhone, care transportă numai semnalizare SIP. Primul INVITE ajunge la sip.thunderphone.com; restul semnalizării apelului (ACK, închidere, transferuri) are loc între furnizorul dumneavoastră și serverul de margine care a preluat apelul, sip-1 sau sip-2. Dacă firewallul dumneavoastră filtrează semnalizarea SIP, permiteți-le pe toate trei, pe portul UDP și TCP 5060 și pe portul TLS 5061:

LiveKit Cloud. Sunetul (RTP) fiecărui apel și semnalizarea SIP a apelurilor de ieșire circulă între furnizorul dumneavoastră și LiveKit Cloud, niciodată prin marginea SIP. Permiteți fiecare interval de mai jos, atât pentru semnalizarea SIP, cât și pentru media:

LiveKit aplică aceste intervale pentru Realtime, semnalizarea și media SIP, precum și Webhooks, iar acestea acoperă apelurile gestionate în regiunile sale din Canada, UE, India, Japonia și SUA. Numele regiunilor pentru un endpoint fixat: canada, eu, india, japan, us.

Câteva reguli practice pentru trunchiul propriu-zis:

• ThunderPhone nu se înregistrează. Nu trimite niciodată SIP REGISTER către furnizorul dumneavoastră, așadar configurați trunkul pentru autentificare bazată pe IP și/sau acreditări (nume de utilizator + parolă), nu pentru înregistrare.
• Apelurile de ieșire trebuie să utilizeze acreditări. Activați autentificarea cu nume de utilizator/parolă la furnizor și introduceți aceleași valori în formularul SIP manual. Tratați lista de permisiuni IP ca pe un al doilea nivel, nu ca pe singurul nivel — apelurile de ieșire către destinații din afara regiunilor acoperite pot proveni de la alte adrese.
• Intrarea este direcția inversă. Câmpul opțional IP-uri sursă permise din formular este locul în care introduceți adresele de semnalizare ale furnizorului dumneavoastră, astfel încât ThunderPhone să accepte apeluri doar de la acestea. Introduceți adrese IP sau intervale CIDR; numele de gazdă nu se potrivesc niciodată. Lăsați câmpul gol dacă furnizorul dumneavoastră nu publică o listă fixă. ThunderPhone verifică lista pentru fiecare apel de intrare în raport cu adresa pe care o vede marginea sa SIP, astfel încât, după configurarea listei, trimiteți apelurile la sip.thunderphone.com. Un apel de la o adresă care nu este în listă sau unul trimis direct la o adresă <your-project>.sip.livekit.cloud este refuzat: eșuează sau se conectează și se încheie imediat.

Intervalele sunt publicate de LiveKit la Regiuni, endpointuri regionale și IP-uri statice; ThunderPhone verifică acea pagină săptămânal și actualizează acest ghid atunci când se modifică.

După conectare#

Importați numere din Numere de telefon → Adăugați număr → Conectați furnizor VoIP (sau direct din conexiune). Fiecare număr importat este verificat înainte de a deveni activ. Pentru o conexiune SIP manuală, această verificare efectuează un apel de test scurt (de câteva secunde) de la numărul dumneavoastră, prin trunchiul SIP, către un număr ThunderPhone — astfel, numele de utilizator, parola, transportul și rutarea de ieșire a furnizorului dumneavoastră sunt toate testate în condiții reale. Furnizorul dumneavoastră facturează acel apel ca pe oricare altul. Dacă furnizorul îl respinge, numărul rămâne în În curs de configurare, iar pagina cu numere de telefon afișează răspunsul furnizorului (de exemplu, „a respins credențialele ThunderPhone (SIP 401)”); remediați conexiunea și verificați din nou. Dacă furnizorul dumneavoastră acceptă trunchiul, dar planul său de rutare nu acoperă numărul de test ThunderPhone (DIDWW răspunde „Numărul de destinație este blocat de planul de rutare”), numărul apare ca Verificat · furnizor acceptat: poate fi utilizat, dar apelurile către alte destinații nu au fost testate. Acel apel demonstrează că trunchiul dumneavoastră poate iniția apeluri folosind numărul respectiv; nu demonstrează că dețineți numărul și nu testează apelurile către număr; testul opțional pentru apeluri primite de mai jos face acest lucru. Numerele verificate acceptă apeluri primite și efectuate — ceea ce deblochează campaniile de apeluri efectuate și apelurile efectuate programatic.

Test pentru apeluri primite#

Verificare număr deschide un dialog care poate testa și apelurile primite. Testul inițiază un apel către numărul dumneavoastră, verifică dacă apelul ajunge la ThunderPhone, apoi închide apelul fără să pornească agentul vocal:

• Numerele cu propriul trunk SIP de ieșire (numere SIP manuale și numere Twilio după ce ThunderPhone a configurat apelurile de ieșire în contul dumneavoastră Twilio) se apelează mai întâi pe ele însele: ThunderPhone formează numărul de la acel număr, prin trunkul respectiv. Dialogul vă informează înainte de inițierea apelului. Apelul pleacă prin operatorul dumneavoastră și, dacă rutarea apelurilor primite este corectă, revine direct la ThunderPhone. Când revine cu propriul ID apelant al numărului, acel singur apel demonstrează atât că operatorul dumneavoastră acceptă apelurile ThunderPhone prezentate ca fiind de la număr, cât și că apelurile către număr ajung la ThunderPhone, în orice țară. Unii operatori refuză sau nu conectează un apel de la un număr către el însuși; acest lucru nu spune nimic despre rutarea dumneavoastră, astfel încât ThunderPhone apelează apoi de la unul dintre propriile sale numere. Dacă numărul dumneavoastră redirecționează către altundeva, acel telefon poate suna de două ori: mai întâi afișând propriul ID apelant al numărului, apoi numărul de test ThunderPhone.
• Alte numere (și alternativa de mai sus) sunt apelate de la unul dintre propriile numere ThunderPhone. Deocamdată, ThunderPhone poate iniția aceste apeluri numai către numere din SUA și Canada; pentru alte numere, testul raportează că nu a putut rula, împreună cu răspunsul operatorului dumneavoastră dacă apelul către sine a fost refuzat.

Dacă operatorul dumneavoastră modifică ID-ul apelant pe traseu, ThunderPhone nu poate recunoaște apelul, astfel încât agentul vocal îl poate prelua pentru scurt timp. Testul pentru apeluri primite este opțional. Omiteți-l, iar numărul va funcționa în continuare; pagina cu numere de telefon afișează apoi Apeluri primite netestate și îl puteți rula mai târziu cu Test sau cu opțiunea Testează apelurile primite din meniul numărului. Imediat după un import, pagina cu numere de telefon vă solicită și să testați apelurile primite pentru numerele noi. Nu se formează niciun număr până când nu confirmați în dialog.

Dacă furnizorul dumneavoastră trimite numărul în altă parte, orice indică acesta poate suna timp de până la 8 secunde per apel înainte ca ThunderPhone să închidă apelul. Dacă altceva răspunde mai întâi (o aplicație Twilio care răspunde și apoi redirecționează, un meniu telefonic), testul așteaptă ca apelul redirecționat să ajungă la ThunderPhone: până la 8 secunde pentru apelul către sine și 15 secunde pentru un apel de la un număr ThunderPhone. Rezultatul rămâne asociat numărului (Apeluri primite reușit sau eșuat) până când modificați conexiunea sau reimportați numărul, ceea ce îl resetează la netestat. Modificarea unei conexiuni reverifică apelurile de ieșire în fundal, dar nu apelează niciodată numărul dumneavoastră fără solicitare.

Depanarea apelurilor primite#

Butonul Test al conexiunii verifică datele de autentificare, iar verificarea testează apelarea ieșită. Pentru a verifica apelurile primite, rulați testul de apel primit de mai sus sau apelați numărul de pe un telefon și căutați apelul în Istoricul apelurilor. Testele Vorbește din browser și simulările de la agent la agent nu trec prin furnizorul dumneavoastră, așa că nu indică dacă apelurile primite funcționează. O simulare care vizează numărul de telefon (loopback SIP) îl apelează prin furnizorul dumneavoastră, astfel încât o simulare la care se răspunde testează rutarea apelurilor primite.

• Auziți mesajul propriului furnizor de telefonie mobilă (de exemplu „Bun venit la Verizon” sau „numărul apelat nu este în serviciu”): apelul a eșuat înainte de a ajunge la ThunderPhone. Verificați că numărul este activ în contul furnizorului dumneavoastră și alocat conexiunii sau trunkului ThunderPhone.
• Semnal de ocupat sau apelul sună fără răspuns: furnizorul a acceptat apelul, dar nu l-a putut livra. Pentru Telnyx, verificați Conexiunea numărului în portalul Telnyx: aceasta ar trebui să fie conexiunea FQDN thunderphone-… descrisă mai sus sau propria dumneavoastră conexiune FQDN care indică endpointul SIP ThunderPhone. Pentru Twilio, numărul trebuie atașat la trunkul SIP ThunderPhone, nu la un webhook Voice sau la o aplicație TwiML.
• Jurnalele furnizorului dumneavoastră afișează 404 No trunk found (SIP manual): apelul a ajuns la ThunderPhone, dar nu s-a potrivit cu niciun trunk. Verificați că numărul este importat în această conexiune și că trunkul indică sip.thunderphone.com. Dacă indică o adresă <your-project>.sip.livekit.cloud, IP-uri sursă permise trebuie să fie gol: dacă este configurată o listă, sunt acceptate numai apelurile trimise la sip.thunderphone.com.
• 404 Not Found de la sip.thunderphone.com (SIP manual): apelul nu a fost adresat unui număr de telefon sau linia de cerere și antetul To indică numere diferite. Trimiteți numărul apelat în ambele, ca mai sus.
• 403 Forbidden de la sip.thunderphone.com: linia de cerere indică o altă gazdă. Adresați apelul către sip.thunderphone.com, de exemplu sip:+14155550142@sip.thunderphone.com.
• Apelul ajunge la ThunderPhone, dar răspunde agentul greșit sau nu răspunde nimeni: verificați agentul pentru apeluri primite al numărului în Numere de telefon.

Copilotul din aplicație poate verifica un număr pentru dumneavoastră: întrebați-l de ce apelurile către număr eșuează. Pentru conexiunile Telnyx, acesta verifică și, doar pentru citire și pentru administratorii organizației, conexiunea căreia Telnyx îi alocă numărul.

Pașii următori#