Kirim Notifikasi Suara Pertama Anda
Alur lengkap dari aktivasi hingga panggilan notifikasi suara pertama Anda.
Notifikasi suara melakukan panggilan suara ke nomor ponsel dan memutar konten template melalui TTS, cocok untuk skenario seperti pengingat pesanan, notifikasi logistik, undangan rapat, dan peringatan risiko. Halaman ini memandu Anda menyelesaikan panggilan suara pertama Anda dari nol.
Prasyarat
- Produk voice telah diaktifkan (hubungi tim komersial jika belum)
- Satu API Key: dibuat di Console > Developers, lihat Autentikasi
- API Key harus memiliki whitelist IP yang dikonfigurasi, dan IP egress permintaan harus ada di dalamnya (semua permintaan ditolak bila whitelist tidak dikonfigurasi)
Alur Penggunaan Umum
Buat Template dan Kirim untuk Review
Konten panggilan ditentukan oleh template. Buat template teks baru di halaman Manajemen Template pada konsol produk voice di Console (variabel dinyatakan dengan placeholder ordinal {1}, {2}), atau buat melalui API Template; setelah dikirim untuk review dan statusnya berubah menjadi Disetujui, catat templateId. Untuk selengkapnya lihat Menggunakan Konsol Voice.
Konfirmasi negara template
Negara/wilayah (kode alpha-2) yang dikaitkan saat pembuatan template menentukan perutean dan penagihan panggilan; kode negara tidak perlu dikirim pada permintaan kirim. Lihat Kode Negara/Wilayah.
Mulai Panggilan
Panggil API pengiriman, ganti {BASE_URL} dengan alamat akses dan {API_KEY} dengan API Key Anda:
curl -X POST '{BASE_URL}/open/v1/voice/notify/batch' \
-H 'Authorization: Bearer {API_KEY}' \
-H 'Content-Type: application/json;charset=utf-8' \
-d '{
"bulkId": "first-voice-call-001",
"messages": [
{
"templateId": "Tpl_0001",
"destinations": [
{ "to": "8613800138000", "variables": ["Budi", "A12345"] }
]
}
]
}'Array variables sesuai urutan placeholder template {1}…{n}; abaikan jika template tidak memiliki variabel. Negara panggilan diturunkan dari template, tidak perlu mengirim kode negara.
Jika code yang dikembalikan adalah 000000, permintaan berhasil diterima; catat data.callId untuk penelusuran masalah selanjutnya:
{
"code": "000000",
"message": "success",
"data": {
"bulkId": "first-voice-call-001",
"callId": "YYYX931******64224",
"acceptedCount": 1
}
}Panggilan benar-benar dilakukan ke jaringan publik dan menimbulkan biaya; verifikasi efek template dan variabel dengan nomor uji terlebih dahulu.
Lihat Hasil Pengiriman
Lihat rincian panggilan (hasil panggilan, kode terminasi, durasi percakapan, waktu inisiasi) di halaman Catatan Pengiriman pada konsol produk voice di Console; mendukung filter berdasarkan nomor penerima dan hasil panggilan. Anda juga dapat memanggil API query catatan pengiriman untuk mengambil catatan panggilan per tugas/nomor, lihat Pesan Suara.
Langkah Berikutnya
Terakhir diperbarui pada