应用推送
将您的原生应用转换为 SocialHub 发送渠道。会员在应用内会员中心注册设备令牌；然后，推送将加入与您的电子邮件相同的自动化和营销引擎——采用失败打开通道瀑布模型和共享的发送频率上限。
令牌 注册和发送堆栈接缝目前已在代码中启用 。实际推送 交付将在每个团队的受控启用标志 后推出——请在配置好 FCM/APNs 凭据后，联系您的 SocialHub 团队启用该标志。
工作原理
注册设备令牌实时
已登录会员的应用会 POST 其 FCM/APNs 令牌。幂等 UPSERT 操作——每次启动和操作系统令牌轮换时均可安全调用。
Push加入发送栈实时
推送是与电子邮件相同的自动化/营销引擎中的一个渠道，而不是单独的 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）
向您的 SocialHub 团队提供您的 Firebase 服务帐户凭据。通过 FCM HTTP v1（通过服务帐户进行 OAuth）发送 - 默认提供商。
APN（可选，直接）
如果您直接通过 APNs 发送到 iOS，请提供您的 APNs 身份验证密钥 (.p8)、密钥 ID 和团队 ID。向提供商注册这些设备：“apns”。
同意
推送通知由成员的明确同意以及全局隐私控制信号（失败关闭）控制。未激活推送同意的成员将被跳过——流程将回退到电子邮件。
验收清单
两次注册同一设备不会创建重复项 — UPSERT 会将其重新指向当前成员。
已选择加入且拥有有效令牌的会员会收到推送通知；未持有令牌/未获得同意的会员则会收到电子邮件备选方案——绝不会什么都不收到，也不会同时收到两者。
撤销推送同意（或全局隐私控制信号）会立即将成员转移到电子邮件渠道。