--- title: "Menyiapkan trunk SIP untuk menerima dan melakukan panggilan" description: "Hubungkan PBX atau SBC Anda ke Bird secara berurutan: buat trunk, kirim panggilan masuk ke gateway Anda, buka panggilan keluar, lalu uji kedua arah." canonical: "https://bird.com/id-id/dokumentasi/guides/voice/sip-trunk-setup" --- # Menyiapkan trunk SIP untuk menerima dan melakukan panggilan Halaman ini menjelaskan penyiapan trunk lengkap sesuai urutan yang dibutuhkan dasbor. Jika melewatkan suatu langkah menimbulkan gejala yang terlihat, langkah tersebut menyebutkannya, sehingga Anda juga dapat memakai halaman ini sebagai daftar periksa saat panggilan uji gagal. Untuk arti setiap pengaturan, ikuti tautan ke [Trunk SIP](/docs/guides/voice/sip-trunks), [Menerima panggilan](/docs/guides/voice/receiving-calls), dan [Melakukan panggilan](/docs/guides/voice/placing-calls). ## Sebelum memulai - Sebuah workspace Bird. Panggilan, nomor, dan trunk terikat pada satu workspace, jadi lakukan setiap langkah di workspace yang sama. - Alamat publik perangkat Anda: host tujuan Bird mengirimkan panggilan, dan alamat asal perangkat Anda mengirim SIP. - Untuk panggilan masuk, nomor Bird di workspace tersebut. Untuk panggilan keluar, caller ID: nomor Bird di workspace atau nomor yang sudah Anda [verifikasi](/docs/guides/voice/caller-ids). - Nomor Bird dengan `status` bernilai `active`. Nomor yang masih menunggu dokumen kepemilikan atau registrasinya tidak dapat menerima maupun melakukan panggilan: lihat [Mengajukan dokumen kepemilikan nomor](/docs/guides/numbers/ownership-paperwork). ## 1. Buat trunk Buka **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), pilih **Add new SIP trunk**, masukkan nama, lalu pilih **Create trunk**. Trunk baru tidak membawa panggilan ke arah mana pun sampai Anda mengaktifkan setiap arah. ## 2. Aktifkan panggilan masuk Di bagian **Inbound calling**, pilih **Enable inbound**. Bagian **Inbound routing** akan muncul di bawahnya. Jika Anda melewati langkah ini, nomor tidak dapat diarahkan ke trunk karena trunk tersebut tidak muncul di daftar trunk milik nomor. ## 3. Tambahkan gateway Anda Di **Inbound routing**, buka tab **Gateways** lalu pilih **Add gateway** untuk setiap alamat yang menjadi tujuan Bird mengirimkan panggilan: | Kolom | Yang perlu diisi | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Label yang mudah Anda kenali, misalnya `Primary SBC` | | **Host** | Nama host atau alamat IP publik perangkat Anda, tanpa `sip:` atau bagian pengguna | | **Port** | Biarkan kosong untuk memakai port bawaan transport, atau masukkan port yang didengarkan perangkat Anda | | **Transport** | UDP, TCP, atau TLS, sesuai perangkat Anda | | **R-URI user part** | Cara nomor yang dihubungi ditulis di Request-URI. Bawaannya E.164 dengan `+` | | **Origination format** | Cara nomor penelepon ditulis. Bawaannya E.164 dengan `+` | | **Priority** | Posisi gateway di **All gateways (automatic)**: angka yang lebih kecil berdering lebih dulu, dan angka yang sama berbagi panggilan. Bawaannya 0 | Jika perangkat Anda mengharapkan nomor tanpa awalan `+`, buka daftar format dan pilih **Without the plus**, atau awalan internasional `00` atau `011`. [Kebutuhan gateway](/docs/guides/voice/receiving-calls#what-a-gateway-needs) menjelaskan format nomor tersebut. Bird meneruskan header `To` apa adanya seperti yang dikirim operator penelepon. Jika perangkat Anda membaca nomor yang dihubungi dari `To`, pilih **Rewrite To user part** dan susun format yang sama dengan **R-URI user part**. Bird kemudian mengganti bagian pengguna `To` pada panggilan ke gateway tersebut. Gateway Anda harus menerima panggilan dari Bird tanpa tantangan Digest SIP, karena Bird tidak menjawab tantangan tersebut. ## 4. Pilih grup yang dicari panggilan Bird mengirimkan panggilan ke grup gateway. Setiap gateway berada di **All gateways (automatic)**, yang mencoba gateway sesuai urutan **Priority** di tab **Gateways**, mulai dari yang terendah. Untuk failover melalui grup ini, beri gateway cadangan angka **Priority** yang lebih tinggi daripada gateway utama. Jika tab **Groups** tidak menampilkan **All gateways (automatic)**, perutean tersimpan trunk berisi grup tersendiri sebagai penggantinya, dan **Priority** tidak mengatur urutan grup tersebut; lihat [Menggunakan grup otomatis](/docs/guides/voice/hunt-groups#use-the-automatic-group). Saat gateway pertama ditambahkan ke trunk yang peruteannya belum pernah disimpan, dashboard mengarahkan rute default ke **All gateways (automatic)**. Untuk waktu dering, bobot, atau hanya sebagian gateway yang berbeda, buat grup sendiri: di tab **Groups**, pilih **Add group**, beri nama, lalu gunakan **Add gateway to group** untuk setiap gateway. [Failover dan pembagian panggilan masuk](/docs/guides/voice/hunt-groups) menjelaskan setiap urutan, waktu dering, dan kapan pencarian gateway berhenti. ## 5. Arahkan rute default ke grup Di tab **Rules**, cari **Default route** (**No rule above matched**). Atur **Then** ke **Route to group** dan pilih grup Anda. Pilih **Review and save**, lalu konfirmasi. Rute default menangani setiap panggilan yang tidak cocok dengan aturan mana pun, jadi tanpa aturan, rute ini menangani semua panggilan. Jika diatur ke **Reject**, panggilan tersebut ditolak sebelum mencapai perangkat Anda, meskipun ada gateway dalam grup. Pada tinjauan, dashboard menampilkan peringatan **Calls never reach some gateways** jika ada gateway yang tidak berada dalam grup mana pun yang menjadi tujuan panggilan dari aturan atau rute default. Atasi peringatan itu sebelum Anda menguji. Rute default ini milik trunk. Rute ini terpisah dari pengaturan workspace **Calls to numbers without their own route** di halaman **Numbers**, yang menentukan apa yang terjadi pada nomor yang tidak memiliki rute sendiri. ## 6. Arahkan nomor Anda ke trunk Buka **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), buka nomornya, lalu di bawah **Inbound routing** pilih **Deliver to a SIP trunk**. Pilih trunk dan simpan. Nomor tanpa rute sendiri mengikuti rute default workspace, yang awalnya diatur untuk menolak. Untuk mengirim semua nomor seperti itu ke trunk ini sekaligus, atur **Calls to numbers without their own route** ke trunk tersebut. Lihat [Menetapkan rute default](/docs/guides/voice/receiving-calls#set-a-default-route). Jika Anda melewati langkah ini saat rute default workspace masih menolak, panggilan masuk akan ditolak dan **Inbound route** pada catatan panggilan menampilkan **Reject the leg**. ## 7. Aktifkan panggilan keluar dan tentukan siapa yang boleh mengirim Di bawah **Outbound calling**, pilih **Enable outbound**. Bagian **Connection** muncul dengan **SIP domain** milik trunk. Bird mengenali trunk Anda dari domain ini, jadi salin domain tersebut secara utuh. Lalu tambahkan setidaknya satu cara untuk mengenali perangkat Anda: - **Allowed IP addresses**: alamat publik yang digunakan perangkat Anda untuk mengirim SIP. Jika perangkat berada di balik NAT, gunakan alamat publik router. - **Allowed API keys**: untuk perangkat yang menjawab tantangan Digest, dengan nama pengguna `bird` dan secret kunci API sebagai kata sandi. Selama panggilan keluar belum diaktifkan, trunk menolak setiap panggilan keluar. Selama trunk belum dapat mengenali perangkat Anda, panggilan ditolak sebelum catatan panggilan dibuat. Lihat [Mengontrol siapa yang boleh mengirim panggilan](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 8. Konfigurasikan PBX atau SBC Anda Di PBX atau SBC Anda: - **Kirim panggilan keluar ke domain SIP milik trunk.** Masukkan domain SIP sebagai host Request-URI. Gunakan port `5060` (UDP atau TCP) atau `5061` (TLS). Panggilan dengan host Request-URI bernama lain akan ditolak. - **Panggil dalam format internasional.** Tulis nomor tujuan di bagian pengguna Request-URI sebagai `+` diikuti kode negara, misalnya `+442071234567`. Jangan tambahkan prefiks teknis. Lihat [Yang diharapkan Bird pada INVITE](/docs/guides/voice/placing-calls#what-bird-expects-on-the-invite). - **Tampilkan caller ID yang memenuhi syarat** di header `From`. - **Tawarkan G.711** (A-law atau ยต-law) dan kirim DTMF sebagai event telepon RFC 4733. Bagian yang sama di halaman tersebut juga membahas media. - **Izinkan alamat Bird.** Jika firewall atau SBC Anda hanya menerima alamat yang terdaftar, izinkan alamat pensinyalan dan media untuk region trunk Anda, yang tercantum di [Persyaratan jaringan trunk SIP](/docs/guides/voice/network-requirements). ## 9. Aktifkan negara yang Anda panggil Buka **Voice** > [**Destinations**](https://bird.com/dashboard/w/voice/destinations), centang setiap negara yang Anda hubungi, lalu pilih **Save changes**. Workspace baru dimulai tanpa negara yang diaktifkan, dan panggilan ke negara yang dinonaktifkan ditolak dengan `destination_not_enabled`. Lihat [Tujuan suara](/docs/guides/voice/destinations). ## 10. Uji kedua arah 1. **Masuk:** hubungi nomor Bird Anda dari telepon biasa, lalu buka **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) di workspace yang sama. 2. **Keluar:** lakukan panggilan dari perangkat Anda ke nomor mana pun yang dapat dijangkau di negara yang diaktifkan, dengan menampilkan nomor Bird Anda atau nomor terverifikasi sebagai ID penelepon. Anda tidak memerlukan nomor Bird kedua untuk ini. 3. Buka setiap leg. **Inbound route** menunjukkan apa yang diatur untuk dilakukan nomor tersebut. Panggilan yang ditolak menampilkan alasannya dan, jika perbaikannya berupa pengaturan Anda, tautan ke pengaturan tersebut. Panggilan yang berhasil menampilkan **Answered**. Simpan **Leg ID** jika Anda menghubungi dukungan. Jika panggilan tidak muncul, ditolak, atau tidak pernah mencapai perangkat Anda, ikuti [Pemecahan masalah suara](/docs/guides/voice/troubleshooting), yang dimulai dari gejalanya. ## Langkah berikutnya | Halaman | Yang dibahas | | ------------------------------------------------------------- | ----------------------------------------------------- | | [Trunk SIP](/docs/guides/voice/sip-trunks) | Semua pengaturan trunk, autentikasi, dan Digest | | [Menerima panggilan](/docs/guides/voice/receiving-calls) | Rute nomor, gateway, grup, dan rute default workspace | | [Melakukan panggilan](/docs/guides/voice/placing-calls) | Apa yang diharapkan Bird pada `INVITE` | | [Pemecahan masalah suara](/docs/guides/voice/troubleshooting) | Mendiagnosis panggilan berdasarkan gejalanya | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)