Skip to content

Google FCM ​

厂商定位 ​

Firebase Cloud Messaging(FCM)是 Google 提供的 App 设备消息推送能力。MINT 平台中由 dcis-gw(通信交互整合网关)封装为内部接口 POST /internal/v1/fcm-pushes,底层调用 FCM HTTP v1 API,用于开户成功、还款提醒、登录提醒等 App 通知类推送。

能力归属 ​

核心能力 ​

能力接口说明
批量设备推送(内部)POST /internal/v1/fcm-pushes上游 → dcis-gw,body 为消息列表,单次上限 500 条
FCM HTTP v1(底层)FCM APIdcis-gw 组装报文后调用 Google

关键约定 ​

  • 公共字段:bizSeqNo(幂等键)、tenantCode、bankCode、sceneCode(如 NOTIFICATION_PUSH)。
  • 每条消息:token(FCM 设备令牌)+ title / content(上游渲染好的最终文案)+ 透传 templateId、messageId。
  • dcis-gw 只做透传组装:不查设备表、不做模板渲染,设备 token 与文案由上游负责。
  • 响应:bizRtnCode(000000 / 999999)+ sendStatus(SUCCESS / PARTIAL_SUCCESS / FAILED)+ 逐条明细 fcmMessageId / errorCode。
  • 错误码:UNREGISTERED(token 失效)、QUOTA_EXCEEDED、UNAVAILABLE、INVALID_ARGUMENT、INTERNAL。

语义注意 ​

  • FCM 受理成功 ≠ 设备送达,最终送达以设备回执为准。
  • 离线消息 FCM 侧保留至多 24 小时(ttl),过期丢弃。
  • token 生命周期由 App 侧维护,UNREGISTERED 需上游触发重新注册并更新设备表。

适用场景 ​

  • 开户成功 / 交易 / 还款日提醒 / 登录提醒等 App 通知。
  • 与短信(Taifa)互补:在线用户走推送,成本低于短信;触达保证要求高的场景仍以短信为主。

接入待确认 ​

  • Firebase 项目归属与 Service Account 凭据管理方式。
  • App 侧 token 上报与更新链路(谁维护设备 token 表)。
  • 推送文案与模板管理是否后续收口到 dcis-gw。