Groups and cloud agents — let your AI reach you in Messages
Create groups in WidgetStore Messages and connect Claude Code, Codex or your own bot as a cloud agent via REST, MCP or webhooks. People-only groups stay end-to-end encrypted.
Besides one-to-one chats, Messages now has groups and cloud agents — bot contacts that belong to you. Your Claude Code, Codex or your own bot can use one to message you (say, a morning briefing), read your replies, and join groups you add it to.
Groups
- Open Messages and click New group (the two-people icon).
- Name it and pick people — only your contacts (circle members, focus buddies) and your own agents.
- Click Create group. Up to 50 people and 5 agents.
Type @ in a group to mention someone; a mention notifies them even if they muted the group. The owner can rename the group and make admins; the owner and admins can remove members; anyone can leave at any time.
Encryption: groups with only people are end-to-end encrypted — each message is encrypted separately for every member's every device, and the server only holds ciphertext until delivery (up to 7 days). The server does see the group name and member list. When a group has an agent, the header says "Has agent": messages that @mention the agent (or every message, if you set it to "see all") are decrypted by the server and handed to it; everything else stays end-to-end encrypted.
Groups and agent chats support text and images for now; direct file transfer is one-to-one only.
Create a cloud agent
- In Messages, open the Agents tab and click New agent.
- Give it a name (e.g. "Daily briefing") and a description, then click Create and get token.
- Copy the token (starts with
wsp_). It's shown only once; if it leaks, click New token and the old one stops working at once.
The token can only send and read messages as this agent — it can't touch your widgets, page, data or anything else. Up to 5 agents per person; each agent can send 500 messages a day and 20 a minute.
Connect with REST (curl)
curl -X POST https://widgetstore.net/widget/api/v1/chat/bot/send \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{"text":"Good morning! 3 things on your plate today"}'
Read what you sent it (pass the last cursor as after to get only newer ones):
curl "https://widgetstore.net/widget/api/v1/chat/bot/messages?after=<cursor>" \
-H "Authorization: Bearer <TOKEN>"
To post in a group, look up its id (starts with g:) with GET /widget/api/v1/chat/bot/conversations and send with "conversation":"g:…".
Connect with MCP (Claude Code etc.)
claude mcp add --transport http widgetstore-chat https://widgetstore.net/mcp \
--header "Authorization: Bearer <TOKEN>"
It then has exactly three tools: chat_send, chat_read and chat_conversations.
Webhooks
Enter an https URL under Webhook on the agent's page. Messages you send the agent (and group messages that @mention it) are POSTed there as JSON right away, with up to 3 retries. Every delivery is signed:
X-WidgetStore-Signature: t=<seconds>,v1=<HMAC-SHA256(signing secret, t + "." + body)>
Verify it with the signing secret (whsec_…). Only public https domains are accepted.
Example: a daily-briefing agent (example)
Run a script every morning that asks your AI to summarize today's calendar and to-dos and calls send. Reply in Messages ("move the first one to the afternoon"); your webhook passes it to the AI, which answers.
Older versions
Old pages and older app versions don't receive group or agent messages; the server keeps them up to 7 days and delivers them after you refresh or update.
Last updated: Nov 16, 2026