訊息通道
長連線閘道、Open API、管理 API 與回呼投遞四條通路打通，訊息上下行不依賴輪詢。
- 私有協定長連線，斷線自動重連
- Open API 涵蓋全部訊息類型
- 回呼投遞同步訊息狀態與業務事件
四塊能力拼起來，就是一套 IM 系統
訊息通道、會話能力、關係與群組、多端 SDK 各司其職，組合起來就是一套可直接交付的 IM 系統。
會話能力
單聊、群聊、聊天室、超級群、系統通知五類會話形態，訊息類型涵蓋文字到自訂訊息。
- 文字、圖片、檔案、語音、位置與自訂訊息
- 已讀回條、訊息收回、@提及、引用回覆
- 草稿、置頂、歷史訊息漫遊與訊息搜尋
關係與群組
好友關係鏈與群組管理 API 齊備，業務端不必自建一套關係與群組權限模型。
- 好友關係、好友邀請、黑名單、線上狀態
- 改名、管理員、禁言、移除、轉讓、群公告
多端 SDK 與 IMKit
Web / Android / iOS / macOS / Flutter / RN / 小程式皆支援，搭配 IMKit UI 元件可直接重複使用。
- 一套帳號體系，多端同時登入
- IMKit 提供會話、訊息、通訊錄 UI
- 主控台與營運後台可管理、可稽核
訊息要可靠，治理也要跟得上
不只是能發訊息，而是把訊息品質、會話體驗與內容治理一起做好。
弱網來回切換，訊息不漏也不重
長連線閘道負責上下行，訊息寫入資料庫三副本後才回傳傳送確認；用戶端依會話序號去重與補拉，網路恢復後訊息不漏、不重複。
- 斷線自動重連，離線期間訊息先寫入資料庫待補送
- 訊息儲存三副本，寫多讀少場景下仍維持一致
- 離線推送通道備援，App 未執行也能觸達
- 回呼投遞把訊息狀態同步到你的業務系統
日常聊天用得到的細節都有
從已讀回條到引用回覆，日常聊天中真正會用到的能力預設就已包含，接入即可交付完整會話體驗。
- 群聊已讀回條以 n/m 彙總，並可下鑽已讀明細
- 訊息收回、@提及、引用回覆、草稿與置頂
- 歷史訊息漫遊與全量訊息搜尋
- 聊天室支援高併發進出與訊息頻率控制
好友與群組，後台看得見也管得住
好友邀請、黑名單、群組成員治理與敏感詞審核放在同一套 API 裡，營運後台可視覺化管理。
- 好友邀請審核流程、黑名單與線上狀態同步
- 群組擁有者可改群名、設管理員、禁言、移除與轉讓
- 群公告觸達全員，系統通知加強提醒
- 敏感詞審核與內容風控，命中可攔截或替換
技術架構
終端只連一條長連線，伺服器端依職責分層，儲存與推送分離，擴充時各自獨立。
接入層 終端 SDK 與 UI 元件
WebAndroidiOSmacOSFlutterReact Native小程式IMKit 元件
服務層 訊息與關係鏈
長連線閘道訊息服務關係鏈群組服務內容審核Open API管理 API回呼投遞
儲存與推送 持久化與觸達
訊息儲存（3 副本）歷史訊息漫遊離線推送通道敏感詞庫
長連線閘道與訊息服務均可水平擴充；私有化部署時三層可整套落在你的機房內網。
先接通一條訊息，再逐步加上能力
主控台建立應用程式取得 AppID，引入 SDK 建立長連線，即可開始收發訊息。
- 主控台建立應用程式，取得 AppID 與金鑰，設定回呼位址
- 依端引入 SDK 或 IMKit UI 元件，替換會話介面
- 伺服器端呼叫 Open API 發送系統通知、管理群組與關係鏈
im-quick-start.ts TypeScript
import FeiyanIM from '@feiyan/im-sdk';
// 1. Init: get the AppID from the app details in the console
const im = FeiyanIM.init({ appId: 'YOUR_APP_ID' });
// 2. Connect (auto-reconnect after a drop, offline messages are re-delivered)
await im.connect({ userId: 'user_1001', token });
// 3. Send a message: one API for direct chats, groups and chat rooms
await im.sendMessage({
target: 'group_2001',
type: 'text',
content: 'Hello, FeiyanCloud',
});
// 4. Listen for messages and read receipts
im.on('message', (msg) => console.log(msg));
im.on('readReceipt', (r) => {
console.log(`${r.readCount}/${r.totalCount}`, r.readUserIds);
});接入前的常見問題
更多技術細節請查閱文件中心，或提交工單取得支援。
訊息如何確保不漏、不重複？
訊息經長連線閘道寫入訊息服務後，以三副本方式寫入資料庫成功才回傳傳送確認；用戶端為每個會話維護遞增序號，重連後依序號補拉缺少的訊息並去重，因此弱網切換、行程被終止等情況下也不會出現訊息遺漏或重複顯示。
支援哪些訊息類型？可以自訂嗎？
內建文字、圖片、檔案、語音、位置與系統通知等常用類型，同時提供自訂訊息類型：業務可自訂訊息內容與呈現方式，伺服器端只做原樣傳遞與儲存，適合訂單卡片、富文字卡片等場景。
群聊已讀回條是怎麼統計的？
群聊回條以 n/m 形式顯示已讀人數與群組成員總數，並可透過 API 取得已讀成員明細；單聊回條直接標記對方已讀時間。回條狀態會透過回呼投遞同步到業務後台。
歷史訊息漫遊可以保留多久？
雲端服務的漫遊時長依所選方案在主控台調整，可透過 Open API 分頁拉取；私有化部署時訊息儲存與漫遊策略由你自己的資料庫承載，保留週期可自訂。
多端登入時訊息如何同步？
同一帳號可由使用者在 Web、行動端與桌面端同時登入，任一端發送或已讀後，其他端透過線上通道收到同步事件，離線端在下次連線時依序號補拉，確保多端會話狀態一致。
IM 可以單獨使用，還是必須搭配 RTC？
IM 與即時影音是兩套獨立產品，可單獨接入；若需要在會話中發起影片或語音通話，可以組合使用 RTC 的通話能力，共用同一套帳號與驗證授權體系。
產品實拍