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

Notifikasi

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

Petunjuk

Tutorial tentang Notifikasi

Menggunakan @capgo/capacitor-notifications

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

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

Pasang

Paket ini saat ini dalam pratinjau pribadi. Capgo harus mengaktifkan akses paket untuk akun npm Anda sebelum instalasi berfungsi.

Gunakan Capgo CLI untuk setup yang terstruktur:

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

Pasang 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',
})

Daftar Pengguna yang Dijamin

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

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

Tangani 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 dan Modus Latar Belakang > Pemberitahuan Jarak Jauh di Xcode.

Meneruskan pemberitahuan remote dari 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 android, konfigurasi kredit platform Android di Capgo, meminta izin pemberitahuan pada Android 13+, dan tes pada perangkat atau emulator dengan Google Play services.

Daftar Periksa Pengembangan

  • 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 dan izin diberikan.
  • Tambahkan pendengar sementara untuk registrationChanged, notificationReceived, notificationOpenedMengirimkan notifikasi uji dari dashboard. backgroundNotification.
  • Periksa statistik untuk kejadian antrian, dikirim, diterima, dan dibuka.
  • Untuk memeriksa pembaruan diam, pastikan
  • terpasang dan @capgo/capacitor-updater teraktifkan. autoUpdater Referensi Lengkap

Docs: /docs/plugins/notifications/

Keep going from Using @capgo/capacitor-notifications

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