# 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**](https://bird.com/dashboard/w/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](/docs/guides/voice/sip-trunks) dengan panggilan masuk aktif dan minimal satu gateway pengiriman.
- **Untuk penerusan:** sebuah [caller ID terverifikasi](/docs/guides/voice/caller-ids) 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.

1. Buka **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), buka trunk tersebut, dan di bagian **Inbound calling** pilih **Enable inbound**.
2. Tambahkan minimal satu gateway di bagian yang sama. Trunk tanpa gateway menolak setiap panggilan masuk ke nomor-nomor yang dijawabnya.
3. Buka **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), buka nomor tersebut, dan di bagian **Inbound routing** pilih **Deliver to a SIP trunk**.
4. 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.

1. Buka **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), buka nomor tersebut, dan di bagian **Inbound routing** pilih **Forward to another number**.
2. Pilih nomor tujuan penerusan. Daftar berisi caller ID terverifikasi Anda, karena penerusan hanya boleh menargetkan nomor yang sudah Anda buktikan Anda kendalikan.
3. 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](/docs/guides/voice/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**](https://bird.com/dashboard/w/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}`](/docs/api/reference/get-voice-call) dan [`GET /v1/voice/calls`](/docs/api/reference/list-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](/docs/guides/voice/call-log#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](/docs/guides/voice/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](/docs/guides/voice/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](/docs/guides/voice/overview#limits) 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](/pricing/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](/docs/guides/voice/placing-calls#cost-and-billing) membahas cara waktu yang dapat ditagih, tarif, dan wallet bekerja untuk kedua arah.

## Langkah selanjutnya

| Halaman                                                     | Yang dibahas                                                         |
| ----------------------------------------------------------- | -------------------------------------------------------------------- |
| [Trunk SIP](/docs/guides/voice/sip-trunks)                  | Membuat trunk, dua arahnya, dan mengontrol siapa yang boleh mengirim |
| [Caller IDs](/docs/guides/voice/caller-ids)                 | Mendaftarkan nomor dan membuktikan bahwa Anda mengendalikannya       |
| [Call log](/docs/guides/voice/call-log)                     | Setiap field pada catatan panggilan, dan setiap alasan penolakan     |
| [Voice events](/docs/guides/voice/events)                   | Mendapatkan hasil panggilan yang dikirim ke sistem Anda sendiri      |
| [Voice troubleshooting](/docs/guides/voice/troubleshooting) | Mendiagnosis panggilan yang tidak berhasil, berdasarkan gejalanya    |

## Related resources

- [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer)
- [Voice](/products/voice) (product)

[Get an implementation brief](/learn/workspace?topic=voice)