應用程式推送
將您的原生應用程式轉換為 SocialHub 發送管道。會員在應用程式內會員中心註冊裝置令牌；然後，推播將加入與您的電子郵件相同的自動化和行銷引擎——採用失敗開啟通道瀑布模型和共享的發送頻率上限。
令牌 註冊和發送堆疊接縫目前已在程式碼中啟用 。實際推播 交付將在每個團隊的受控啟用標誌 後推出－請在配置 FCM/APN 憑證後，聯絡您的 SocialHub 團隊啟用該標誌。
工作原理
註冊設備令牌即時
已登入會員的應用程式會 POST 其 FCM/APNs 令牌。冪等 UPSERT 操作－每次啟動和作業系統令牌輪換時均可安全呼叫。
推播加入發送堆疊即時
推播是與電子郵件相同的自動化/行銷引擎中的一個管道，而不是單獨的 API。一次旅程，每位會員選擇的頻道。
渠道瀑布流 + 單一上限即時
採用失敗開啟瀑布流（推送 → 郵件 → …），並設定統一的發送頻率上限，確保會員不會在不同管道收到重複訊息。
配送支援逐步推出
註冊和發送接縫今天已用代碼編寫；實際的推送交付在每個團隊的受控旗幟後面推出。請您的 SocialHub 團隊啟用它。
註冊設備令牌 即時
在已登入會員的 WebView 中呼叫此功能（消費者會話 cookie 包含身分資訊）。有關建立該會話的 WebView 單一登入 (SSO) 流程，請參閱 會員入口網站嵌入 指南。
// 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.發送：推送是一個通道，而不是一個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.行銷人員無需編寫程式碼即可建立推播內容：在視覺化行銷活動畫布（電子郵件旁）中新增一個 推送步驟，其中包含 AI 產生的文案、與電子郵件相同的合併標籤以及可重複使用的 推送範本。他們創建的任何內容都將成為行銷活動的推送內容，並透過上述發送路徑進行分發——您的應用程式僅註冊裝置代幣。
上線前
FCM（Android + iOS，透過 Firebase）
請將您的 Firebase 服務帳戶憑證提供給您的 SocialHub 團隊。透過 FCM HTTP v1（透過服務帳戶進行 OAuth 認證）傳送－這是預設提供者。
APNs（可選，直接）
如果您透過 APNs 直接向 iOS 裝置傳送訊息，請提供您的 APNs 授權金鑰 (.p8)、金鑰 ID 和團隊 ID。向提供者「apns」註冊這些設備。
同意
推播通知由成員的明確同意以及全域隱私控制訊號（失敗關閉）控制。未啟動推送同意的成員將被跳過——流程將回退到電子郵件。
驗收清單
重複註冊相同裝置不會建立重複項－UPSERT 作業會將其重新指向目前會員。
已選擇加入且擁有有效令牌的會員會收到推播通知；未持有令牌/未獲得同意的會員則會收到電子郵件備選方案－絕不會什麼都不收到，也不會同時收到兩者。
撤銷推播同意（或全域隱私控制訊號）會立即將成員轉移到電子郵件管道。