Memahami Notifikasi Suara
Pengenalan produk notifikasi suara: alur panggilan, ringkasan kemampuan, dan jalur integrasi.
Notifikasi suara (Voice Notification) melakukan panggilan suara nyata ke nomor ponsel dan, setelah tersambung, memutar konten template melalui TTS (atau memutar rekaman audio). Cocok untuk skenario yang menuntut jangkauan kuat seperti pengingat pesanan, notifikasi logistik, undangan rapat, peringatan risiko, dan pengingat verifikasi. Dibandingkan SMS, panggilan telepon memberi kesan kedatangan yang lebih kuat, cocok untuk notifikasi penting dengan urgensi tinggi.
Prasyarat
- Produk voice telah diaktifkan dan API Key telah dibuat (lihat bagian persiapan di Quick Start)
- Pahami dua konsep dasar: template (konten yang dibacakan saat panggilan, wajib lolos review) dan tugas (panggilan sekaligus ke sekelompok nomor)
Alur Panggilan
Siklus hidup lengkap satu notifikasi suara:
- Pengiriman: kirim sekelompok nomor beserta template melalui Tugas Panggilan Console atau API Pengiriman
- Penerimaan: platform memvalidasi parameter, template, dan saldo sebelum menerima tugas (API mengembalikan
000000dancallId) - Panggilan keluar: platform memilih jalur sesuai negara yang terikat pada template lalu melakukan panggilan; bila tidak tersambung, diulang sesuai strategi panggil ulang yang dikonfigurasi
- Status akhir: setiap panggilan mencapai status akhir (tersambung lalu berakhir / tidak dijawab / tidak dapat dihubungi)
- Hasil: ambil hasil tiap panggilan melalui Catatan Pengiriman, API Kueri, atau Push CDR
000000 berarti tugas berhasil diterima, bukan berarti setiap panggilan telah tersambung. Hasil per panggilan mengacu pada catatan pengiriman/kueri/push.
Ringkasan Kemampuan
| Kemampuan | Penjelasan |
|---|---|
| Template teks (TTS) | Placeholder variabel {1}…{n}, nilai dikirim per nomor |
| Template audio | Unggah mp3/wav/m4a (di bawah 2 MB), memutar konten rekaman |
| Variabel per nomor | Setiap penerima dapat membawa nilai variabelnya sendiri |
| Tugas terjadwal | Kirim dalam jendela waktu yang ditentukan |
| Strategi panggil ulang | Jumlah/interval/kondisi pemicu dapat dikonfigurasi |
| SMS hang-up | Kirim SMS susulan ke penerima setelah panggilan |
| Pengambilan hasil | Tiga jalur: catatan Console / API kueri / push Webhook |
Batasan: saat ini berupa panggilan keluar satu arah untuk skenario notifikasi; tidak mendukung interaksi tombol IVR, menerima panggilan masuk, maupun pemrosesan suara selain unggahan rekaman.
FAQ
Mengapa masih bisa gagal setelah diterima oleh API?
Penerimaan hanya menyelesaikan validasi parameter dan resource; panggilan keluar aktual dipengaruhi oleh status penerima, jalur, dan perutean negara. Untuk hasil per panggilan lihat Catatan Pengiriman; penyebab kegagalan lihat Kode Error.
Dari mana sebaiknya memulai?
Urutan yang disarankan: Quick Start (kirim satu panggilan nyata dengan whitelist pengujian) → Menggunakan Konsol Voice → Melakukan Panggilan → Referensi API.
Sumber Terkait
Terakhir diperbarui pada