Hubungkan provider VoIP

Hubungkan provider yang sudah Anda gunakan (Twilio atau Telnyx dengan kunci API; SignalWire, Vonage, Plivo, atau trunk SIP apa pun melalui SIP), atau buka akun Telnyx baru dengan penyiapan terpandu.

Traffic produksi harus berjalan pada nomor yang Anda miliki melalui operator VoIP Anda sendiri. Halaman Connections → VoIP di dashboard (/dashboard/voip-connections) menghubungkan akun operator Anda; setelah terhubung, Anda dapat mengimpor nomor yang mendukung panggilan masuk dan keluar.

Klik Koneksi baru dan pilih salah satu dari dua opsi: Hubungkan operator yang sudah Anda gunakan, atau Siapkan akun Telnyx baru.

Hubungkan penyedia yang sudah Anda gunakan#

Pilih penyedia tempat nomor Anda berada:

Untuk Twilio dan Telnyx, tempel kredensial lalu klik Hubungkan & Uji. ThunderPhone memverifikasinya dan mengonfigurasi sisi penyedia untuk Anda. Untuk Telnyx, ThunderPhone menambahkan satu koneksi SIP miliknya ke akun Telnyx Anda (bernama thunderphone-production-<org>-outbound-<id>) dan melakukan panggilan keluar melaluinya, sehingga Telnyx menagihkan panggilan tersebut kepada Anda. Sistem ini menggunakan profil suara keluar dari koneksi Telnyx tempat nomor Anda berada, sehingga negara yang diizinkan dan batas pengeluaran profil tersebut berlaku. Jika koneksi itu tidak memiliki profil suara keluar dan akun Anda memiliki tepat satu profil yang aktif, ThunderPhone menggunakannya. Untuk menggunakan profil lain, tetapkan profil tersebut ke koneksi di portal Telnyx lalu simpan kembali koneksi ThunderPhone. Jika akun tidak memiliki profil yang aktif, atau memiliki beberapa profil, tetapkan satu profil ke koneksi di portal Telnyx lalu simpan kembali koneksi ThunderPhone. Hingga saat itu, panggilan keluar gagal dengan outbound_trunk_unavailable; panggilan masuk tetap berfungsi.

Saat Telnyx menolak panggilan keluar (misalnya SIP 403 Forbidden), penolakan tersebut berasal dari akun Telnyx Anda sendiri. Penyebab umumnya adalah tidak ada kredit yang tersedia, nomor penelepon yang tidak ada pada akun Telnyx tersebut, atau profil suara keluar yang tidak mengizinkan negara tujuan.

Penyiapan SIP untuk SignalWire, Vonage, dan Plivo#

Ketiganya membuka formulir SIP manual dengan langkah untuk penyedia tersebut di bagian atas, tautan ke panduan penyiapan milik penyedia, dan contoh domain SIP:

• SignalWire: buat kredensial SIP untuk panggilan keluar, masukkan domain SIP, nama pengguna, dan kata sandi, lalu berikan setiap nomor skrip SWML yang menghubungkan panggilan masuk ke endpoint SIP ThunderPhone.
• Vonage: di dasbor SIP Trunking, buat trunk dengan kredensial keluar, masukkan domainnya (misalnya your-trunk.sip-us.vonage.com) dan kredensialnya, tambahkan endpoint SIP ThunderPhone sebagai URI SIP masuk trunk, lalu hubungkan nomor Anda ke trunk.
• Plivo: buat trunk keluar dengan kredensial lalu masukkan Termination SIP Domain (<trunk-id>.zt.plivo.com), nama pengguna, dan kata sandi; buat trunk masuk dengan URI Utama berupa endpoint SIP ThunderPhone yang diikuti oleh ;transport=tcp; kemudian tetapkan Application Type setiap nomor ke trunk tersebut.

Hasilnya adalah koneksi SIP manual (provider: "manual" di API), diuji dan diverifikasi sama seperti koneksi yang dimasukkan secara manual. Kartu koneksi menampilkan nama penyedia, misalnya SignalWire · SIP.

Siapkan akun Telnyx baru#

Belum memiliki provider? Alur terpandu memandu Anda untuk membuat akun Telnyx dan menghubungkannya:

1. Buat akun

   Klik Buka Pendaftaran Telnyx, buat akun Anda, lalu centang "Saya telah membuat akun."

2. Dapatkan kunci API

   Klik Buka Halaman Kunci API, buat kunci, lalu tempelkan ke Kunci API (v2). Anda juga dapat memberi nama koneksi.

3. Hubungkan & Uji

   Klik Hubungkan & Uji — ThunderPhone memverifikasi kredensial dan menyediakan yang diperlukan di sisi Telnyx sebelum menyimpan.

Yang disiapkan ThunderPhone di Telnyx#

Kecuali Anda memasukkan ID Koneksi sendiri, kedua jalur Telnyx (penyiapan terpandu dan menempelkan kunci API) meninggalkan hal yang sama di akun Telnyx Anda: satu koneksi SIP bernama thunderphone-<your organization id>. Ini adalah koneksi FQDN yang catatan FQDN-nya mengarah ke endpoint SIP ThunderPhone, dan setiap nomor yang Anda impor ditetapkan ke koneksi tersebut. Telnyx mengirim panggilan untuk nomor-nomor tersebut langsung ke ThunderPhone melalui SIP.

• Kolom webhook-nya sengaja dikosongkan. Tidak ada webhook, aplikasi Call Control, aplikasi TeXML, atau telepon SIP terdaftar yang digunakan.
• Jangan pindahkan nomor yang diimpor ke koneksi atau aplikasi lain, dan jangan daftarkan perangkat ke koneksi tersebut.
• Jika Anda memasukkan ID Koneksi sendiri saat menghubungkan, ThunderPhone menggunakan koneksi tersebut dan tidak pernah mengubahnya; koneksi itu harus berupa koneksi FQDN yang mengarah ke endpoint SIP ThunderPhone.

Sebelum 30 Agustus 2026, koneksi thunderphone-… yang dibuat ThunderPhone adalah koneksi Kredensial, yang tidak dapat menerima panggilan. Jika koneksi Anda masih ditampilkan sebagai koneksi Kredensial, hubungi dukungan dan kami akan mengonversinya.

Konfigurasi SIP manual#

Kartu SignalWire, Vonage, dan Plivo membuka formulir ini, begitu juga Saya akan memasukkan setiap pengaturan sendiri di bawah Operator lain. Semua trunk SIP berfungsi, termasuk DIDWW atau PBX yang Anda jalankan sendiri. Masukkan nama koneksi, domain / URI SIP, nama pengguna dan kata sandi opsional, port, serta transport; Pengaturan Lanjutan menambahkan enkripsi media (SRTP). Formulir ini juga menampilkan alamat SIP yang harus digunakan trunk Anda untuk mengirim panggilan masuk: sip.thunderphone.com, pada port 5060 untuk UDP atau TCP, atau 5061 untuk TLS. Melalui TLS, pensinyalan SIP tetap terenkripsi hingga ke LiveKit Cloud, tempat ThunderPhone menangani panggilan; audio tidak pernah melewati sip.thunderphone.com, sehingga SRTP tetap berfungsi seperti sebelumnya. Alamatkan setiap panggilan ke nomor yang dipanggil dalam format E.164, dengan nomor yang sama, termasuk +, pada baris permintaan dan header To: misalnya sip:+14155550142@sip.thunderphone.com. Tanda + memungkinkan ThunderPhone menangani panggilan di wilayah yang tepat (lihat catatan di bawah daftar izin IP). Trunk yang sebelumnya disiapkan dengan alamat <your-project>.sip.livekit.cloud tetap berfungsi selama IP Sumber yang Diizinkan kosong; Anda tidak perlu mengubahnya. ThunderPhone mengubah pengaturan tersebut menjadi sepasang trunk SIP khusus di LiveKit Cloud: panggilan keluar dari nomor koneksi dilakukan ke domain SIP Anda menggunakan kredensial Anda, dan panggilan masuk ke nomor tersebut diterima dari alamat mana pun kecuali Anda mengisi kolom opsional IP Sumber yang Diizinkan. Isi hanya jika operator Anda memublikasikan IP pensinyalan tetap: daftar yang salah atau tidak lengkap membuat ThunderPhone menolak panggilan masuk dari operator Anda. Dua tombol melakukan pekerjaan utama:

• Buat Panduan Penyiapan AI — menulis instruksi khusus operator untuk konfigurasi sisi trunk yang Anda perlukan.
• Uji & Simpan Koneksi — memeriksa bahwa endpoint SIP dapat di-resolve ke alamat publik dan, untuk TCP/TLS, menerima koneksi pada port yang dipilih (host UDP hanya mendapatkan pemeriksaan DNS), lalu menyimpan. Tombol ini belum dapat melakukan panggilan karena koneksi belum memiliki nomor; bukti sebenarnya muncul saat impor (di bawah).

Mengedit koneksi di kemudian hari akan menjalankan kembali pemeriksaan yang sama pada pengaturan yang telah Anda ubah sebelum apa pun disimpan, lalu membuat ulang trunk dan memverifikasi ulang setiap nomor pada koneksi dengan panggilan uji singkat di latar belakang — nomor akan ditampilkan sebagai Sedang disiapkan hingga panggilan uji berhasil. Mengubah hanya IP Sumber yang Diizinkan pada koneksi Terhubung berbeda: perubahan ini tidak pernah memengaruhi panggilan keluar, sehingga ThunderPhone langsung memperbarui daftar pada trunk masuk dan nomor tetap Aktif. Uji panggilan masuknya diatur ulang menjadi belum diuji; jalankan kembali, atau lakukan panggilan nyata melalui operator Anda, untuk mengonfirmasi bahwa daftar baru mengizinkan panggilan masuk. Pengujian gagal jika panggilannya akan ditolak berdasarkan daftar tersebut. Kata sandi yang tersimpan tidak pernah ditampilkan kembali; biarkan kata sandi kosong untuk menyimpannya, atau centang "Hapus kata sandi tersimpan" untuk trunk yang diautentikasi dengan IP.

Pencantuman IP dalam daftar izin dan autentikasi trunk#

Beberapa operator (DIDWW, koneksi autentikasi IP Telnyx, sebagian besar PBX di balik firewall) hanya menerima trafik SIP dari alamat yang Anda masukkan ke daftar izin, atau mengautentikasi panggilan keluar berdasarkan IP sumber. ThunderPhone menggunakan dua kelompok alamat.

Edge SIP. Panggilan masuk yang Anda kirim ke sip.thunderphone.com melewati edge SIP ThunderPhone, yang hanya membawa pensinyalan SIP. INVITE pertama dikirim ke sip.thunderphone.com; sisa pensinyalan panggilan (ACK, penutupan panggilan, transfer) berlangsung antara operator Anda dan server edge yang menerima panggilan, sip-1 atau sip-2. Jika firewall Anda memfilter pensinyalan SIP, izinkan ketiganya, pada port UDP dan TCP 5060 serta port TLS 5061:

LiveKit Cloud. Audio (RTP) setiap panggilan, serta pensinyalan SIP panggilan keluar, berjalan antara operator Anda dan LiveKit Cloud, tidak pernah melalui edge SIP. Izinkan setiap rentang di bawah ini, untuk pensinyalan SIP dan media:

LiveKit menerapkan rentang ini pada Realtime, pensinyalan dan media SIP, serta Webhooks, dan rentang tersebut mencakup panggilan yang ditangani di region Kanada, EU, India, Jepang, dan US. Nama region untuk endpoint yang disematkan: canada, eu, india, japan, us.

Beberapa aturan praktis untuk trunk itu sendiri:

• ThunderPhone tidak melakukan registrasi. ThunderPhone tidak pernah mengirim SIP REGISTER ke operator Anda, jadi konfigurasikan trunk untuk autentikasi berbasis IP dan/atau kredensial (nama pengguna + kata sandi), bukan registrasi.
• Panggilan keluar harus menggunakan kredensial. Aktifkan autentikasi nama pengguna/kata sandi di sisi operator dan masukkan nilai yang sama di formulir SIP manual. Perlakukan daftar izin IP sebagai lapisan kedua, bukan satu-satunya lapisan — panggilan keluar ke tujuan di luar region yang tercakup dapat berasal dari alamat lain.
• Panggilan masuk adalah arah sebaliknya. Kolom opsional IP Sumber yang Diizinkan dalam formulir adalah tempat Anda memasukkan alamat pensinyalan operator Anda agar ThunderPhone hanya menerima panggilan dari alamat tersebut. Masukkan alamat IP atau rentang CIDR; nama host tidak pernah cocok. Biarkan kosong kecuali operator Anda menerbitkan daftar tetap. ThunderPhone memeriksa daftar pada setiap panggilan masuk terhadap alamat yang dilihat edge SIP-nya, jadi setelah daftar ditetapkan, kirim panggilan Anda ke sip.thunderphone.com. Panggilan dari alamat yang tidak ada dalam daftar, atau yang dikirim langsung ke alamat <your-project>.sip.livekit.cloud, ditolak: panggilan gagal atau tersambung lalu langsung berakhir.

Rentang tersebut dipublikasikan oleh LiveKit di Regions, regional endpoints, and static IPs; ThunderPhone memeriksa halaman tersebut setiap minggu dan memperbarui panduan ini saat berubah.

Setelah terhubung#

Impor nomor dari Nomor Telepon → Tambahkan nomor → Hubungkan penyedia VoIP (atau langsung dari koneksi). Setiap nomor yang diimpor diverifikasi sebelum aktif. Untuk koneksi SIP manual, verifikasi tersebut melakukan panggilan uji singkat (beberapa detik) dari nomor Anda, melalui trunk SIP Anda, ke nomor ThunderPhone — sehingga nama pengguna, kata sandi, transport, dan perutean keluar operator Anda semuanya benar-benar diuji. Operator Anda menagihkan panggilan tersebut seperti panggilan lainnya.

Jika operator menolaknya, nomor tetap berstatus Provisioning dan halaman nomor telepon menampilkan respons operator (misalnya "kredensial ThunderPhone ditolak (SIP 401)"); perbaiki koneksi lalu verifikasi kembali. Jika operator Anda menerima trunk tetapi paket peruteannya tidak mencakup nomor uji ThunderPhone (DIDWW menjawab "Nomor tujuan masuk daftar hitam oleh paket perutean"), nomor akan ditampilkan sebagai Verified · carrier accepted: nomor dapat digunakan, tetapi panggilan ke tujuan lain belum diuji. Panggilan tersebut membuktikan trunk Anda dapat melakukan panggilan sebagai nomor tersebut; panggilan itu bukan bukti bahwa Anda memiliki nomor tersebut, dan tidak menguji panggilan ke nomor tersebut; pengujian masuk opsional di bawah melakukannya. Nomor yang telah diverifikasi mendukung panggilan masuk dan keluar — yang membuka kampanye keluar dan panggilan keluar terprogram.

Pengujian panggilan masuk#

Verifikasi nomor membuka dialog yang juga dapat menguji panggilan masuk. Pengujian ini melakukan panggilan ke nomor Anda, memeriksa bahwa panggilan mencapai ThunderPhone, lalu mengakhirinya tanpa memulai agen Anda:

• Nomor dengan trunk SIP keluar sendiri (nomor SIP manual, dan nomor Twilio setelah ThunderPhone menyiapkan panggilan keluar di akun Twilio Anda) terlebih dahulu menelepon dirinya sendiri: ThunderPhone menghubungi nomor tersebut dari nomor itu sendiri, melalui trunk tersebut. Dialog memberi tahu Anda sebelum melakukan panggilan. Panggilan keluar melalui operator Anda dan, jika perutean masuk Anda benar, langsung kembali ke ThunderPhone. Saat panggilan kembali dengan ID penelepon nomor itu sendiri, satu panggilan tersebut membuktikan bahwa operator Anda menerima panggilan ThunderPhone sebagai nomor tersebut dan bahwa panggilan ke nomor tersebut mencapai ThunderPhone, di negara mana pun. Beberapa operator menolak atau tidak menyambungkan panggilan dari suatu nomor ke dirinya sendiri; hal itu tidak menunjukkan apa pun tentang perutean Anda, sehingga ThunderPhone kemudian menelepon dari salah satu nomornya sendiri. Jika nomor Anda meneruskan panggilan ke tempat lain, telepon tersebut mungkin berdering dua kali: pertama menampilkan ID penelepon nomor itu sendiri, lalu nomor pengujian ThunderPhone.
• Nomor lain (dan cadangan di atas) dihubungi dari salah satu nomor ThunderPhone sendiri. Untuk saat ini, ThunderPhone hanya dapat melakukan panggilan ini ke nomor AS dan Kanada; untuk nomor lain, pengujian melaporkan bahwa pengujian tidak dapat dijalankan, disertai jawaban operator Anda jika panggilan ke diri sendiri ditolak.

Jika operator Anda mengubah ID penelepon di tengah perjalanan, ThunderPhone tidak dapat mengenali panggilan tersebut, sehingga agen Anda mungkin menjawabnya sesaat. Pengujian panggilan masuk bersifat opsional. Lewati pengujian ini dan nomor tetap berfungsi; halaman nomor telepon kemudian menampilkan Panggilan masuk belum diuji, dan Anda dapat menjalankannya nanti dengan Uji atau item menu Uji panggilan masuk milik nomor tersebut. Tepat setelah impor, halaman nomor telepon juga meminta Anda menguji panggilan masuk pada nomor baru. Tidak ada panggilan yang dilakukan sampai Anda mengonfirmasi di dialog.

Jika penyedia Anda mengirim nomor tersebut ke tempat lain, apa pun yang dituju dapat berdering hingga 8 detik per panggilan sebelum ThunderPhone mengakhirinya. Jika sesuatu menjawab terlebih dahulu (aplikasi Twilio yang menjawab lalu meneruskan, menu telepon), pengujian menunggu panggilan yang diteruskan mencapai ThunderPhone: hingga 8 detik pada panggilan ke diri sendiri dan 15 detik pada panggilan dari nomor ThunderPhone. Hasil tetap tersimpan pada nomor (Panggilan masuk berhasil atau gagal) hingga Anda mengubah koneksi atau mengimpor ulang nomor tersebut, yang mengatur ulang statusnya menjadi belum diuji. Mengubah koneksi memverifikasi ulang panggilan keluar di latar belakang tetapi tidak pernah menelepon nomor Anda tanpa diminta.

Pemecahan masalah panggilan masuk#

Tombol Uji pada koneksi memeriksa kredensial, dan verifikasi memeriksa panggilan keluar. Untuk memeriksa panggilan masuk, jalankan uji panggilan masuk di atas, atau hubungi nomor tersebut dari telepon dan cari panggilannya di Riwayat Panggilan. Uji Talk di browser dan simulasi bot-ke-bot tidak melalui operator Anda, sehingga tidak menunjukkan apakah panggilan masuk berfungsi. Simulasi yang menargetkan nomor telepon (loopback SIP) memang memanggilnya melalui operator Anda, sehingga panggilan yang dijawab akan menguji perutean panggilan masuk.

• Anda mendengar pesan dari operator seluler Anda sendiri (misalnya "Selamat datang di Verizon" atau "nomor yang Anda hubungi tidak aktif"): panggilan gagal sebelum mencapai ThunderPhone. Pastikan nomor tersebut aktif di akun penyedia Anda dan ditetapkan ke koneksi atau trunk ThunderPhone.
• Nada sibuk atau panggilan terus berdering: penyedia menerima panggilan tetapi tidak dapat mengirimkannya. Dengan Telnyx, periksa Koneksi nomor tersebut di portal Telnyx: seharusnya berupa koneksi FQDN thunderphone-… yang dijelaskan di atas, atau koneksi FQDN Anda sendiri yang mengarah ke endpoint SIP ThunderPhone. Dengan Twilio, nomor tersebut harus terpasang ke trunk SIP ThunderPhone, bukan ke webhook Voice atau aplikasi TwiML.
• Log operator Anda menampilkan 404 No trunk found (SIP manual): panggilan mencapai ThunderPhone tetapi tidak cocok dengan trunk mana pun. Pastikan nomor tersebut diimpor pada koneksi ini dan trunk mengarah ke sip.thunderphone.com. Jika trunk mengarah ke alamat <your-project>.sip.livekit.cloud, IP Sumber yang Diizinkan harus kosong: jika daftar diatur, hanya panggilan yang dikirim ke sip.thunderphone.com yang diterima.
• 404 Not Found dari sip.thunderphone.com (SIP manual): panggilan tidak dialamatkan ke nomor telepon, atau baris permintaan dan header To menyebut nomor yang berbeda. Kirim nomor yang dipanggil pada keduanya, seperti di atas.
• 403 Forbidden dari sip.thunderphone.com: baris permintaan menyebut host lain. Alamatkan panggilan ke sip.thunderphone.com, misalnya sip:+14155550142@sip.thunderphone.com.
• Panggilan mencapai ThunderPhone tetapi dijawab oleh agen yang salah, atau tidak ada yang menjawab: periksa agen panggilan masuk nomor tersebut di Nomor Telepon.

Copilot dalam aplikasi dapat memeriksa nomor untuk Anda: tanyakan kepadanya mengapa panggilan ke nomor tersebut gagal. Untuk koneksi Telnyx, copilot juga mencari, dalam mode hanya baca dan untuk admin organisasi, koneksi yang digunakan Telnyx untuk menetapkan nomor tersebut.

Langkah berikutnya#