2.0.0

SocialMate 2.0.0 — the first stable release

Your WhatsApp automation server. On your desktop — and now on your own server.

SocialMate 2.0.0 is the first production release: a cross-platform desktop app
(Windows, macOS, Linux) and a self-hosted headless server (Docker / any
Linux VPS), built from the same source and shipped in the same release. It
connects your own WhatsApp number and gives your tools — n8n, an AI agent over
MCP, or anything that speaks HTTP — a safe, rate-limited way to message through
it. Everything runs on your machine; nothing is stored in a cloud.

Self-host on a VPS (SocialMate 2.0)

• Docker image — ghcr.io/micbwilliam/socialmate-server. One command:
  docker compose up -d. Persist one volume, reach it at :3456/admin.
• systemd installer — one script on any Ubuntu/Debian box; a
  socialmate-update command takes checksum-verified updates.
• Web admin console — the entire desktop GUI served over HTTP/WebSocket
  behind an admin login (session cookie + CSRF + lockout). Pair accounts with a
  QR in the browser, change every setting, manage your license — all remotely.
• Same license, one seat per data volume. Your devices portal at
  socialmate.app tells a Docker/VPS seat from a desktop one.

Built for AI agents and workflows

• n8n node (n8n-nodes-socialmate v2.7.0) — the only native integration.
  Every operation doubles as an AI-Agent tool.
• MCP server (socialmate-mcp, 44 tools) — plug your WhatsApp into Claude
  or any MCP-capable agent: send, search, read conversations, queue, groups,
  polls, media.
• REST API — 64 endpoints with per-key permission scopes, plus 35 webhook
  events (delivery receipts included) for everything else.
• Agent Memory (Pro) — your agent can save what it learned on the contact
  (names, notes, tags — WhatsApp sync can never clobber it) and cache media
  descriptions or transcripts your own AI produced; both ride back on history,
  AI-context and webhooks.
• Agent Studio (free) — an 8-step in-app wizard that generates a ready
  system prompt, an importable n8n workflow, and an MCP config for your
  use-case. Deterministic and offline — no AI required to use it.

Note: SocialMate is the tool and memory your AI uses. SocialMate itself
does not generate AI replies — that's still "coming soon".

Conversational primitives

Reply (quoting), typing indicators, mark-as-read, reactions, polls with live
result read-back, locations, and contact cards — over the API, n8n, and MCP.
Signals (typing, read receipts, reactions) ride a separate anti-ban lane, so
being polite never spends your message budget.

Anti-ban, honestly

Every send goes through rate limiting, human-like jitter, session warming for
new numbers, and a live risk score with automatic cooling. Free: 200 msg/day.
Pro: 500/day — or up to 5,000/day with opt-in High-Volume Mode after 72h of
warming. Batches are individually personalised and paced; identical-text
blasts are blocked by design. No tool can make a WhatsApp ban impossible —
SocialMate is built to reduce risk, not to promise immunity.

• Native residential IP — the desktop app sends from your home network,
  the same network as your phone. On a VPS, per-account proxy routing (Pro)
  lets an account egress through your own SOCKS5/HTTPS proxy to present a
  residential IP again. The anti-ban pipeline applies either way.

Also in this release

• Delivery receipts (Pro): message.delivered + message.read webhook
  events close the loop for notification workflows.
• API keys with permission scopes — mint keys that can only do what that
  integration needs.
• Full message archive on every tier — messages persist locally from day
  one; Pro unlocks history search, export, and the history/AI-context API.
• Hardening: a full end-to-end pass against real WhatsApp, Docker, and the
  whole REST/MCP/n8n matrix fixed 14 defects before this release — from LID
  poll-vote decryption to media webhook ordering.

Get it

• Desktop: download for Windows, macOS, or Linux — updates arrive
  automatically.
• Server: docker compose up -d with ghcr.io/micbwilliam/socialmate-server:latest,
  or the systemd bundle. See docs/SELF-HOSTING.md.
• Automate: install n8n-nodes-socialmate in n8n, or npx socialmate-mcp
  for your MCP agent.

Free runs one account with live feed, webhooks, and text sends over the API.
Pro adds unlimited accounts, full history + AI-context API, scheduling, media
over the API, proxy routing, the named tunnel, and unattended operation.

1.0.0-rc.6

v1.0.0-rc.6

chore: initialize release repository

1.0.0-rc.5

v1.0.0-rc.5

chore: initialize release repository

1.0.0-rc.4

v1.0.0-rc.4

chore: initialize release repository

1.0.0-rc.3

v1.0.0-rc.3

chore: initialize release repository

1.0.0-rc.2

v1.0.0-rc.2

chore: initialize release repository

1.0.0-rc.1

v1.0.0-rc.1

chore: initialize release repository