Ikhtisar Voice
Bird Voice memungkinkan Anda menelepon nomor telepon dan menjawab panggilan ke nomor yang Anda miliki. Hubungkan sistem telepon melalui SIP, lakukan panggilan dari browser, atau gunakan pembuat sequence untuk menjalankan alur panggilan yang disimpan. Bird menghubungkan panggilan ke jaringan telepon publik, yaitu PSTN.
Koneksi antara sistem telepon Anda dan Bird adalah sebuah trunk SIP. SIP (Session Initiation Protocol) membangun panggilan antar sistem telepon. Bird memberikan workspace Anda sebuah alamat trunk, yang digunakan sistem telepon Anda untuk panggilan keluar ke jaringan telepon, dan yang digunakan Bird secara sebaliknya untuk mengirimkan panggilan yang masuk ke nomor Anda.
Anda tidak perlu sistem telepon untuk melakukan panggilan pertama: telepon di dashboard langsung melakukan panggilan dari browser, melalui salah satu trunk Anda.
Anda juga dapat membuat sequence di dashboard dan memulainya dengan API Create Call. Sequence menangani pesan suara, pilihan keypad, dan perutean panggilan setelah penerima menjawab.
Cara panggilan dilakukan
Sistem telepon Anda mengirim SIP INVITE ke alamat trunk untuk memulai panggilan. Bird memeriksa caller ID, negara tujuan, batas, dan saldo wallet sebelum menghubungi carrier. Jika panggilan lolos, Bird merutekannya dan meneruskan audio. Setiap koneksi adalah satu leg. Ketika sebuah leg berakhir, Bird menulis catatannya di Voice > Leg dan mengirimkan voice_call.ended event.
Panggilan yang gagal melewati pemeriksaan ditolak sebelum carrier terlibat, dan alasan spesifiknya dicatat pada catatan leg. Melakukan panggilan membahas apa yang Bird baca dari setiap panggilan, dan Panggilan ditolak mencantumkan setiap alasan penolakan beserta cara mengatasinya.
Cara panggilan masuk dijawab
Setiap nomor dalam workspace Anda memiliki satu tindakan untuk panggilan masuk pada satu waktu, yang diatur pada nomor tersebut: meneruskan panggilan ke salah satu trunk SIP Anda, meneruskannya ke nomor yang telah Anda verifikasi, menjalankan sequence yang telah dipublikasikan, atau menolaknya. Setiap nomor baru menolak panggilan secara default, sehingga nomor yang belum dikonfigurasi menolak penelepon.
Saat panggilan masuk, Bird memeriksa batas akun dan wallet dengan cara yang sama seperti saat Anda melakukan panggilan, lalu menjalankan jawaban yang diatur pada nomor tersebut dan mencatat jawaban apa yang berlaku pada panggilan itu. Menerima panggilan membahas cara mengarahkan nomor ke sebuah jawaban, apa yang ditampilkan forward kepada penerima, dan cara membaca penolakan.
Sebelum panggilan pertama Anda
Untuk panggilan melalui perangkat SIP Anda sendiri, siapkan hal berikut. Panggilan melalui API mengikuti prasyarat Create Call.
- Buat trunk SIP, aktifkan panggilan keluar, dan izinkan pemanggil di trunk tersebut: rentang IP atau kunci API untuk perangkat Anda sendiri, kredensial sesi untuk browser atau CLI.
- Pilih caller ID yang memenuhi syarat: gunakan nomor yang dimiliki workspace Anda melalui Bird, atau daftarkan nomor eksternal dan konfirmasi dengan panggilan verifikasi.
- Aktifkan destinasi Anda: aktifkan negara-negara yang Anda tuju.
Lakukan panggilan pertama Anda memandu Anda melalui ketiga persyaratan dan diakhiri dengan panggilan sungguhan.
Membaca catatan panggilan memerlukan voice:read; melakukan panggilan memerlukan voice:write. Mengelola trunk, rute nomor, caller ID, dan sequence menggunakan izin voice_management. Akses ke halaman tidak memberikan izin untuk mengubah pengaturannya atau melakukan panggilan berbayar.
Aplikasi Voice di dashboard
| Halaman | Fungsi |
|---|---|
| Metrik | Volume panggilan dan tingkat jawaban dari waktu ke waktu, hasil panggilan, negara teratas, serta pembagian masuk dan keluar. Lihat Metrik Voice |
| Leg | Catatan per leg untuk panggilan workspace, dengan total penggunaan bulan berjalan |
| Panggilan | Leg dan peserta terkait yang dikelompokkan dalam satu panggilan |
| Nomor | Setiap nomor yang dapat digunakan workspace untuk voice, dan apa yang dilakukan masing-masing nomor terhadap panggilan masuk |
| Trunk SIP | Trunk Anda, domain SIP trunk tersebut, siapa yang boleh mengirim trafik ke trunk tersebut, dan ke mana panggilan masuk dikirimkan |
| Tujuan | Negara-negara yang boleh ditelepon workspace Anda, nonaktif secara default |
| Sequence | Membuat, meninjau pratinjau, memublikasikan, dan memeriksa eksekusi alur panggilan |
| Telepon | Telepon mengambang yang melakukan panggilan dari browser, melalui salah satu trunk Anda |
Visibilitas
Satu panggilan dapat memiliki beberapa leg. Log memiliki satu catatan per leg, baik yang tersambung, berdering tanpa jawaban, maupun ditolak. Panggilan yang diteruskan atau melibatkan banyak pihak dapat menghasilkan beberapa entri:
- Log leg: tampilan per leg di halaman Leg. Status, kedua nomor, trunk tempat leg masuk, respons SIP saat leg berakhir, waktu jawab dan waktu selesai, durasi yang ditagih, dan biaya. Filter hasilnya, lalu ekspor sebagai CSV.
- Peristiwa Voice: voice_call.initiated, voice_call.answered, dan voice_call.ended yang dikirimkan ke endpoint Anda sendiri, sehingga sistem Anda mengetahui panggilan tanpa perlu polling.
Referensi API mencantumkan kontrak publik HTTP dan metode SDK yang didukung. Referensi CLI dan referensi tool MCP menjelaskan operasi yang dipublikasikan. Permukaan ini dapat mengekspos operasi yang berbeda; tindakan di dashboard atau perintah CLI tidak dengan sendirinya menetapkan metode SDK publik.
Batas
Tiga batas berlaku untuk panggilan Anda, di kedua arah: berapa banyak panggilan yang boleh berlangsung sekaligus, berapa panggilan baru per detik, dan berapa yang boleh Anda belanjakan untuk voice dalam satu hari UTC. Masing-masing diatur per organisasi, dan jumlahnya bergantung pada paket Anda. Panggilan yang melebihi salah satu batas ditolak saat penyiapan, dan catatannya menyebutkan batas mana, di bawah Panggilan ditolak.
Batas per detik adalah kebijakan voice_call di Pembatasan laju permintaan, yang juga menjelaskan cara batas efektif Anda ditentukan dan cara meminta kapasitas tambahan.
Langkah selanjutnya
| Halaman | Isi pembahasan |
|---|---|
| Lakukan panggilan pertama Anda | Dari workspace kosong hingga telepon berdering |
| Telepon | Menelepon dari dashboard, apa yang dibutuhkan, dan apa yang bisa Anda lakukan saat panggilan berlangsung |
| Trunk SIP | Membuat trunk, detail koneksinya, dan mengontrol siapa yang boleh mengirim |
| Melakukan panggilan | Apa yang diharapkan Bird pada INVITE, dan berapa biaya panggilan |
| Menerima panggilan | Mengarahkan nomor ke trunk atau forward, dan apa yang dicatat |
| Caller ID | Mendaftarkan nomor dan membuktikan kepemilikan dengan panggilan verifikasi |
| Tujuan Voice | Mengaktifkan negara tujuan panggilan Anda, dan arti risiko tinggi |
| Log leg | Menelusuri, memfilter, dan mengekspor catatan leg Anda |
| Peristiwa Voice | Tiga event panggilan dan payload-nya |
| Pemecahan masalah | Mendiagnosis panggilan yang gagal, berdasarkan gejalanya |
| Webhook dan peristiwa | Penyiapan endpoint, verifikasi tanda tangan, percobaan ulang, dan replay |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.