Kirim & Hasil Push

Kirim

`target.type`	Sasaran
`external_id`	Perangkat milik 1 sampai 100 user
`token`	Satu perangkat
`list`	Semua user di satu list
`all`	Semua perangkat `subscribed` di aplikasi
`topic`	Perangkat yang berlangganan topic lewat SDK (`subscribeTopic`)

delivery_mode:

notification (default): OS menampilkan notifikasi.

data: hanya data. Judul dan isi dipindah ke data.title dan data.body; aplikasi Anda yang menampilkan.

Field android, ios, dan web diteruskan apa adanya ke FCM. Total data ditambah ketiga blok itu maks. 4.000 byte.

Respons	Arti
`201 Push message queued`	Masuk antrean. Simpan `data._id`
`200 Push message already queued`	`Idempotency-Key` sudah pernah dipakai
`409`	Kredensial Firebase belum dipasang atau ditolak Google
`422`	Platform di `platforms` tidak aktif di aplikasi push
`404 Push list not found`	`list_id` salah
`402 Monthly push quota exceeded`	Kuota bulanan habis
`429`	Batas kecepatan terlampaui. Tunggu `data.retry_after` detik

Pilih salah satu:

Polling GET /v1/push/messages/{push_message_id} dengan API key full_access.

Webhook push.completed: dikirim sekali saat pesan selesai diproses. URL dipasang admin di dasbor. Lihat Webhook Events.

Status	Arti
`queued`	Menunggu diproses
`sent`	Semua perangkat sasaran berhasil, atau FCM menerima kiriman ke topic
`partial`	Sebagian berhasil, sebagian gagal
`failed`	Tidak ada yang berhasil. Alasan di `error`

Hasil dicatat sebagai hitungan di stats:

Field	Arti
`devices_targeted`	Perangkat yang masuk sasaran
`devices_sent`	Diterima FCM
`devices_failed`	Gagal
`devices_skipped`	Dilewati karena `unsubscribed` atau `permission_denied`
`devices_over_limit`	Tidak dikirim karena melebihi batas subscriber paket
`external_ids_unmatched`	`external_id` tanpa perangkat aktif

Untuk target topic, semua angka stats tetap 0 karena pelanggan topic dikelola Firebase.

Gejala	Solusi
`failed`, "No active device matched this target"	Pastikan aplikasi memanggil `identify(userId)` (web) atau `login(userId)` (Flutter) setelah user login
`external_ids_unmatched` lebih dari 0	User belum login di perangkat mana pun, atau sudah logout
iOS atau web tidak muncul padahal `sent`	Lengkapi konfigurasi APNs atau Web Push di Firebase Console
Banyak `dead_token`	Normal setelah uninstall. Pastikan aplikasi memanggil `subscribe()` (web) atau `login()` (Flutter) setiap dibuka