工作原理
自備帳戶
每個管道都使用您品牌的專屬提供者帳號－MetaWhatsApp企業帳號、LINE官方帳號或Google認證的 RBM 代理。頻道在您連線之前保持關閉；在此之前不會發送任何內容。
一次發送瀑布流
沒有單獨的“發送 WhatsApp” API。每個管道都與電子郵件、簡訊和推播通知在同一行銷活動/自動化引擎中運作——共享一個頻率上限，並自動回退到下一個管道（電子郵件始終有效）。
發送時強制執行同意
在發送時，系統會檢查每個管道（marketing_whatsapp / marketing_line / marketing_rcs）的行銷許可。未獲得授權的會員將被跳過，不會收到郵件。
密鑰已加密
存取權杖、通道金鑰和服務帳戶金鑰在靜態儲存時均經過加密，且 API 絕不會回傳。您只需在「設定」→「頻道」中貼上一次即可。
連接您的 Meta WhatsApp 企業帳號。企業發起的訊息將使用 Meta 批准的範本。
// WhatsApp — Meta WhatsApp Cloud API (Settings → Channels → WhatsApp)
// • Phone number id — from your WhatsApp Business Account (WABA)
// • Access token — WABA access token (write-only, encrypted at rest)
// • Templates — business-initiated messages use Meta-APPROVED templates
//
// Addressed by the member's phone number. Off until enabled; once on, WhatsApp joins
// the send waterfall. Meta business verification happens on Meta's side before delivery.LINE
連接 LINE 官方帳號。會員可透過以下方式聯絡： LINE userId — 透過後續 webhook（簽章驗證）或一鍵式入口網站 Connect 捕獲 LINE參見 會員入口網站嵌入 入口網站流程所依賴的已登入使用者會話指南。
// LINE — Messaging API (Settings → Channels → LINE)
// • Channel access token — long-lived token (write-only, encrypted)
// • Channel secret — OPTIONAL, only to receive follow/unfollow events (below)
// • LINE Login channel — OPTIONAL, powers one-tap portal "Connect LINE"
//
// LINE is addressed by the member's LINE userId — captured two ways:
//
// 1) Follow webhook. Point your LINE Official Account's webhook at:
// POST https://flash.socialhub.ai/api/webhooks/line/{teamId}
// Flash verifies the x-line-signature header before acting:
// signature == base64( HMAC-SHA256( rawRequestBody, <channel secret> ) )
// follow -> the member's LINE userId is (re)linked
// unfollow-> Flash stops targeting them on LINE
// (Always returns 200 so LINE keeps the endpoint enabled.)
//
// 2) One-tap portal Connect LINE (needs the LINE Login channel). The member taps
// "Connect LINE" on their portal privacy page and authorizes via LINE Login;
// Flash links their LINE account to their membership automatically.RCS
連接經 Google 驗證的 RBM 代理程式和服務帳戶。 Flash 在傳送時，在伺服器端將服務帳戶金鑰交換為 OAuth2 令牌。
// RCS — Google RCS Business Messaging / RBM (Settings → Channels → RCS)
// • RBM agent id — your Google-VERIFIED RBM agent (the sender)
// • Service-account email — the SA that calls the RBM API
// • Service-account key (PEM)— write-only, encrypted; exchanged for an OAuth2 token
// server-side at send time
//
// Addressed by E.164 phone (like SMS/WhatsApp). Reaches RCS-capable Android handsets;
// falls back automatically when a recipient can't receive RCS. Google verifies the
// RBM agent on Google's side before delivery is live.實用資訊
- 每個管道均獨立於工作區，且預設為關閉－未連接帳戶的工作區將保持優先使用電子郵件的路徑，行為不變。
- 您無需為每個管道單獨呼叫「傳送」端點：只需建立一次行銷活動或自動化流程，通路計畫就會根據每位會員選擇合適的管道，並在必要時使用電子郵件。
- WhatsApp RCS 可透過電話聯繫； LINE 由成員 LINE userId （透過 webhook 或入口網站連接） LINE).
- 供應商入駐/驗證（元業務驗證、LINE OA 設定、Google RBM 代理驗證）在供應商端進行－Flash 持有憑證並強制執行同意，但無法繞過供應商的核准流程。