Pusat pertanyaan Notivia

37 pertanyaan yang paling sering masuk, dari integrasi API sampai kuota dan kepatuhan. Cari kata kuncinya, jawabannya langsung muncul.

Sering dicari

Menampilkan pertanyaan untuk “

|

Belum ada yang cocok dengan pencarianmu

Coba kata kunci lain, atau tanyakan langsung ke tim kami.

Tanya via WhatsApp

Dasar

Pengenalan Notivia dan cara kerjanya secara garis besar.

Notivia adalah platform API untuk mengirim pesan WhatsApp ke pelanggan bisnismu: kode verifikasi (OTP), notifikasi status transaksi, serta bukti dan label transaksi. Sistemmu cukup memanggil satu endpoint, Notivia yang mengurus pengiriman, kuota, dan pencatatan statusnya.

Notivia dijalankan oleh PT Sinergi Mania Teknologi dan berjalan di atas WhatsApp Business Platform milik Meta.

Cocok untuk bisnis yang butuh mengirim pesan otomatis ke pelanggan dalam volume rutin, misalnya:

  • Toko online dan marketplace: konfirmasi pesanan, nomor resi, label pengiriman.
  • Aplikasi dan layanan digital: OTP login, verifikasi pendaftaran, reset sandi.
  • Fintech, PPOB, dan agregator: struk transaksi, tagihan, pengingat jatuh tempo.
  • Logistik dan kurir: status paket dan bukti pengantaran.

Tidak wajib. Pesan dikirim melalui nomor pengirim yang sudah dikelola Notivia, jadi kamu bisa langsung mulai tanpa proses pendaftaran nomor sendiri ke Meta.

Kalau bisnismu ingin memakai nomor dan nama pengirim sendiri (brand kamu yang muncul di WhatsApp pelanggan), itu bisa diatur terpisah. Hubungi tim kami untuk pembahasannya.

Ya. Notivia terdaftar sebagai Tech Provider resmi Meta dengan akun bisnis terverifikasi, dan mengirim pesan melalui WhatsApp Business Platform. Artinya pengiriman mengikuti aturan resmi Meta, bukan lewat modifikasi aplikasi WhatsApp.

Konsekuensinya juga jelas: pesan harus berbasis template yang disetujui, dan penerima harus sudah menyetujui (opt-in) untuk dihubungi.

Umumnya hitungan menit setelah pembayaran terverifikasi. Alurnya: daftar akun, pilih paket, bayar, paket aktif otomatis, token API muncul di dashboard, lalu panggil endpoint.

Yang biasanya memakan waktu hanya kalau kamu butuh template baru yang khusus, karena template harus melewati review Meta.

Aplikasi blast umumnya menempel ke aplikasi WhatsApp biasa dan mengirim pesan massal tanpa aturan, sehingga nomor mudah diblokir dan pesan tidak punya jaminan status.

Notivia berjalan di jalur resmi: pesan berbasis template, ada pencatatan status per pesan (terkirim, sampai, gagal), ada kuota dan riwayat yang bisa diaudit, serta rate limit yang melindungi reputasi nomor pengirim.

Integrasi & API

Token, endpoint, parameter, dan hal teknis saat menghubungkan sistemmu.

Ambil token API di menu Token pada dashboard, lalu kirim request HTTP biasa ke base URL berikut dengan header Authorization:

POST https://notivia.asia/api/v1/otp
Authorization: Bearer ntv_xxxxxxxx
Content-Type: application/json

{
  "recipient": "08123456789",
  "code": "739201",
  "template": "otp_notivia"
}

Dokumentasi lengkap beserta contoh untuk tiap endpoint tersedia di dashboard setelah kamu masuk.

  • POST /api/v1/otp untuk kode verifikasi. Cukup kirim nomor tujuan dan kode.
  • POST /api/v1/messages untuk pesan berbasis template dengan parameter, misalnya notifikasi transaksi atau label resi.
  • POST /api/v1/broadcasts untuk mengirim satu pesan ke banyak penerima sekaligus (maksimal 1.000 penerima per request) dan mengembalikan ringkasan per penerima.

Tidak perlu. API Notivia adalah HTTP + JSON standar, jadi bisa dipanggil dari bahasa dan framework apa pun: PHP/Laravel, Node.js, Python, Go, Java, .NET, bahkan langsung dari curl atau tool automasi seperti n8n dan Zapier.

Isi params bersifat posisional: item pertama mengisi variabel {{1}} pada body template, item kedua mengisi {{2}}, dan seterusnya sesuai urutan di template.

Kalau template punya tombol dengan link dinamis, parameter untuk tombol itu diletakkan paling akhir. Jumlah parameter harus pas, kalau tidak sesuai kamu akan menerima error invalid_params.

Halaman Template di dashboard menampilkan jumlah parameter yang dibutuhkan tiap template, jadi tidak perlu menebak.

Ada, untuk menjaga kesehatan nomor pengirim dan mencegah penyalahgunaan:

  • Maksimal 60 request per menit dan 1.000 request per jam per token.
  • Khusus OTP: maksimal 4 OTP per 5 menit dan 30 OTP per hari ke nomor tujuan yang sama.
  • Kalau terlampaui, response berstatus 429 dengan header Retry-After berisi jumlah detik yang harus ditunggu.

Request yang ditolak karena rate limit tidak memotong kuota paketmu.

Setiap pengiriman tercatat. Response API langsung memberi status awal (sent atau gagal beserta alasannya), lalu status final seperti delivered dan failed menyusul dari WhatsApp.

Semua itu bisa dipantau di menu Pesan pada dashboard, lengkap dengan waktu, nomor tujuan, template yang dipakai, dan alasan kegagalan bila ada.

  • no_active_subscription: belum ada langganan aktif atau paket sudah kedaluwarsa.
  • package_service_not_allowed: paketmu tidak mencakup jenis pesan tersebut (misalnya paket verifikasi dipakai mengirim marketing).
  • country_not_allowed: nomor tujuan di luar cakupan negara paketmu.
  • no_approved_template: template tidak ditemukan atau belum diaktifkan untuk akunmu.
  • invalid_params: jumlah parameter tidak sesuai template.
  • 429: kena rate limit, coba lagi setelah Retry-After.

Segera buat token baru dari menu Token di dashboard. Token lama akan berhenti berlaku, jadi pastikan sistemmu sudah memakai token yang baru.

Simpan token di server side saja (environment variable atau secret manager). Jangan menaruh token di aplikasi mobile, kode front end, atau repositori publik.

Template Pesan

Kenapa pesan berbasis template dan bagaimana mengelolanya.

Itu aturan WhatsApp Business Platform. Pesan yang dikirim atas inisiatif bisnis (bukan menjawab pelanggan) harus memakai template yang sudah disetujui Meta. Aturan ini yang membuat pesanmu tidak dianggap spam dan nomor pengirim tetap sehat.

Bagian yang berubah-ubah, seperti nama pelanggan, nomor resi, nominal, atau kode OTP, dikirim sebagai parameter. Jadi satu template bisa dipakai untuk ribuan pesan berbeda.

Buka menu Template di dashboard. Di sana ada katalog template yang tersedia beserta jumlah parameternya. Pilih template yang kamu butuhkan, lalu tim Notivia mengaktifkannya untuk akunmu.

Setelah aktif, template langsung bisa dipanggil lewat API dengan menyebut namanya pada field template.

Bisa. Kirim rancangan isi pesannya (termasuk bagian mana yang jadi variabel dan tombol apa yang diinginkan) ke tim kami. Kami bantu susun sesuai aturan Meta, lalu ajukan untuk review.

Beberapa hal yang biasanya ditolak Meta: kalimat promosi pada template kategori utility, tautan yang tidak jelas tujuannya, dan permintaan data sensitif.

Umumnya cepat, dari beberapa menit sampai beberapa jam. Meta memberi batas maksimal 24 jam untuk proses review, dan keputusannya sepenuhnya di pihak Meta.

Kalau ditolak, kami akan menyesuaikan redaksinya dan mengajukan ulang. Status template terlihat di dashboard.

Di posisi paling akhir pada array params. Jadi kalau body template punya dua variabel dan ada satu tombol URL dinamis, kirim tiga parameter: dua untuk body, satu terakhir untuk URL tombol.

Ya, OTP memakai template kategori Authentication dan cukup satu parameter, yaitu kodenya. Gunakan endpoint /otp supaya penanganannya benar, termasuk tombol salin kode di WhatsApp pelanggan.

Isi pesan OTP tidak bisa dikarang bebas karena formatnya sudah ditentukan Meta, termasuk peringatan agar kode tidak dibagikan ke siapa pun.

Paket & Pembayaran

Kuota, tagihan, masa aktif, dan cara membayar.

Detail paket dan harga ditampilkan di dashboard setelah kamu masuk, karena isi paket bisa disesuaikan dengan kebutuhan dan volume tiap bisnis. Pendaftaran akun gratis dan tidak mengikat.

Butuh penawaran untuk volume besar atau kebutuhan khusus? Hubungi kami lewat WhatsApp, kami bantu susun paketnya.

  • Verifikasi (OTP): khusus kode verifikasi dan autentikasi.
  • Utility & Marketing: notifikasi transaksi, info, pengingat, sampai pengumuman dan promo.
  • Lintas negara: menjangkau nomor Indonesia (+62) dan Malaysia (+60) dalam satu paket.

Setiap jenis punya beberapa tier sesuai volume harian, jadi kamu bisa naik tier saat kebutuhan bertambah.

Kuota dihitung per hari sesuai tier paketmu dan kembali penuh setiap hari selama masa aktif berjalan.

Yang memotong kuota hanya pesan yang benar-benar diproses untuk dikirim. Request yang ditolak karena rate limit atau validasi (misalnya invalid_params) tidak memotong kuota.

Pengiriman tetap bisa berjalan, dan kelebihannya dicatat sebagai biaya tambahan (overage) pada tagihan. Rinciannya transparan: halaman Tagihan di dashboard menampilkan pesan mana saja yang terhitung biaya tambahan, dan bisa diekspor ke CSV.

Kalau kelebihan terjadi rutin, biasanya lebih hemat naik ke tier yang lebih tinggi.

Tiga langkah: pilih paket, pilih metode pembayaran, lalu bayar sesuai nominal yang tertera. Pembayaran terverifikasi otomatis dan paket aktif dalam hitungan menit tanpa perlu mengirim bukti transfer manual.

Riwayat pembayaran dan invoice tersimpan di dashboard.

Setiap paket punya durasi aktif. Menjelang habis, kamu mendapat pemberitahuan supaya layanan tidak terputus, dan perpanjangan bisa dilakukan sendiri dari dashboard.

Kalau paket berakhir, panggilan API akan menerima error no_active_subscription sampai paket diperpanjang.

Kepatuhan & Keamanan

Aturan pengiriman, data pelanggan, dan hal yang harus dihindari.

Tidak. Sesuai kebijakan Notivia dan Meta, pesan hanya boleh dikirim ke orang yang sudah menyetujui (opt-in) untuk dihubungi, misalnya pelanggan yang mendaftar, bertransaksi, atau meminta layanan di sistemmu.

Mengirim ke database nomor yang dibeli atau dikumpulkan tanpa izin adalah pelanggaran dan dapat menyebabkan akun dinonaktifkan.

Mengikuti kebijakan Meta, antara lain: perjudian, pinjaman ilegal, obat dan suplemen tanpa izin, produk dewasa, senjata, penipuan atau peniruan identitas pihak lain, serta permintaan data sensitif seperti sandi dan nomor kartu penuh.

Kalau ragu apakah kasus penggunaanmu diizinkan, tanyakan lebih dulu ke tim kami sebelum integrasi.

Kami menyimpan catatan pengiriman (nomor tujuan, template, parameter, waktu, status) karena itu yang membuat riwayat, laporan status, dan penagihan bisa dipertanggungjawabkan.

Data hanya dipakai untuk menjalankan layanan dan tidak dijual ke pihak lain. Rinciannya ada di Kebijakan Privasi.

Saat ini fokus ke Indonesia (+62), dan Malaysia (+60) melalui paket lintas negara. Nomor di luar cakupan paket akan ditolak dengan error country_not_allowed.

Butuh negara lain? Sampaikan ke tim kami untuk dicek ketersediaan dan tarifnya.

Bila terbukti mengirim tanpa opt-in, mengirim konten yang dilarang, atau memicu laporan spam dari penerima dalam jumlah tidak wajar. Hal seperti ini juga berdampak ke kualitas nomor pengirim di sisi Meta, sehingga kami menanggapinya serius.

Kami akan menghubungi kamu lebih dulu bila ada pola pengiriman yang mencurigakan, kecuali pelanggarannya berat.

Kendala Umum

Kasus yang paling sering ditanyakan saat pesan tidak sesuai harapan.

  • Nomor tujuan tidak terdaftar di WhatsApp atau salah format.
  • Template belum diaktifkan untuk akunmu (no_approved_template).
  • Jumlah parameter tidak sesuai template (invalid_params).
  • Kuota harian habis atau paket sudah berakhir.
  • Jenis pesan tidak dicakup paket, misalnya marketing pada paket verifikasi.

Alasan spesifik selalu tercatat di menu Pesan, jadi mulailah pengecekan dari sana.

Boleh 08123456789 atau 628123456789, keduanya diterima dan dinormalkan otomatis. Hindari spasi, tanda hubung, tanda plus, dan awalan seperti +62 0.

Untuk nomor Malaysia, pakai format 60xxxxxxxxx.

Berarti request melewati batas laju. Baca header Retry-After, tunggu selama detik yang disebutkan, lalu coba lagi.

Untuk pengiriman banyak, gunakan antrean di sistemmu (misalnya queue worker) agar request tersebar, dan beri jeda minimal 60 detik sebelum mengirim ulang OTP ke nomor yang sama.

Status delivered baru muncul setelah ponsel penerima menerima pesannya. Kalau ponsel sedang mati, tanpa internet, atau memori penuh, statusnya tetap sent sampai perangkatnya kembali online.

Kalau statusnya tidak berubah sangat lama, kemungkinan nomor tersebut tidak aktif di WhatsApp.

Balasan pelanggan masuk dan tercatat di sistem, sehingga tidak ada pesan yang hilang, dan bisa ditindaklanjuti bersama tim kami sesuai kebutuhan layananmu.

Fitur AI Agent yang menjawab pertanyaan pelanggan secara otomatis dan meneruskan ke manusia bila perlu sedang kami siapkan dan segera hadir.

Bisa. Hubungi kami lewat WhatsApp di +62811-133-220 atau email info@notivia.asia.

Supaya cepat tertangani, sertakan: endpoint yang dipanggil, contoh payload (tanpa token), waktu percobaan, dan response yang kamu terima.