FAQ
Pertanyaan umum notifikasi suara: autentikasi integrasi, hasil pengiriman, negara template, dan push CDR.
Kumpulan pertanyaan yang sering muncul seputar integrasi dan penggunaan notifikasi suara. Rujukan cepat kode error lihat Kode Error.
Integrasi dan Autentikasi
Kredensial apa yang perlu disertakan dalam permintaan?
Header permintaan Authorization: Bearer {API_KEY}; API Key dibuat di Console > Developers; antarmuka voice untuk sementara belum mendukung verifikasi tanda tangan CheckSum. Lihat Autentikasi.
Bagaimana menelusuri respons 401?
Pastikan berurutan: permintaan menyertakan header Authorization, API Key benar dan belum dihapus, serta akun/API Key/otorisasi produk semuanya berada dalam status berlaku. Skenario terkait lihat baris HTTP 401 pada Kode Error.
Mengembalikan 403 「IP 不在白名单」 (IP tidak ada dalam whitelist)?
Whitelist IP adalah konfigurasi wajib: bila API Key belum dikonfigurasi whitelist, semua permintaan akan ditolak. Konfigurasikan whitelist IP egress untuk API Key di platform sebelum memanggil; beberapa catatan whitelist digabungkan (union) dan perubahan berlaku paling lambat sekitar 60 detik.
Pengiriman dan Hasil
API mengembalikan 000000, mengapa penerima tidak mendapat panggilan?
000000 hanya berarti tugas berhasil diterima. Panggilan keluar aktual mungkin tidak tersambung, sedang menunggu panggil ulang, atau mengalami gangguan jalur. Gunakan Catatan Pengiriman untuk melihat status dan kode terminasi per panggilan.
Apa makna panggil ulang? Apakah menambah biaya?
Panggilan yang tidak tersambung dipanggil ulang otomatis sesuai strategi retry yang Anda konfigurasi (jumlah/interval/kondisi pemicu); setiap panggilan keluar aktual ditagih normal. Bila tidak ingin panggil ulang, setel maxCount=0.
Muncul 120002 「号码不在测试白名单」 (nomor tidak ada di whitelist pengujian)?
Selama pengembangan dan debugging, akun dibatasi whitelist pengujian dan hanya boleh memanggil nomor di dalam whitelist. Tambahkan nomor ke whitelist melalui alur Quick Start Console (maksimum 20 entri).
Muncul 120003 「号码与模板国家区号不匹配」 (nomor tidak cocok dengan kode negara template)?
Nomor penerima harus memakai kode panggilan negara template (format E.164). Periksa kode panggilan nomor dan negara template; tabel kode lihat Kode Negara/Wilayah.
Kapan tugas terjadwal dikirim?
Saat scheduling.type=SCHEDULED, platform melakukan panggilan keluar dalam jendela [startTime, endTime] yang Anda tentukan; jendela maksimum 8 hari. Tugas yang telah diterima tidak dapat ditarik kembali — periksa kembali jendelanya sebelum mengirim.
Apakah kegagalan sebagian nomor dalam batch memengaruhi nomor lain?
Tidak. Setelah diterima, setiap panggilan keluar berjalan mandiri; kegagalan satu panggilan tidak memengaruhi nomor lain dalam batch. Hanya kegagalan validasi seluruh batch sebelum penerimaan yang menolak seluruh permintaan.
Template dan Negara
Berapa lama review template? Di mana melihat statusnya?
Setelah dikirim, template masuk alur review (0-Menunggu review → 1-Disetujui / 2-Ditolak); cek status di Manajemen Template Console atau API Daftar Template. Mengirim sebelum review disetujui mengembalikan 120004.
Bisakah berganti negara tanpa mengubah template?
Tidak. Negara diikat saat template dibuat, dan perutean serta penagihan panggilan diturunkan dari negara template; untuk mengirim ke negara lain, buat template negara yang bersangkutan.
Bagaimana membuat template audio?
Unggah melalui API Template (contentType=2, mp3/wav/m4a, dikodekan base64, di bawah 2 MB setelah dekode); Console saat ini mendukung template teks.
Bagaimana bahasa pembacaan TTS ditentukan?
Ditentukan oleh mesin TTS yang dipilih template (Console mendukung audisi mesin); tidak perlu mengirim kode bahasa saat memanggil API.
CDR dan Push
Webhook tidak menerima push?
Periksa berurutan: alamat callback telah dikonfigurasi di platform, layanan receiver dapat dijangkau dari internet publik, respons 2xx, dan panggilan sudah mencapai status akhir. Versi saat ini tidak me-retry push yang gagal; gunakan API Kueri sebagai fallback rekonsiliasi. Selengkapnya lihat Melihat Hasil.
Bagaimana memverifikasi push berasal dari platform?
Setelah kredensial tanda tangan dikonfigurasi, push menyertakan header X-CALLBACK-ID; verifikasi signature heksadesimal huruf kecil dengan HMAC-SHA256(secret, timestamp + nonce + username). Contoh verifikasi lihat Push CDR.
API kueri tidak menemukan CDR?
Pastikan jendela kueri dalam 90 hari terakhir, countryCode sesuai negara panggilan, dan paginasi page/size benar; untuk tugas yang baru diterima, tunggu sejenak sebelum mengueri.
Lainnya
Apakah notifikasi suara mendukung interaksi tombol (IVR)?
Versi saat ini berupa panggilan keluar satu arah untuk skenario notifikasi; tidak mendukung interaksi tombol dan alur bercabang.
Ingin menampilkan nomor pengirim sendiri?
Ikat nomor pengirim terlebih dahulu (hubungi tim komersial/operasional) lalu tentukan melalui from saat mengirim; nomor yang belum diikat akan gagal dikirim. Tanpa from, memakai rute default negara.
Sumber Terkait
Terakhir diperbarui pada