Push notification untuk aplikasi Anda: satu API, satu platform
Kirim push notification ke pengguna aplikasi Anda dari REST API yang sama dengan SMS, WhatsApp, dan RCS, lalu jangkau mereka yang belum membuka aplikasi lewat kanal lain.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'Permintaan push notification ke API OmniChannels.ai. Nilai adalah data contoh.
Jawaban singkat
Diperbarui
OmniChannels.ai adalah layanan dan API push notification untuk aplikasi seluler. Anda memanggil POST /push/message/send dengan judul, isi pesan, dan audiens: user ID, device token, topik, atau segmen. Notifikasi dapat memuat gambar, deep link, dan tombol aksi, memakai template tersimpan, dijadwalkan, serta divalidasi lebih dulu dengan dry run. Tim kami menghubungkan proyek Firebase Cloud Messaging Anda dan, untuk iOS, kredensial APNs saat onboarding.
Fungsi API push notification
Targetkan per pengguna, token, topik, atau segmen
Gunakan user ID Anda sendiri (userRefs), device token FCM tertentu, topik FCM, atau segmen berdasarkan negara, kota, bahasa, dan tag.
Notifikasi kaya konten
Tambahkan gambar HTTPS, deep link yang terbuka saat diketuk, dan tombol aksi seperti Konfirmasi atau Jadwalkan Ulang.
Template tersimpan
Buat, pratinjau, kirim uji coba, dan publikasikan template dengan riwayat versi, lalu kirim lewat templateId dengan variabel Anda sendiri.
Prioritas, time to live, dan penjadwalan
Tandai pesan mendesak sebagai prioritas tinggi, atur time to live, gantikan notifikasi lama dengan collapse key, atau jadwalkan pengiriman.
Dry run sebelum mengirim
Setel dryRun ke true untuk memvalidasi payload dari awal hingga akhir tanpa mengirim apa pun ke pengguna sungguhan.
Kontrol batch
Lihat daftar batch, baca detailnya, lalu jeda, lanjutkan, atau batalkan batch lewat endpoint batch.
Notifikasi berbasis lokasi
Geofence dapat memicu notifikasi berdasarkan lokasi. Tim kami mengaktifkan geofencing untuk aplikasi Anda atas permintaan.
Status pengiriman lewat webhook
Pantau status pengiriman pada URL webhook yang dikonfigurasi di akun Anda, sama seperti kanal lainnya.
Push, SMS, atau WhatsApp: mana yang sebaiknya dipakai?
Push menjangkau orang yang menginstal aplikasi Anda. SMS dan WhatsApp menjangkau nomor ponsel. Kebanyakan bisnis memakai ketiganya, dengan urutan prioritas untuk setiap pesan.
| Kanal | Menjangkau | Terbaik untuk | Catatan |
|---|---|---|---|
| Notifikasi push | Pengguna yang menginstal aplikasi Anda dan mendaftarkan perangkat | Aktivitas aplikasi: status pesanan, pengingat, penawaran dalam aplikasi, re-engagement | Gunakan sebagai langkah pertama saat pengguna aktif di aplikasi Anda. |
| Pelanggan opt-in berdasarkan nomor telepon | Percakapan yang kaya, template, layanan pelanggan, dan bukti transaksi | Gunakan saat Anda butuh percakapan atau media. | |
| SMS | Semua nomor seluler | Kode OTP, alert mendesak, dan pelanggan tanpa aplikasi atau WhatsApp | Gunakan sebagai cadangan universal. |
Cara mulai mengirim push notification
Push berjalan di Firebase Cloud Messaging dan, untuk iOS, APNs milik Apple, sehingga ada langkah onboarding singkat di awal.
- 1
Hubungkan aplikasi Anda
Tim kami menghubungkan proyek Firebase Cloud Messaging Anda dan, untuk iOS, kredensial APNs, lalu memberi Anda app ID.
- 2
Daftarkan perangkat ke user ID Anda
Aplikasi Anda mendaftarkan setiap perangkat dengan pengenal Anda sendiri, yaitu userRef, sehingga Anda dapat mengirim ke orang, bukan ke token.
- 3
Periksa payload dengan dry run
Panggil POST /push/message/send dengan dryRun disetel ke true dan pastikan permintaan valid sebelum pengguna sungguhan melihat apa pun.
- 4
Kirim atau jadwalkan
Kirim ke userRefs, token, topik, atau segmen, atau jadwalkan pengiriman. Simpan pesan yang sering dipakai sebagai template.
- 5
Tambahkan cadangan
Tentukan pesan mana yang butuh kanal kedua, misalnya SMS untuk OTP atau alert pengiriman, lalu atur urutannya per kasus penggunaan.
Kapan push menjadi kanal yang tepat?
Cocok jika
- Anda punya aplikasi seluler dan ingin menjangkau pengguna yang sudah menginstal tanpa memerlukan nomor telepon mereka.
- Pesan terkait aktivitas aplikasi, seperti status pesanan, pengingat janji temu, atau alert akun.
- Anda ingin satu API dan satu format webhook untuk push, SMS, WhatsApp, dan kanal lainnya.
- Anda ingin mengirim berdasarkan user ID sendiri tanpa mengelola device token.
Hal yang perlu diketahui sebelum memulai
- Push hanya menjangkau orang yang menginstal aplikasi Anda dan mengizinkan notifikasi.
- API yang terdokumentasi mencakup push aplikasi seluler lewat FCM dan APNs. Tanyakan kepada tim kami tentang hal di luar itu sebelum Anda merencanakannya.
- Jangan mengandalkan push saja untuk kode OTP atau alert penting: tambahkan SMS atau suara sebagai cadangan.
- Geofencing diaktifkan atas permintaan untuk aplikasi Anda.
Pertanyaan seputar layanan push notification
Apa itu layanan push notification?
Layanan push notification mengirim pesan singkat dari server Anda ke perangkat pengguna, bahkan saat aplikasi ditutup. Di Android pengiriman berjalan lewat Firebase Cloud Messaging dan di iOS lewat APNs milik Apple. Layanan seperti OmniChannels.ai berada di depan keduanya dan memberi Anda satu API.
Bagaimana cara kerja API push notification?
Aplikasi Anda mendaftarkan setiap perangkat dengan sebuah token. Backend Anda lalu memanggil API dengan audiens dan konten, dan layanan menyerahkan notifikasi ke FCM atau APNs untuk dikirim. Dengan OmniChannels.ai Anda memanggil POST /push/message/send dan dapat menargetkan pengguna lewat user ID Anda sendiri.
Apa perbedaan push notification dan SMS?
Push menjangkau orang yang menginstal aplikasi Anda dan mengizinkan notifikasi, serta membutuhkan koneksi data. SMS menjangkau semua nomor seluler tanpa aplikasi. Push cocok untuk pembaruan dalam aplikasi dan engagement. SMS cocok untuk kode OTP, alert mendesak, dan pelanggan tanpa aplikasi Anda.
Bisakah saya mengirim push notification ke segmen pengguna?
Bisa. Selain user ID, device token, dan topik, API menerima objek segmen dengan kriteria seperti negara, kota, bahasa, dan tag, beserta app ID Anda. Anda juga dapat menjadwalkan pengiriman dan memberinya nama kampanye.
Bisakah saya menguji push notification sebelum mengirimnya?
Bisa. Setel dryRun ke true untuk memvalidasi permintaan tanpa mengirim apa pun. Untuk template, Anda dapat melihat pratinjau dengan data contoh dan mengirim uji coba ke perangkat Anda sendiri sebelum memublikasikan versi.
Bisakah saya menambahkan gambar, tautan, dan tombol?
Bisa. Notifikasi dapat berisi gambar HTTPS, deep link yang terbuka saat diketuk, data khusus untuk aplikasi Anda, dan tombol aksi, masing-masing dengan ID, judul, dan aksi. Anda juga dapat mengirim pesan data-only dan pesan senyap.
Bagaimana jika pengguna belum membuka aplikasi atau mematikan notifikasi?
Push tidak dapat menjangkau mereka. Untuk pesan yang penting, atur cadangan ke kanal lain seperti SMS atau WhatsApp. Urutan cadangan ditetapkan per kasus penggunaan, dan status pengiriman datang dalam satu format webhook.
Bagaimana cara memulai?
Pesan demo. Tim kami menghubungkan proyek Firebase dan kredensial APNs Anda saat onboarding, memberi Anda app ID, lalu Anda dapat memanggil API dengan token Anda. Dokumentasi developer mencantumkan setiap endpoint push.
Panduan tentang topik ini
- OmnichannelStrategi fallback kanal pesan: WhatsApp, RCS, dan SMS12 menit baca
- SMS & OTPWhatsApp vs SMS vs RCS: Pilih Kanal untuk OTP dan Marketing8 menit baca
- IntegrasiPanduan Integrasi API Messaging: REST, SMPP, dan Webhook9 menit baca
- KepatuhanOpt-in dan persetujuan kampanye WhatsApp, SMS, dan email8 menit baca
- OmnichannelApa Itu Omnichannel Messaging? Arsitektur, Contoh, Manfaat10 menit baca
Jelajahi lebih banyak platform
Tambahkan push ke tumpukan pesan Anda
Ceritakan tentang aplikasi Anda. Kami akan menghubungkan FCM dan APNs, lalu menunjukkan push berdampingan dengan SMS dan WhatsApp.
Bagikan stack Anda dan apa yang ingin Anda hubungkan. Seorang solutions engineer akan menindaklanjuti.