---
title: Соцсети / Social AI
description: AI Social Manager — Telegram, Blog, VK, Threads, Instagram, атрибуция.
---

# Соцсети / Social AI

Workspace бренда: стратегия, каналы, публикация, отчёты, listening, inbox и UTM-атрибуция.

## Возможности

| Возможность | Статус |
| --- | --- |
| Brand Discovery + стратегия | ✅ |
| AI контент-план (7 дней) → ideas + drafts + calendar | ✅ |
| Обложка (upload файл) + до 2 URL-кнопок (Telegram inline) | ✅ |
| Единый экран «Контент»: план + правки + согласование + календарь | ✅ |
| План без дублей + fill по отчётам / memory; published → used | ✅ |
| Telegram Bot API | ✅ |
| CMS Блог | ✅ |
| VK `wall.post` + OAuth | ✅ |
| Threads + Instagram (Meta) | ✅ |
| Approvals → schedule → publish + worker tick | ✅ |
| Метрики + недельный AI-отчёт | ✅ |
| Strategy memory + эксперименты | ✅ |
| Listening / Inbox | ✅ (ingest + UI) |
| UTM → register / payment attribution | ✅ |
| Boosty | stub |
| Autopilot | нет (manual approval) |

## Каналы

Мастер **+ Добавить канал** или **OAuth** в списке (VK / Threads / Instagram).

### Env

| Переменная | Назначение |
| --- | --- |
| `VK_APP_ID` / `VK_APP_SECRET` | VK OAuth |
| `META_APP_ID` / `META_APP_SECRET` | Threads + Instagram |
| `*_OAUTH_REDIRECT_URI` | иначе `{PUBLIC_API_URL}/v1/social/oauth/.../callback` |
| `WORKER_SECRET` | publish + metrics + plan refill tick |

Ручные токены тоже работают: Telegram (`bot_token`, `chat_id`), VK (`access_token`, `owner_id`), Threads/IG (`access_token` + user id).

## Pipeline

1. Discovery → стратегия (активировать).
2. **Контент** (единый экран): сгенерировать / дополнить план → список всех постов со статусами → открыть карточку → править, согласовать, в календарь или опубликовать.
3. Календарь недели и опубликованные — на том же экране. Worker: `POST /v1/internal/social/tick`.

Ручной пост: кнопка **Новый пост** в Контенте.

## Атрибуция

При `POST .../users/register` передай `utm_source`, `utm_medium`, `utm_campaign` (или `acquisition_source`).  
`utm_campaign` = **brand code**. Платежи подтягивают source из `application_users.acquisition_source`.

Раздел **Атрибуция** в workspace: регистрации, платежи, выручка по campaign.

## API (фрагмент)

Префикс `YOUR_API_URL/v1/social` (admin JWT), кроме OAuth callback.

- `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=`

## Автономность

По умолчанию **manual** — publish без approval → `approval_required`.  
`assisted` / `autopilot` / `full_manager`: worker добирает тонкий план (`mode: fill`); для `manual`/`assisted` publish по-прежнему ждёт approval.