Collega un provider VoIP

Collega un provider che già utilizzi (Twilio o Telnyx tramite chiave API; SignalWire, Vonage, Plivo o qualsiasi trunk SIP tramite SIP), oppure apri un nuovo account Telnyx con una configurazione guidata.

Il traffico di produzione deve passare su numeri di tua proprietà tramite il tuo provider VoIP. La pagina Connessioni → VoIP della dashboard (/dashboard/voip-connections) collega il tuo account del provider; una volta collegato, puoi importare numeri che supportano chiamate in entrata e in uscita.

Fai clic su Nuova connessione e scegli una delle due opzioni: Connetti un provider che già utilizzi oppure Configura un nuovo account Telnyx.

Connetti un provider che utilizzi già#

Scegli il provider presso cui sono attivi i tuoi numeri:

Per Twilio e Telnyx, incolla le credenziali e fai clic su Connetti e testa. ThunderPhone le verifica e configura il lato provider per te. Per Telnyx, ThunderPhone aggiunge una propria connessione SIP al tuo account Telnyx (denominata thunderphone-production-<org>-outbound-<id>) ed effettua le chiamate in uscita tramite questa connessione, quindi Telnyx ti fattura tali chiamate. Utilizza il profilo vocale in uscita della connessione Telnyx a cui sono associati i tuoi numeri, pertanto vengono applicati i paesi consentiti e i limiti di spesa di quel profilo. Se quella connessione non ha un profilo vocale in uscita e il tuo account ha esattamente un profilo abilitato, ThunderPhone utilizza quest'ultimo. Per utilizzarne un altro, assegnalo alla connessione nel portale Telnyx e salva nuovamente la connessione ThunderPhone. Se l'account non ha profili abilitati, o ne ha diversi, assegnane uno alla connessione nel portale Telnyx e salva nuovamente la connessione ThunderPhone. Fino ad allora, le chiamate in uscita non riescono con outbound_trunk_unavailable; le chiamate in entrata continuano a funzionare.

Quando Telnyx rifiuta una chiamata in uscita (ad esempio SIP 403 Forbidden), il rifiuto proviene dal tuo account Telnyx. Le cause più comuni sono l'assenza di credito disponibile, un numero chiamante che non appartiene a quell'account Telnyx, oppure un profilo vocale in uscita che non consente il paese di destinazione.

Configurazione SIP per SignalWire, Vonage e Plivo#

Questi tre aprono il modulo SIP manuale con i passaggi per quel provider nella parte superiore, un link alla guida di configurazione del provider e un esempio di dominio SIP:

• SignalWire: crea credenziali SIP per le chiamate in uscita, inserisci il dominio SIP, il nome utente e la password, quindi assegna a ciascun numero un copione SWML che connette le chiamate in entrata all'endpoint SIP di ThunderPhone.
• Vonage: nel dashboard SIP Trunking, crea un trunk con credenziali in uscita, inserisci il relativo dominio (ad esempio your-trunk.sip-us.vonage.com) e le credenziali, aggiungi l'endpoint SIP di ThunderPhone come URI SIP in entrata del trunk e collega i tuoi numeri al trunk.
• Plivo: crea un trunk in uscita con una credenziale e inserisci il relativo dominio SIP di terminazione (<trunk-id>.zt.plivo.com), nome utente e password; crea un trunk in entrata il cui URI primario sia l'endpoint SIP di ThunderPhone seguito da ;transport=tcp; quindi imposta il tipo di applicazione di ciascun numero su quel trunk.

Il risultato è una connessione SIP manuale (provider: "manual" nell' API), testata e verificata esattamente come una inserita manualmente. La scheda della connessione mostra il nome del provider, ad esempio SignalWire · SIP.

Configura un nuovo account Telnyx#

Non hai ancora un provider? Il flusso guidato ti accompagna nella creazione di un account Telnyx e nella sua connessione:

1. Crea l'account

   Fai clic su Apri la registrazione a Telnyx, crea il tuo account e seleziona "Ho creato il mio account."

2. Ottieni una chiave API

   Fai clic su Apri la pagina delle chiavi API, genera una chiave e incollala in Chiave API (v2). Facoltativamente, assegna un nome alla connessione.

3. Connetti e testa

   Fai clic su Connetti e testa — ThunderPhone verifica le credenziali e configura ciò di cui ha bisogno sul lato Telnyx prima di salvare.

Cosa configura ThunderPhone in Telnyx#

A meno che tu non inserisca il tuo ID connessione, entrambe le procedure Telnyx (la configurazione guidata e l'inserimento di una chiave API) lasciano la stessa configurazione nel tuo account Telnyx: una connessione SIP denominata thunderphone-<your organization id>. È una connessione FQDN il cui record FQDN punta all'endpoint SIP di ThunderPhone e a cui viene assegnato ogni numero importato. Telnyx invia le chiamate per quei numeri direttamente a ThunderPhone tramite SIP.

• I suoi campi webhook sono intenzionalmente vuoti. Non sono coinvolti webhook, applicazioni Call Control, applicazioni TeXML né telefoni SIP registrati.
• Non spostare i numeri importati a un'altra connessione o applicazione e non registrare un dispositivo su di essa.
• Se hai inserito il tuo ID connessione durante il collegamento, ThunderPhone usa invece quella connessione e non la modifica mai; deve essere una connessione FQDN che punta all'endpoint SIP di ThunderPhone.

Prima del 30 agosto 2026, la connessione thunderphone-… creata da ThunderPhone era una connessione Credential, che non può ricevere chiamate. Se la tua risulta ancora una connessione Credential, contatta l'assistenza e la convertiremo.

Configurazione SIP manuale#

I riquadri SignalWire, Vonage e Plivo aprono questo modulo, così come Inserirò personalmente tutte le impostazioni in Altro provider. Qualsiasi trunk SIP funziona, incluso DIDWW o un PBX gestito da te. Inserisci il nome della connessione, il dominio / URI SIP, nome utente e password facoltativi, porta e trasporto; Impostazioni avanzate aggiunge la crittografia dei contenuti multimediali (SRTP). Il modulo mostra anche l'indirizzo SIP a cui il trunk deve inviare le chiamate in entrata: sip.thunderphone.com, sulla porta 5060 per UDP o TCP oppure 5061 per TLS. Con TLS, la segnalazione SIP rimane crittografata fino a LiveKit Cloud, dove ThunderPhone gestisce la chiamata; l'audio non passa mai attraverso sip.thunderphone.com, quindi SRTP continua a funzionare come prima. Indirizza ogni chiamata al numero composto nel formato E.164, usando lo stesso numero, incluso il +, sia nella riga della richiesta sia nell'intestazione To: ad esempio sip:+14155550142@sip.thunderphone.com. Il + consente a ThunderPhone di gestire la chiamata nella regione corretta (vedi la nota in Allowlisting IP). I trunk configurati in precedenza con un indirizzo <your-project>.sip.livekit.cloud continuano a funzionare finché IP di origine consentiti è vuoto; non devi modificarli. ThunderPhone trasforma queste impostazioni in una coppia dedicata di trunk SIP su LiveKit Cloud: le chiamate in uscita dai numeri della connessione vengono effettuate verso il tuo dominio SIP con le tue credenziali, mentre le chiamate in entrata verso tali numeri sono accettate da qualsiasi indirizzo, a meno che tu non compili il campo facoltativo IP di origine consentiti. Compilalo solo se il tuo operatore pubblica IP fissi per la segnalazione: un elenco errato o incompleto fa sì che ThunderPhone rifiuti le chiamate in entrata del tuo operatore. Due pulsanti gestiscono la parte principale della configurazione:

• Genera guida di configurazione IA — crea istruzioni specifiche per il provider relative alla configurazione del trunk necessaria.
• Testa e salva connessione — verifica che l'endpoint SIP si risolva in un indirizzo pubblico e che, per TCP/TLS, accetti una connessione sulla porta selezionata (gli host UDP ricevono solo il controllo DNS), quindi salva. Non può ancora effettuare una chiamata perché la connessione non dispone di numeri; la verifica effettiva avviene al momento dell'importazione (di seguito).

La modifica successiva di una connessione riesegue lo stesso controllo sulle impostazioni modificate prima di salvare qualsiasi modifica, quindi ricrea il trunk e riverifica ogni numero della connessione con una breve chiamata di test in background — i numeri sono visualizzati come Provisioning finché la chiamata di test non riesce. Modificare solo IP di origine consentiti in una connessione Connessa è diverso: non influisce mai sulle chiamate in uscita, quindi ThunderPhone aggiorna subito l'elenco sul trunk in entrata e i numeri rimangono Attivi. Il test delle chiamate in entrata viene reimpostato su non testato; eseguilo di nuovo oppure effettua una chiamata reale tramite il tuo operatore per confermare che il nuovo elenco consenta l'ingresso delle chiamate. Il test non riesce se la sua chiamata verrebbe rifiutata in base all'elenco. Le password memorizzate non vengono mai mostrate nuovamente; lascia vuoto il campo della password per conservarla oppure seleziona "Rimuovi la password memorizzata" per un trunk autenticato tramite IP.

Allowlist IP e autenticazione del trunk#

Alcuni operatori (DIDWW, connessioni Telnyx con autenticazione IP, la maggior parte dei PBX dietro un firewall) accettano traffico SIP solo da indirizzi inclusi nella lista di autorizzazione oppure autenticano le chiamate in uscita tramite IP di origine. ThunderPhone utilizza due gruppi di indirizzi.

Edge SIP. Le chiamate in entrata inviate a sip.thunderphone.com passano attraverso l'edge SIP di ThunderPhone, che trasporta solo la segnalazione SIP. Il primo INVITE va a sip.thunderphone.com; il resto della segnalazione della chiamata (ACK, chiusura, trasferimenti) avviene tra il tuo operatore e il server edge che ha ricevuto la chiamata, sip-1 o sip-2. Se il firewall filtra la segnalazione SIP, consenti tutti e tre gli indirizzi sulle porte UDP e TCP 5060 e sulla porta TLS 5061:

LiveKit Cloud. L'audio (RTP) di ogni chiamata e la segnalazione SIP delle chiamate in uscita passano tra il tuo operatore e LiveKit Cloud, mai attraverso l'edge SIP. Consenti tutti gli intervalli seguenti, sia per la segnalazione SIP sia per i contenuti multimediali:

LiveKit applica questi intervalli a Realtime, alla segnalazione SIP, ai contenuti multimediali e ai webhook; coprono inoltre le chiamate gestite nelle sue regioni Canada, UE, India, Giappone e Stati Uniti. Nomi delle regioni per un endpoint vincolato: canada, eu, india, japan, us.

Alcune regole pratiche per il trunk:

• ThunderPhone non si registra. Non invia mai SIP REGISTER al tuo operatore, quindi configura il trunk per l'autenticazione basata su IP e/o credenziali (nome utente + password), non per la registrazione.
• Le chiamate in uscita devono usare le credenziali. Abilita l'autenticazione con nome utente/password lato operatore e inserisci gli stessi valori nel modulo SIP manuale. Considera la lista di autorizzazione IP come un secondo livello, non l'unico: le chiamate in uscita verso destinazioni fuori dalle regioni coperte possono provenire da altri indirizzi.
• L'entrata è nella direzione opposta. Il campo facoltativo IP sorgente consentiti nel modulo è dove inserisci gli indirizzi di segnalazione del tuo operatore affinché ThunderPhone accetti chiamate solo da tali indirizzi. Inserisci indirizzi IP o intervalli CIDR; i nomi host non corrispondono mai. Lascialo vuoto salvo che il tuo operatore pubblichi un elenco fisso. ThunderPhone verifica l'elenco a ogni chiamata in entrata rispetto all'indirizzo rilevato dal suo edge SIP, quindi, una volta impostato l'elenco, invia le chiamate a sip.thunderphone.com. Una chiamata da un indirizzo non presente nell'elenco, oppure inviata direttamente a un indirizzo <your-project>.sip.livekit.cloud, viene rifiutata: non riesce oppure si connette e termina immediatamente.

Gli intervalli sono pubblicati da LiveKit in Regioni, endpoint regionali e IP statici; ThunderPhone controlla questa pagina settimanalmente e aggiorna questa guida quando cambia.

Dopo la connessione#

Importa numeri da Numeri di telefono → Aggiungi numero → Connetti provider VoIP (oppure direttamente dalla connessione). Ogni numero importato viene verificato prima di diventare attivo. Per una connessione SIP manuale, la verifica effettua una breve chiamata di test (di pochi secondi) dal tuo numero, tramite il tuo trunk SIP, a un numero ThunderPhone — in questo modo vengono effettivamente testati nome utente, password, trasporto e instradamento in uscita del tuo operatore. Il tuo operatore fattura questa chiamata come qualsiasi altra. Se l'operatore la rifiuta, il numero rimane in Provisioning e la pagina dei numeri di telefono mostra la risposta dell'operatore (ad esempio "credenziali ThunderPhone rifiutate (SIP 401)"); correggi la connessione e verifica di nuovo. Se il tuo operatore accetta il trunk ma il suo piano di instradamento non copre il numero di test di ThunderPhone (DIDWW risponde "Numero di destinazione nella blacklist del piano di instradamento"), il numero viene visualizzato come Verified · carrier accepted: è utilizzabile, ma le chiamate verso altre destinazioni non sono state testate. Questa chiamata dimostra che il tuo trunk può effettuare chiamate usando il numero; non dimostra che possiedi il numero e non verifica le chiamate verso il numero; lo fa invece il test opzionale delle chiamate in entrata riportato di seguito. I numeri verificati supportano chiamate in entrata e in uscita, sbloccando le campagne in uscita e le chiamate in uscita programmatiche.

Test delle chiamate in entrata#

Verifica numero apre una finestra di dialogo che può anche testare le chiamate in entrata. Il test effettua una chiamata al tuo numero, verifica che la chiamata raggiunga ThunderPhone, quindi riaggancia senza avviare il tuo agente:

• Numeri con il proprio trunk SIP in uscita (numeri SIP manuali e numeri Twilio dopo che ThunderPhone ha configurato le chiamate in uscita nel tuo account Twilio) chiamano prima sé stessi: ThunderPhone compone il numero dal numero, tramite quel trunk. La finestra di dialogo ti avvisa prima di effettuare la chiamata. La chiamata esce tramite il tuo operatore e, se il routing in entrata è corretto, torna direttamente a ThunderPhone. Quando torna con l'ID chiamante del numero stesso, quella chiamata dimostra sia che il tuo operatore accetta le chiamate di ThunderPhone come provenienti dal numero sia che le chiamate al numero raggiungono ThunderPhone, in qualsiasi Paese. Alcuni operatori rifiutano o non collegano una chiamata da un numero a sé stesso; questo non indica nulla sul tuo routing, quindi ThunderPhone chiama invece da uno dei propri numeri. Se il tuo numero inoltra a un'altra destinazione, quel telefono potrebbe squillare due volte: prima mostrando l'ID chiamante del numero stesso, poi il numero di test di ThunderPhone.
• Altri numeri (e l'alternativa descritta sopra) vengono chiamati da uno dei numeri di ThunderPhone. Per ora ThunderPhone può effettuare queste chiamate solo verso numeri statunitensi e canadesi; per gli altri numeri il test indica che non è stato possibile eseguirlo, includendo la risposta del tuo operatore se la chiamata a sé stesso è stata rifiutata.

Se il tuo operatore modifica l'ID chiamante durante il percorso, ThunderPhone non può riconoscere la chiamata, quindi il tuo agente potrebbe rispondere per un momento. Il test in entrata è facoltativo. Saltalo e il numero continuerà a funzionare; la pagina dei numeri di telefono mostrerà Chiamate in entrata non testate e potrai eseguirlo in seguito con Test o con la voce di menu Test chiamate in entrata del numero. Subito dopo un'importazione, la pagina dei numeri di telefono ti chiede anche di testare le chiamate in entrata sui nuovi numeri. Non viene composto nulla finché non confermi nella finestra di dialogo.

Se il tuo provider invia il numero altrove, qualunque destinazione indichi può squillare fino a 8 secondi per chiamata prima che ThunderPhone riagganci. Se qualcosa risponde prima (un'app Twilio che risponde e poi inoltra, un menu telefonico), il test attende che la chiamata inoltrata raggiunga ThunderPhone: fino a 8 secondi nella chiamata a sé stesso e 15 secondi in una chiamata da un numero ThunderPhone. Il risultato resta associato al numero (In entrata superato o non superato) finché non modifichi la connessione o non reimporti il numero, operazione che lo reimposta a non testato. La modifica di una connessione riverifica le chiamate in uscita in background, ma non chiama mai il tuo numero senza che tu lo richieda.

Risoluzione dei problemi relativi alle chiamate in entrata#

Il pulsante Test della connessione verifica le credenziali e la verifica controlla le chiamate in uscita. Per controllare le chiamate in entrata, esegui il test delle chiamate in arrivo sopra oppure chiama il numero da un telefono e cerca la chiamata in Cronologia chiamate. I test Parla nel browser e le simulazioni da bot a bot non passano dal tuo operatore, quindi non mostrano se le chiamate in entrata funzionano. Una simulazione che ha come destinazione il numero di telefono (loopback SIP) lo chiama tramite il tuo operatore, quindi una risposta verifica effettivamente l'instradamento delle chiamate in entrata.

• Senti il messaggio del tuo operatore mobile (ad esempio "Benvenuto in Verizon" o "il numero selezionato non è attivo"): la chiamata non è riuscita prima di raggiungere ThunderPhone. Verifica che il numero sia attivo nel tuo account del provider e assegnato alla connessione o al trunk ThunderPhone.
• Segnale di occupato o la chiamata squilla senza risposta: il provider ha accettato la chiamata ma non è riuscito a recapitarla. Con Telnyx, controlla la Connessione del numero nel portale Telnyx: deve essere la connessione FQDN thunderphone-… descritta sopra oppure una tua connessione FQDN che punta all'endpoint SIP ThunderPhone. Con Twilio, il numero deve essere collegato al trunk SIP ThunderPhone anziché a un webhook Voice o a un'app TwiML.
• I log del tuo operatore mostrano 404 No trunk found (SIP manuale): la chiamata ha raggiunto ThunderPhone ma non ha trovato alcun trunk corrispondente. Verifica che il numero sia importato in questa connessione e che il trunk punti a sip.thunderphone.com. Se punta a un indirizzo <your-project>.sip.livekit.cloud, IP di origine consentiti deve essere vuoto: se è impostato un elenco, vengono accettate solo le chiamate inviate a sip.thunderphone.com.
• 404 Not Found da sip.thunderphone.com (SIP manuale): la chiamata non era indirizzata a un numero di telefono oppure la riga della richiesta e l'intestazione To indicano numeri diversi. Invia il numero chiamato in entrambi, come sopra.
• 403 Forbidden da sip.thunderphone.com: la riga della richiesta indica un altro host. Indirizza la chiamata a sip.thunderphone.com, ad esempio sip:+14155550142@sip.thunderphone.com.
• La chiamata raggiunge ThunderPhone ma risponde l'agente sbagliato, oppure non risponde nessuno: controlla l'agente per le chiamate in entrata del numero in Numeri di telefono.

Il copilota nell'app può controllare un numero per te: chiedigli perché le chiamate verso il numero non riescono. Per le connessioni Telnyx, controlla anche, in sola lettura e per gli amministratori dell'organizzazione, a quale connessione Telnyx assegna il numero.

Passaggi successivi#