Sumber Daya · Pusat Pengembang

Pember推送 Aplikasi

Ubah aplikasi asli Anda menjadi saluran pengiriman SocialHub. Anggota mendaftarkan token perangkat dari dalam pusat anggota dalam aplikasi; kemudian push akan bergabung dengan mesin otomatisasi dan kampanye yang sama yang mengirim email Anda — dengan saluran yang terbuka saat gagal dan satu batasan frekuensi bersama.

Pendaftaran Token dan sambungan tumpukan kirim sudah aktif dalam kode saat ini. Pengiriman push aktual diluncurkan di balik flag pengaktifan terkontrol per tim — minta tim SocialHub Anda untuk mengaktifkannya setelah kredensial FCM/APNs Anda dikonfigurasi.

Cara kerjanya

Daftarkan token perangkatLangsung

Aplikasi anggota yang masuk mengirimkan token FCM/APNs-nya melalui POST. UPSERT yang idempoten — aman untuk dipanggil setiap kali aplikasi diluncurkan dan saat rotasi token OS.

Push bergabung dengan tumpukan pengirimanLangsung

Push adalah saluran dalam mesin otomatisasi/kampanye yang sama dengan email — bukan API terpisah. Satu perjalanan, saluran dipilih per anggota.

Air terjun saluran + satu tutupLangsung

Alur pesan gagal-buka (push → email → …) dengan batasan frekuensi bersama tunggal sehingga anggota tidak pernah menerima pesan ganda di berbagai saluran.

Pengaktifan pengirimanDiluncurkan

Pendaftaran dan pengiriman pesan saat ini ada dalam kode; pengiriman push sebenarnya diluncurkan di balik flag yang terkontrol, per tim. Minta tim SocialHub Anda untuk mengaktifkannya.

Daftarkan token perangkat Langsung

Panggil ini dari dalam WebView anggota yang masuk (cookie sesi konsumen membawa identitas). Lihat panduan Penyematan Portal Anggota untuk alur SSO WebView yang menetapkan sesi tersebut.

// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json

{
  "platform": "ios",             // "ios" | "android"
  "provider": "fcm",             // "fcm" (default) | "apns"  — optional
  "token": "<device push token>",
  "appBundleId": "com.yourbrand.app"   // optional
}
// → 200  { "ok": true }
//   Idempotent UPSERT keyed on (team, token): re-registering the same device
//   simply re-points it at the current member. Call it on every app launch and
//   whenever the OS rotates the token.

Pengiriman: push adalah saluran, bukan panggilan API

// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
//   1. SocialHub resolves the member's channels in a waterfall (fail-open):
//        push (if a token + consent exist)  →  email  →  …
//   2. One SHARED frequency cap applies across channels, so a member is never
//      double-messaged on push AND email for the same step.
//   3. No token / no consent / push disabled  →  silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.

Pemasar membuat notifikasi push tanpa perlu menulis kode: sebuah Langkah Push di kanvas kampanye visual (di samping Email), dengan teks yang dihasilkan AI, tag gabungan yang sama seperti email, dan template push yang dapat digunakan kembali. Apa pun yang mereka buat akan menjadi konten push kampanye dan jalur pengiriman di atas akan mengirimkannya — aplikasi Anda hanya mendaftarkan token perangkat.

Sebelum Anda mulai beroperasi

FCM (Android + iOS melalui Firebase)

Berikan kredensial akun layanan Firebase Anda kepada tim SocialHub Anda. Pengiriman dilakukan melalui FCM HTTP v1 (OAuth melalui akun layanan) — penyedia default.

APN (opsional, langsung)

Jika Anda mengirim langsung ke iOS melalui APNs, berikan kunci otentikasi APNs Anda (.p8), ID Kunci, dan ID Tim. Daftarkan perangkat tersebut dengan penyedia: "apns".

Persetujuan

Push diatur oleh persetujuan anggota secara eksplisit ditambah sinyal Kontrol Privasi Global (gagal-tertutup). Anggota tanpa persetujuan push aktif akan dilewati — waterfall akan kembali ke email.

Daftar periksa penerimaan

Mendaftarkan perangkat yang sama dua kali tidak membuat duplikat — UPSERT mengarahkannya kembali ke anggota saat ini.

Anggota yang telah memilih untuk menerima pemberitahuan dengan token yang valid akan menerima pemberitahuan push; anggota tanpa token/persetujuan akan menerima email sebagai alternatif — tidak pernah tidak menerima apa pun, tidak pernah keduanya.

Mencabut persetujuan push (atau sinyal Kontrol Privasi Global) akan segera mengalihkan anggota ke saluran email.

Mengaktifkan notifikasi push?

Bicaralah dengan seorang insinyur tentang kredensial FCM/APNs, alur pengiriman saluran, atau mengaktifkan pengiriman untuk tim Anda.

Bicara dengan bagian teknik