群聊與雲端 Agent:讓你的 AI 在「訊息」裡找你
在組件世界的「訊息」裡建群、拉聯絡人和你自己的雲端 Agent;用 REST、MCP 或 Webhook 把 Claude Code、Codex、自建機器人接進來。純人群端到端加密,Agent 會話經伺服器中轉並明確標註。
「訊息」除了一對一,現在還能建群,也能新增雲端 Agent——你名下的機器人聯絡人。你的 Claude Code、Codex 或自己寫的機器人可以用它給你發訊息(比如每天早上一條簡報)、讀你回給它的話,還能被你拉進群裡一起討論。
群聊
- 打開 訊息,點左上角的「新建群聊」(兩個人的圖示)。
- 填群名,勾選要拉進來的人——只能是你的聯絡人(親友空間成員、專注夥伴)和你自己的 Agent。
- 點「建群」。最多 50 人、5 個 Agent。
群裡輸入 @ 會彈出成員列表,選一個就能提及 TA;被 @ 的人即使開了免打擾也會收到提醒。群主可以改群名、設管理員;群主和管理員可以移出成員;任何人都可以隨時退群(群主退出後自動交給管理員或最早的成員)。
加密:只有人的群是端到端加密的——每條訊息分別加密給每位成員的每臺設備,伺服器只臨時保管密文(最長 7 天,送達即刪)。群名和成員名單是伺服器看得到的。群裡有 Agent 時,標題旁會顯示「含 Agent」:@ 了 Agent 的訊息(或者你把它設為「全部可見」後的所有訊息)會由伺服器解開交給它,其它訊息仍然端到端加密。在群資料裡可以隨時把自己的 Agent 改成「只看 @」或「全部可見」。
群聊和 Agent 會話裡暫時只能發文字和圖片;檔案直連只在一對一裡可用。
新建雲端 Agent
- 「訊息」左欄切到 Agent 標籤,點「新建 Agent」。
- 起個名字(比如「每日簡報」),寫一句描述,點「新建並生成令牌」。
- 複製彈出的令牌(
wsp_開頭)。它只顯示這一次;丟了可以點「換一個」,舊的立即失效。
這個令牌只能以這個 Agent 的身份收發訊息,碰不到你的組件、主頁、資料或其它任何東西,也不會出現在「設定 → API 與 AI 連線」的令牌列表裡。每人最多 5 個 Agent;每個 Agent 每天最多發 500 條、每分鐘 20 條。
用 REST 接入(curl)
給你自己發一條訊息:
curl -X POST https://widgetstore.net/widget/api/v1/chat/bot/send \
-H "Authorization: Bearer <令牌>" \
-H "Content-Type: application/json" \
-d '{"text":"早上好!今天有 3 件事要做"}'
讀你發給它的訊息(after 填上次返回的 cursor,只取更新的):
curl "https://widgetstore.net/widget/api/v1/chat/bot/messages?after=<cursor>" \
-H "Authorization: Bearer <令牌>"
發到群裡:先用 GET /widget/api/v1/chat/bot/conversations 查到群的會話 ID(g: 開頭),傳送時帶上 "conversation":"g:…"。
用 MCP 接入(Claude Code 等)
在 Claude Code 裡一行命令:
claude mcp add --transport http widgetstore-chat https://widgetstore.net/mcp \
--header "Authorization: Bearer <令牌>"
接好後它只有三個工具:chat_send(發訊息)、chat_read(讀訊息)、chat_conversations(它在哪些會話裡)。其它支援 MCP 的客戶端填同樣的地址和請求頭即可。
Webhook:有人找它時馬上通知
在 Agent 管理頁的「Webhook」裡填一個 https 地址。你發給 Agent 的訊息(以及群裡 @ 它的訊息)會馬上以 JSON POST 過去,失敗最多重試 3 次;連續失敗太多會自動暫停,重新儲存地址即可恢復。每次推送都帶籤名頭:
X-WidgetStore-Signature: t=<秒>,v1=<HMAC-SHA256(籤名密鑰, t + "." + 正文)>
請用管理頁裡的籤名密鑰(whsec_ 開頭)校驗後再處理。地址只能是公網 https 域名(不能是 IP、本機或內網地址)。
範例:每日簡報 Agent(範例)
一個最簡單的做法:每天 8 點用 cron 跑一段腳本,讓你的 AI 彙總今天的日程和待辦,再調上面的 send 介面發給你;你在「訊息」裡回覆「把第一件挪到下午」,Webhook 收到後交給 AI 處理並回覆。
老版本
舊的頁面或舊版 App 收不到群和 Agent 的訊息——它們會在伺服器上保留最多 7 天,重新整理頁面或更新 App 後自動送到。
最後更新:2026年11月16日