Lompat ke konten utama
Kembali ke plugin
@capgo/capacitor-notifikasi
Tutorial
@capgo/capacitor-notifikasi

Notifikasi

Kirim notifikasi push native iOS dan Android dari Capgo dengan pencarian pengguna, badge, statistik, dan periksa pembaruan diam

Panduan

Tutorial tentang Pemberitahuan

Menggunakan @capgo/capacitor-pemberitahuan

Kirim pemberitahuan push native iOS dan Android dari Capgo dengan pencarian pengguna, tombol notifikasi, tracking terbuka/terbuka, panggilan balik latar belakang, dan periksa Capgo live-update secara diam.

Plugin ini dibuat untuk aliran pemberitahuan Capgo. Capgo menyimpan metadata kredential platform dan data kontrol kampanye di Postgres, sedangkan status perangkat aktif dan event pengiriman ditulis ke Cloudflare Engine Analitik.

Instal

Gunakan Capgo CLI untuk pengaturan yang terstruktur:

npx @capgo/cli@latest notifications setup com.example.app

Pasang secara manual:

npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync

Konfigurasi

import { CapgoNotifications } from '@capgo/capacitor-notifications'

await CapgoNotifications.configure({
  appId: 'com.example.app',
  autoUpdater: true,
  updateInstallMode: 'next',
})

Pendaftaran Pengguna Tertandatangan

Mint identityProof dari backend Anda dengan POST /notifications/recipients/proof, kemudian daftarkan perangkat setelah login Anda berhasil.

await CapgoNotifications.register({
  externalId: 'customer-user-123',
  identityProof,
  tags: ['paid'],
  attributes: { plan: 'team' },
  consent: true,
})

Dengarkan Acara

await CapgoNotifications.addListener('notificationReceived', (notification) => {
  console.log('Received', notification)
})

await CapgoNotifications.addListener('notificationOpened', (event) => {
  console.log('Opened', event.notification.id)
})

await CapgoNotifications.addListener('backgroundNotification', async (event) => {
  try {
    console.log('Background payload', event.notification.data)
  } finally {
    await event.finish()
  }
})

Pengaturan iOS

Aktifkan Pemberitahuan Push context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Pesan kunci `push_notifications` (Pemberitahuan Push). dan context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Pesan kunci `and` (Dan).

Mode Latar Belakang > Pemberitahuan Jarak Jauh ios/App/App/AppDelegate.swift:

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    NotificationCenter.default.post(name: Notification.Name("CapgoNotificationsRemoteNotification"), object: userInfo)
    completionHandler(.newData)
}

Pengaturan Android

Jalankan npx cap sync androidKonfigurasi kreditur platform Android di Capgo, minta izin notifikasi pada Android 13+, dan tes di perangkat atau emulator dengan layanan Google Play.

Daftar Periksa Debugging

  • Jalankan npx @capgo/cli@latest notifications setup com.example.app dari folder yang berisi capacitor.config.*.
  • Cari penerima di Capgo dengan ID pelanggan eksternal.
  • Konfirmasi perangkat memiliki platform android atau ios Konfirmasi perangkat memiliki platform
  • dan izin diberikan. registrationChanged, notificationReceived, notificationOpenedTetapkan pemangku jawab sementara untuk backgroundNotification.
  • Mengirimkan notifikasi uji dari dashboard.
  • Mengcek statistik untuk kejadian antrian, dikirim, diterima, dan dibuka.
  • Untuk pemeriksaan pembaruan diam, pastikan @capgo/capacitor-updater terpasang dan autoUpdater aktif.

Referensi Lengkap

Menggunakan @capgo/capacitor-notifications, lanjutkan.

Jika Anda menggunakan Gunakan @capgo/capacitor-notifications untuk merencanakan pesan push asli, hubungkannya dengan @capgo/capacitor-notifications untuk detail implementasi, Pengaturan Debug untuk troubleshooting, @capgo/capacitor-updater untuk periksa update diam, dan Capgo Direktori Plugin untuk plugin asli lainnya.