嵌入 API 與白標夥伴門戶的比較

當 SaaS 產品嵌入通訊功能時，終端使用者永遠不需要開啟 IOSOR 主控台。他們只需在 ISV 介面點擊「傳送」；ISV 擁有金鑰、webhook 與預付帳戶。這條路徑稱為嵌入(embed)。白標夥伴門戶則完全不同：夥伴管理員在夥伴介面上工作 — 包含品牌安全介面、租戶隔離以及絕不洩漏底層電信商名稱的介面閘門。

團隊經常模糊這兩者的界線：在 ISV 簡報中放入夥伴門戶截圖，或是在 SaaS 產品中顯示類似 IOSOR 的錯誤訊息。嵌入意味著您的產品是唯一面向客戶的介面。夥伴則代表專門給分銷商的品牌門戶 — 雖然同樣是白標且設有閘門，但所有權架構完全不同。在首週請務必確定選定單一介面。

嵌入功能將訊息傳送保留在 SaaS 產品內部

嵌入架構將 API 金鑰、冪等性金鑰與 webhook 接收器託管於 ISV 工程團隊組織下。終端使用者的操作會透過 ISV 預付錢包對映至伺服器端傳送。SaaS 介面僅顯示產品原生狀態 — 已排隊、已傳送、失敗 — 絕不會顯示底層品牌，也無需客戶進行第二次主控台登入。

請記錄哪一個微服務持有生產環境金鑰，並按照 ISV 的週期進行輪換。如果產品團隊希望提供夥伴門戶以供支援人員瀏覽，請透過介面閘門進行回應：該需求屬於夥伴層級，而不應作為 SaaS 外殼內的快捷方式。

夥伴門戶保持為獨立的白標介面

夥伴門戶專為管理子租戶、分潤比例與品牌安全匯出的分銷商管理員服務。畫面遵循夥伴介面閘門規則：快訊通知、API 錯誤訊息、webhook 或 CSV 欄位中均不可包含底層品牌。Catalog Live 仍與金庫保持同步。夥伴管理員並非 ISV 的終端使用者。

切勿將夥伴門戶以 iframe 嵌入 SaaS 產品中以求快速上線。這樣會混淆信任模型並洩漏營運狀態用語。請將夥伴相關工作嚴格保留在夥伴 URL 與權限角色中。

拆分所有權：產品介面與夥伴介面

請將此對照表發佈於上線工單中。在未指定明確負責人的情況下，銷售團隊切勿承諾在首週同時提供兩種介面。

拒絕混合品牌路徑的混合演示

在同一張簡報投影片中展示 SaaS 傳送按鈕與夥伴門戶截圖，會誤導買家產生錯誤的介面預期。如果買家要將 OTP 嵌入其應用程式中，請僅演示嵌入流程，並將夥伴相關文章作為補充資料。

相關營運路徑

• 夥伴介面閘門：無品牌洩漏
• 上線時的 webhook 與金鑰習慣
• 將多管道通訊 SKU 封裝為統一的目錄方案

從 IOSOR 開始

請在控制台的 ISV 金鑰庫中設定產品 Webhook 接收器，並將 API 金鑰嚴格保密在後端伺服器上。在授予轉銷商管理員權限前，務必執行合作夥伴介面閘道檢查，確保上游品牌資訊不會外洩至 DLR 酬載或 CSV 匯出檔案中。在預備與正式環境中，皆應保持產品介面與合作夥伴介面的獨立隔離。 Embed 與 partner portal 必須分開：產品玻璃不是白標入口，hybrid demo 直接拒絕。

IOSOR 要點

透過 API 嵌入訊息功能，能讓終端使用者流量與狀態完全保留在您的軟體即服務產品介面內，並由您工程團隊的伺服器端金鑰驅動。同時，白標合作夥伴入口網站專門供轉銷商管理員管理子租戶結構、費率分潤及品牌隔離匯出內容，且不會暴露上游基礎設施的細節。

請務必將 API 金鑰、Webhook 接收器及狀態呈現隔離在主要的產品程式碼基底中。切勿展示混合式銷售展示，或將合作夥伴管理介面與產品原生訊息流程混為一談，因為模糊這些界線會導致品牌外洩並打亂租戶治理。