Menerima panggilan
Nomor yang dimiliki workspace Anda dapat menjawab panggilan masuk dengan salah satu dari tiga cara: mengirimkannya ke salah satu trunk SIP Anda, meneruskannya ke nomor yang sudah Anda verifikasi, atau menolaknya. Jawaban tersebut adalah pengaturan pada nomor, dan satu nomor hanya memiliki satu jawaban pada satu waktu.
Setiap nomor dimulai dengan reject, sehingga nomor yang belum dikonfigurasi siapa pun akan menolak penelepon alih-alih tidak memiliki jawaban sama sekali.
Prasyarat
Sebelum Anda mengarahkan nomor ke sebuah jawaban:
- Nomor yang dapat menerima panggilan. Buka Voice > Numbers dan periksa kolom Directions untuk tanda inbound. Nomor yang Anda daftarkan sebagai caller ID dari operator lain tidak menerima panggilan di sini: operator tersebut yang merutekan panggilan ke nomor itu, jadi nomor tersebut tidak memiliki jawaban.
- Untuk pengiriman ke trunk: sebuah trunk SIP dengan panggilan masuk aktif dan minimal satu gateway pengiriman.
- Untuk penerusan: sebuah caller ID terverifikasi sebagai tujuan penerusan.
- Untuk mengubah pengaturan melalui API atau CLI: sebuah kunci API yang memiliki scope voice_management pada level write. Scope tersebut mencakup konfigurasi voice; scope voice mencakup lalu lintas panggilan dan statistik, jadi membaca log panggilan memerlukan scope yang satunya.
Kirim panggilan ke trunk SIP
Pengiriman memanggil sistem telepon Anda sendiri di alamat yang Anda deklarasikan pada trunk. Aktifkan arahnya terlebih dahulu, karena nomor hanya dapat diarahkan ke trunk yang sudah menerima panggilan masuk.
- Buka Voice > SIP Trunks, buka trunk tersebut, dan di bagian Inbound calling pilih Enable inbound.
- Tambahkan minimal satu gateway di bagian yang sama. Trunk tanpa gateway menolak setiap panggilan masuk ke nomor-nomor yang dijawabnya.
- Buka Voice > Numbers, buka nomor tersebut, dan di bagian Inbound routing pilih Deliver to a SIP trunk.
- Pilih trunk lalu klik Save. Hanya trunk dengan panggilan masuk aktif yang muncul di daftar.
Kolom Used for pada daftar Numbers kemudian menampilkan nomor tersebut sebagai dikirim ke trunk itu, dan halaman trunk sendiri mencantumkan nomor-nomor yang dijawabnya.
Apa yang dibutuhkan gateway
Gateway adalah satu alamat tujuan pengiriman panggilan, beserta cara peer tersebut menginginkan dua nomor panggilan dituliskan:
| Pengaturan | Penjelasan |
|---|---|
| URI SIP | Host sistem telepon Anda, dengan port opsional, seperti sip:pbx.example.com:5060. Berikan host saja: URI yang mengandung user part akan ditolak |
| Priority | Urutan gateway dicoba, dari yang terkecil lebih dulu |
| Destination format | Cara nomor tujuan dituliskan ke peer ini. Default-nya E.164 |
| Origination format | Cara nomor pemanggil dituliskan ke peer ini, pada header P-Asserted-Identity panggilan yang dikirim. Default-nya E.164 |
Gateway dengan priority yang sama menerima bagian panggilan yang setara, dan salah satu dari mereka bisa dicoba lebih dulu pada panggilan tertentu. Untuk mengalihkan pengiriman ke alamat kedua, berikan gateway tersebut angka priority yang lebih besar: gateway itu dicoba ketika yang pertama tidak menjawab.
Kedua format nomor adalah template dengan satu placeholder, {number}, yang mewakili nomor tanpa awalan +. Format destination ditempatkan sebelum host URI SIP, jadi 1234#{number} mengirim panggilan ke +31201234567 sebagai sip:1234#31201234567@pbx.example.com:5060. Default untuk keduanya adalah +{number}, yaitu E.164. Format yang tidak mengandung {number} sama sekali mengirim setiap nomor yang dijawab trunk ke satu alamat tetap.
Warning: turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again.
Teruskan panggilan ke nomor lain
Penerusan menjawab panggilan masuk dan melakukan panggilan kedua ke nomor yang sudah Anda verifikasi, lalu menghubungkan keduanya.
- Buka Voice > Numbers, buka nomor tersebut, dan di bagian Inbound routing pilih Forward to another number.
- Pilih nomor tujuan penerusan. Daftar berisi caller ID terverifikasi Anda, karena penerusan hanya boleh menargetkan nomor yang sudah Anda buktikan Anda kendalikan.
- Pilih nomor mana yang ditampilkan sebagai pemanggil pada panggilan yang diteruskan, lalu klik Save.
Target penerusan diperiksa saat Anda mengaturnya dan kembali pada setiap panggilan yang diteruskan. Caller ID yang kemudian Anda hapus menghentikan penerusan alih-alih melanjutkannya, dan panggilan masuk ditolak sejak saat itu.
Panggilan yang diteruskan berdering selama 45 detik sebelum dianggap gagal, lebih lama dari pengiriman ke trunk karena ujung seberang biasanya adalah telepon seseorang, bukan sistem telepon.
Penerusan melakukan panggilan, jadi aturan outbound berlaku pada leg kedua: meneruskan ke negara yang belum Anda aktifkan di Destinations ditolak dengan destination_not_enabled.
Satu penerusan, dua catatan panggilan
Panggilan yang diteruskan menghasilkan dua catatan yang berbagi satu session_id:
| Catatan | Penjelasan |
|---|---|
| Panggilan masuk | direction adalah inbound, dan route menyatakan nomor diatur untuk meneruskan, ke nomor mana, dan nomor mana yang ditampilkan leg penerusan |
| Panggilan terusan | direction adalah outbound, dari nomor yang ditampilkan leg tersebut ke nomor tujuan penerusan Anda. Catatan ini tidak memiliki route sendiri |
Kelompokkan berdasarkan session_id untuk melihat keseluruhan panggilan. Catatan panggilan masuk adalah catatan yang menyatakan apa yang dikonfigurasi pada nomor tersebut.
Pilih nomor mana yang ditampilkan sebagai pemanggil pada panggilan yang diteruskan
Panggilan yang diteruskan memiliki dua nomor yang bisa ditampilkan kepada penjawab, dan pilihan ini memengaruhi apa yang mereka lihat serta seberapa besar kemungkinan operator mencampuri panggilan tersebut:
- Calling number adalah nomor pemanggil itu sendiri, sehingga telepon berdering seolah-olah mereka menelepon langsung dan panggilan dapat dikembalikan dari log panggilan. Karena nomor tersebut bukan milik Anda, beberapa operator, paling sering di AS dan sebagian Eropa, menandai panggilan semacam itu sebagai tidak terverifikasi, mengganti nomornya, atau menyaringnya.
- Dialed number adalah nomor yang dihubungi pemanggil, yaitu salah satu nomor Anda. Penjawab melihat nomor Anda yang mana yang dihubungi, bukan siapa yang menelepon.
Tidak ada default. Tentukan pilihan ini pada setiap penerusan yang Anda tulis melalui API atau CLI.
Nilai mana yang boleh diatur workspace Anda tercantum pada nomor itu sendiri, di forward_as_options pada inbound_configuration. Menampilkan dialed number memerlukan workspace Anda disetujui untuk melakukan panggilan dari nomor yang Anda beli dari kami, dan persetujuan tersebut belum tersedia, jadi forward_as_options hanya menawarkan calling number dan penerusan menampilkan nomor pemanggil itu sendiri. Mengatur dialed number ditolak hingga saat itu.
Pada pembacaan, forward_as adalah nilai yang benar-benar dibawa panggilan, yang bisa berbeda dari nilai terakhir yang ditulis.
Lihat apa yang dilakukan nomor terhadap panggilan
Catatan panggilan masuk memiliki route di samping statusnya, dan route adalah apa yang diatur pada nomor saat panggilan ditangani. Mengubah pengaturan nomor setelahnya tidak mengubah catatan panggilan yang sudah lalu.
| route.type | Apa yang dilakukan nomor |
|---|---|
| trunk | Panggilan dikirim ke trunk SIP yang disebutkan di trunk_id |
| forward | Panggilan diteruskan ke nomor di forward_to, menampilkan nomor di forward_as |
| reject | Nomor menolak panggilan tersebut |
route menyatakan apa yang diatur pada nomor, bukan bahwa itu berhasil. Rute trunk pada panggilan yang tidak pernah tersambung berarti nomor diarahkan ke trunk yang tidak menerima panggilan tersebut, dan status panggilan itulah yang membawa hasilnya. route tidak ada pada panggilan keluar dan pada panggilan yang dicatat sebelum field ini ada.
Di dashboard, buka panggilan dari Voice > Calls dan baca baris Inbound route, yang menautkan ke nomor yang pengaturannya menentukan panggilan tersebut. Melalui API, route ada di GET /v1/voice/calls/{call_id} dan GET /v1/voice/calls, dan direction memfilter daftar ke panggilan masuk.
Diagnosis panggilan masuk yang ditolak
Panggilan masuk yang ditolak dicatat dengan status rejected. Dua hal berbeda menghasilkannya, dan rejection_reason adalah yang membedakan keduanya:
- Ditolak tanpa rejection_reason. Nomor itu sendiri yang menolak panggilan. Panggilan tidak gagal pada pemeriksaan kami mana pun, sehingga tidak menyebutkan alasan, dan route menyatakan apa yang diatur pada nomor. Rute reject berarti nomor yang tidak diarahkan ke mana pun, atau nomor yang sengaja diatur untuk menolak.
- Ditolak dengan rejection_reason. Panggilan gagal pada salah satu pemeriksaan kami sebelum mencapai sistem telepon Anda. Alasan menyebutkan pemeriksaan tersebut. Rejected calls mencantumkan setiap alasan beserta perbaikannya.
failed adalah status yang berbeda dan tidak berarti ditolak: artinya panggilan dicoba dan tidak berhasil, dengan sip_response_code membawa respons yang kembali.
Baca route dan rejection_reason bersama-sama untuk membedakan penolakan:
| route dan alasan | Penyebab |
|---|---|
| reject, tanpa alasan | Nomor tidak diarahkan ke jawaban mana pun. Menghapus trunk, atau menonaktifkan panggilan masuknya, mengembalikan setiap nomor yang mengarah ke trunk itu ke sini, sehingga nomor yang sebelumnya berfungsi bisa tiba di sini |
| trunk, no_route_found | Nomor diarahkan ke trunk, dan trunk tersebut tidak memiliki gateway untuk mengirim panggilan. Tambahkan gateway di halaman trunk |
| forward, tanpa alasan | Target penerusan bukan lagi caller ID terverifikasi. Verifikasi ulang di Caller IDs, atau teruskan ke nomor lain |
| forward, destination_not_enabled | Leg kedua tidak dapat dilakukan ke negara target penerusan. Aktifkan negara tersebut di Destinations |
Batas akun berlaku juga untuk panggilan masuk: melewati saldo wallet Anda, batas pengeluaran voice harian organisasi Anda, atau batas konkurensi dan per-detik Anda, panggilan masuk ditolak dengan alasan yang sesuai. Voice overview membahas batas-batas tersebut.
Periksa biaya panggilan yang diterima
Menerima panggilan dikenakan biaya. Tarifnya bergantung pada negara dan jenis nomor yang menerima, dan dipublikasikan per negara di bawah Receiving calls pada halaman harga voice, bersama tarif untuk panggilan yang Anda lakukan.
Penerusan ditagih sebagai dua panggilan: panggilan masuk dengan tarif penerimaan, dan leg yang kami lakukan dengan tarif outbound untuk nomor tujuan penerusan Anda. Satu biaya penanganan dikenakan sekali untuk panggilan tersebut, bukan sekali per leg.
Wallet diperiksa sebelum panggilan masuk dikirim, sehingga saldo yang tidak mencukupi berarti panggilan ditolak, bukan ditagihkan kepada Anda setelahnya. Cost and billing membahas cara waktu yang dapat ditagih, tarif, dan wallet bekerja untuk kedua arah.
Langkah selanjutnya
| Halaman | Yang dibahas |
|---|---|
| Trunk SIP | Membuat trunk, dua arahnya, dan mengontrol siapa yang boleh mengirim |
| Caller IDs | Mendaftarkan nomor dan membuktikan bahwa Anda mengendalikannya |
| Call log | Setiap field pada catatan panggilan, dan setiap alasan penolakan |
| Voice events | Mendapatkan hasil panggilan yang dikirim ke sistem Anda sendiri |
| Voice troubleshooting | Mendiagnosis panggilan yang tidak berhasil, berdasarkan gejalanya |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.