Sumber · Pusat Pembangun

Tolakan Aplikasi

Tukarkan aplikasi natif anda menjadi saluran penghantaran SocialHub. Ahli mendaftarkan token peranti dari dalam pusat ahli dalam aplikasi; tekan kemudian sertai enjin automasi dan kempen yang sama yang menghantar e-mel anda — dengan air terjun saluran gagal-buka dan satu had frekuensi kongsi.

Pendaftaran Token dan jahitan tindanan hantar aktif dalam kod hari ini. Penghantaran tolakan sebenar dilancarkan di sebalik bendera pengaktifan terkawal setiap pasukan — minta pasukan SocialHub anda untuk menghidupkannya setelah kelayakan FCM/APN anda dikonfigurasikan.

Cara ia berfungsi

Daftar token perantiLangsung

Aplikasi ahli yang log masuk MENGEMUKAKAN token FCM/APNnya. Idempotent UPSERT — selamat untuk dihubungi pada setiap pelancaran dan pada putaran token OS.

Tolak menyertai tindanan hantarLangsung

Push ialah saluran dalam enjin automasi/kempen yang sama seperti e-mel — bukan API yang berasingan. Satu perjalanan, saluran dipilih setiap ahli.

Air terjun saluran + satu huruf besarLangsung

Air terjun gagal-buka (tolak → e-mel → …) dengan had frekuensi kongsi tunggal supaya ahli tidak pernah menerima mesej berganda merentasi saluran.

Pengaktifan penghantaranPelancaran

Pendaftaran dan sambungan penghantaran berada dalam kod hari ini; penghantaran tolak sebenar dilancarkan di sebalik bendera terkawal, setiap pasukan. Minta pasukan SocialHub anda untuk mendayakannya.

Daftar token peranti Langsung

Panggil ini dari dalam WebView ahli yang telah dilog masuk (kuki sesi pengguna membawa identiti). Lihat panduan Benamkan Portal Ahli untuk aliran 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.

Menghantar: tolak ialah 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 mengarang push tanpa kod: Langkah push dalam kanvas kempen visual (di sebelah E-mel), dengan salinan yang dijana AI, tag gabungan yang sama seperti e-mel dan templat push yang boleh digunakan semula. Apa sahaja yang mereka karang akan menjadi kandungan push kempen dan laluan penghantaran di atas menyampaikannya — aplikasi anda hanya mendaftarkan token peranti.

Sebelum anda mula beroperasi

FCM (Android + iOS melalui Firebase)

Berikan kelayakan akaun perkhidmatan Firebase anda kepada pasukan SocialHub anda. Hantar adalah melalui FCM HTTP v1 (OAuth melalui akaun perkhidmatan) — pembekal lalai.

APN (pilihan, langsung)

Jika anda menghantar ke iOS secara terus melalui APN, berikan kunci pengesahan APN anda (.p8), ID Kunci dan ID Pasukan. Daftarkan peranti tersebut dengan pembekal: "apns".

Persetujuan

Tolak dikawal oleh persetujuan ahli yang jelas serta isyarat Kawalan Privasi Global (gagal-ditutup). Ahli tanpa persetujuan tolak aktif dilangkau — air terjun kembali ke e-mel.

Senarai semak penerimaan

Mendaftarkan peranti yang sama dua kali tidak akan menghasilkan pendua — UPSERT akan menghalakannya semula kepada ahli semasa.

Ahli yang memilih untuk masuk dengan token yang sah menerima tolakan; ahli yang tidak mempunyai token/persetujuan menerima e-mel sandaran — tidak pernah tiada apa-apa, tidak pernah kedua-duanya.

Membatalkan persetujuan tolak (atau isyarat Kawalan Privasi Global) akan serta-merta menjatuhkan ahli ke saluran e-mel.

Mempermudahkan push?

Bercakap dengan jurutera tentang kelayakan FCM/APN, air terjun saluran penghantaran atau mendayakan penghantaran untuk pasukan anda.

Bercakap dengan jurutera