Social AI

Brand workspace: strategy, channels, publishing, reports, listening, inbox, and UTM attribution.

Capabilities

Capability	Status
Brand Discovery + strategy	✅
AI content plan (7 days) → ideas + drafts + calendar	✅
Cover image upload + up to 2 URL buttons (Telegram inline)	✅
Unified Content screen: plan + edit + approve + calendar	✅
Deduped plan + fill from reports / memory; published → used	✅
Telegram Bot API	✅
CMS Blog	✅
VK wall.post + OAuth	✅
Threads + Instagram (Meta)	✅
Approvals → schedule → publish + worker tick	✅
Metrics + weekly AI report	✅
Strategy memory + experiments	✅
Listening / Inbox	✅ (ingest + UI)
UTM → register / payment attribution	✅
Boosty	stub
Autopilot	no (manual approval)

Channels

Use + Add channel or OAuth in the channel list (VK / Threads / Instagram).

Env

Variable	Purpose
VK_APP_ID / VK_APP_SECRET	VK OAuth
META_APP_ID / META_APP_SECRET	Threads + Instagram
*_OAUTH_REDIRECT_URI	else {PUBLIC_API_URL}/v1/social/oauth/.../callback
WORKER_SECRET	publish + metrics + plan refill tick

Manual tokens also work: Telegram (bot_token, chat_id), VK (access_token, owner_id), Threads/IG (access_token + user id).

Pipeline

1. Discovery → strategy (activate).
2. Content (single screen): generate / fill plan → list all posts with statuses → open a card → edit, approve, schedule, or publish.
3. Week calendar and published posts live on the same screen. Worker: POST /v1/internal/social/tick.

Manual post: New post on the Content screen.

Attribution

On POST .../users/register send utm_source, utm_medium, utm_campaign (or acquisition_source).
utm_campaign = brand code. Payments inherit source from application_users.acquisition_source.

Attribution section: registers, payments, revenue by campaign.

API (excerpt)

Prefix YOUR_API_URL/v1/social (admin JWT), except OAuth callbacks.

• POST /brands/:id/plan/generate (days, mode: fresh|fill), PATCH /variants/:id (body / cover / buttons)
• POST /brands/:id/content, /approvals/:id/decide, /variants/:id/publish|schedule
• GET/POST /brands/:id/insights/weekly, /accounts/:id/metrics/pull
• GET/POST /brands/:id/memory|experiments|listening|inbox
• GET /brands/:id/attribution
• GET /oauth/:provider/start?account_id=

Autonomy

Default manual — publish without approval → approval_required.
assisted / autopilot / full_manager: worker refills a thin plan (mode: fill); manual/assisted still require approval before publish.