/api/capabilities 回傳值為準。
部署與登入
在 Deployment 分類開通服務並選擇實例時長方案。部署後開啟管理頁面,使用帳號本人的企業微信掃碼;如需手機確認或其他登入步驟,開啟遠端桌面並輸入該實例的桌面密碼。API 憑據與桌面密碼獨立。登入資料保存在實例磁碟中,重建容器會保留磁碟;刪除磁碟會刪除本機會話。 每個實例獨立收費,按已購買的時長運行。REST / MCP 呼叫不按訊息另行收費,實際價格以方案頁面為準。目前預設參考微信機器人的時長方案,最終開放前需結合運行資源完成定價確認。API 與 MCP
使用管理頁面中的實例 API 位址,所有帳號介面攜帶Authorization: Bearer <實例 API token>。這些路徑屬於專屬實例,不是共用 API 閘道。MCP 位址為實例位址加 /mcp/,使用相同 Bearer token。
發送內容包含
target、type: "text" 和 text。target 接受會話 ID、聯絡人 ID、企業使用者 ID 或唯一的完整名稱;優先使用 ID;顯示名稱仍無法唯一定位時,實例會拒絕操作,不會猜測對象。沒有本機會話的聯絡人會先透過用戶端開啟會話,並核對實際會話 ID 後發送。請求標頭 Idempotency-Key 是 8–128 位字母、數字或 _.:-。同一操作重複請求必須重複使用相同金鑰和相同請求內容。
將 target 換為 targets 陣列可循序發送給 1–50 個明確指定的目標。兩者不能同時提供。全部目標先完成身分解析,指向同一對象的不同別名會被拒絕。某一目標失敗後停止後續發送,任務結果逐項記錄 succeeded、failed、unknown 或 not_attempted;不要把部分成功當成全部成功。此流程還需在部署環境完成指定聯絡人的真實驗收。
任務可能處於 queued、running、submitting、succeeded、failed、unknown 或 cancelled。succeeded 表示提交後在對應會話記錄中找到了準確文字及伺服器訊息 ID,delivered 仍為 null,不代表對方已收到。unknown 表示結果不明確,請檢查歷史記錄,不要用新金鑰重複發送。實例不會自動重發中斷的任務。
歷史僅包含用戶端已經同步的內容,不能保證全部歷史。非文字訊息可能回傳 unknown 類型,附件下載尚未開放。事件保留最近 10,000 筆,gap 表示游標已超出保留視窗。首次連線不會把舊歷史當作新訊息重播。
訊息歷史中的 server_accepted 和 server_id 可用於核對伺服器是否已接受本機訊息;僅出現本機記錄而沒有伺服器 ID 時,不能認定發送成功。這些欄位不代表接收方已收到或閱讀。事件記錄保留產生時的狀態,查詢目前確認狀態應使用訊息歷史介面。

