Apa itu voice API?

Callback, menu telepon, dan asisten suara menggunakan bagian berbeda dari platform panggilan.

Apa yang dapat dikontrol voice API?

Voice API dapat menyediakan konfigurasi, call control, dan pelaporan, dengan operasi yang didukung ditentukan oleh penyedia layanan.

Konfigurasi mencakup trunk, identitas pemanggil, tujuan, dan routing nomor. Call control mencakup perilaku di dalam percakapan, seperti prompt atau input keypad. Pelaporan mengembalikan status panggilan, durasi, dan hasil tercatat lainnya.

Penyedia layanan mengekspresikan call control secara berbeda. TwiML milik Twilio, misalnya, mendeskripsikan aksi melalui instruksi yang dikembalikan ke Twilio. Memindahkan aplikasi berarti memetakan perilaku dan ekspektasi callback-nya, bukan sekadar mengganti hostname.

Metode yang membaca panggilan bukan operasi yang memulai panggilan.

Bagaimana API dan SIP bekerja bersama?

API aplikasi dapat mengonfigurasi atau mengontrol layanan, sementara SIP membuat sesi telepon di bawahnya.

SIP, protokol signaling panggilan, membuat, memodifikasi, dan mengakhiri sesi. Protokol ini menegosiasikan cara peserta terhubung. RTP membawa media real-time seperti audio.

Jalur-jalur tersebut dapat gagal secara independen. Panggilan bisa berdering sementara pengaturan media atau jalur jaringan mencegah satu peserta mendengar peserta lainnya. Uji audio di kedua arah serta dering dan pemutusan.

PBX, sistem telepon bisnis yang merutekan panggilan, dapat mempertahankan penanganan panggilannya sambil menggunakan trunk SIP dari penyedia layanan. Runtime percakapan dapat menggunakan koneksi serupa sambil menyediakan sendiri fitur ucapan dan alat bisnisnya.

Apa yang dapat saya baca tentang panggilan?

Catatan panggilan mengidentifikasi percobaan dan melaporkan status yang teramati. Field yang tersedia bergantung pada operasi dan tahap panggilan.

• Koneksi: apakah panggilan diterima, berdering, dan mendapat jawaban.
• Media: apakah peserta dapat mendengar dan berinteraksi satu sama lain.
• Hasil bisnis: apakah janji temu, callback, atau tugas dukungan yang dimaksud telah selesai.

Panggilan telepon yang dijawab bisa sampai ke seseorang, voicemail, atau sistem otomatis lain. Catatan panggilan saja tidak dapat membuktikan bahwa pelanggan menyelesaikan tugas.

Event membantu aplikasi Anda bereaksi terhadap perubahan. Tangani duplikat dan pengiriman terlambat, lalu rekonsiliasi pembaruan yang hilang atau tidak pasti terhadap status tercatat dari penyedia layanan.

Bagaimana cara membangun ini dengan Bird?

Anda mengonfigurasi panggilan keluar dengan trunk SIP, caller ID terverifikasi, dan negara tujuan yang diaktifkan.

Perubahan konfigurasi memerlukan voice_management pada level write.

Pada trunk, outbound_enabled harus bernilai true. domain-nya adalah alamat yang dihubungi klien SIP Anda. Autentikasi API-key mencantumkan kunci Anda di allowed_api_key_ids; kunci tersebut memerlukan voice pada level write. Memperbarui daftar ini menggantikan semua entri, jadi pertahankan kunci yang masih digunakan klien lain.

Caller ID Anda memerlukan status: verified, yang mengonfirmasi bahwa workspace Anda telah menyelesaikan panggilan verifikasinya. phone_number-nya berisi nomor internasional, termasuk + di depan.

Negara tujuan memerlukan enabled: true dan status: available. Mengaktifkan negara tidak membuat tujuan yang tidak didukung dapat dipanggil.

Browser phone juga memerlukan session_credentials_enabled: true pada trunk serta MD5 dalam digest_algorithms trunk.

Setelah panggilan, Anda memeriksa status, rejection_reason, dan sip_response_code. Operasi daftar leg dan baca leg mengembalikan kolom tersebut. Operasi ini melaporkan percobaan panggilan. Aplikasi SIP Anda yang memulainya.

Untuk menu telepon, Anda mengonfigurasi prompt dan cabang keypad di aplikasi yang terhubung. Runtime voice AI menyediakan ucapan, penalaran, dan alat bisnis untuk percakapan.