# Справочник API сервиса дизайна (`~~дизайн`)

> Имя файла сохранено как `canva-api.md` для совместимости со структурой пака.
> Canva заблокирована в РФ — основной путь это `~~дизайн`: **VistaCreate**
> (быв. Crello), **Supa**, **Поликрафт**, Сберографика. Описанная ниже логика —
> обобщённый шаблон работы с API сервиса дизайна (автозаполнение шаблонов,
> загрузка ассетов, экспорт). Конкретные эндпоинты сверяйте с документацией
> вашего сервиса. Если у владельца есть доступ к Canva — те же шаги применимы
> к Canva Connect API.

Базовый URL: зависит от сервиса (например, VistaCreate API).
Авторизация: Bearer-токен (OAuth 2.0). Нужны права на чтение/запись дизайнов и ассетов.

---

## Содержание

1. [Требования по тарифу](#требования-по-тарифу)
2. [Брендовые шаблоны](#брендовые-шаблоны)
3. [Автозаполнение](#автозаполнение)
4. [Копия дизайна (базовый тариф)](#копия-дизайна-базовый-тариф)
5. [Загрузка ассета](#загрузка-ассета)
6. [Экспорт](#экспорт)
7. [Коды ошибок](#коды-ошибок)

---

## Требования по тарифу

| Возможность | Бесплатный | Платный | Командный |
|-------------|------------|---------|-----------|
| Создавать дизайны | ✓ | ✓ | ✓ |
| Список своих дизайнов | ✓ | ✓ | ✓ |
| Брендовые шаблоны (чтение) | — | ✓/— | ✓ |
| Автозаполнение брендовых шаблонов | — | ✓/— | ✓ |
| Загрузка ассета | — | ✓ | ✓ |

> Наличие API-автозаполнения зависит от сервиса и тарифа. Если API недоступно — работайте через ручной выбор шаблона и описание правок для владельца (см. раздел «Копия дизайна»).

---

## Брендовые шаблоны

**Список шаблонов:**
```
GET /brand-templates?query={ключевое слово}
```
Поля, которые интересны:
- `id` — передаётся в автозаполнение
- `title` — человекочитаемое название
- `thumbnail.url` — превью
- `dataset[].label` — метки полей автозаполнения (например, «Headline», «ProductName»)

Фильтруйте по `title`, содержащему тип ассета (например, «квадратный пост», «сторис», «шапка письма»).

---

## Автозаполнение

Заполняет переменные поля шаблона и создаёт новый дизайн:

```
POST /autofills
{
  "brand_template_id": "<id_шаблона>",
  "title": "Летняя акция — пост 1",
  "data": {
    "Headline": { "type": "text", "text": "Летняя акция: −30% на свечи" },
    "ProductImage": { "type": "image", "asset_id": "<id_загруженного_ассета>" }
  }
}
```

Ответ: `{ "job": { "id": "<id_задачи>", "status": "queued" } }`

Опрашивайте `GET /autofills/{id_задачи}` до `status == "success"`. В ответе будет `result.design.id` — используйте его для экспорта.

---

## Копия дизайна (базовый тариф)

На базовых тарифах прямого «копирования шаблона» через API может не быть. Процесс:

1. `GET /designs?query={название шаблона}` — список дизайнов по имени
2. Покажите топ-3 владельцу; получите подтверждение
3. `POST /designs` с указанием типа ассета, чтобы создать пустой дизайн нужных размеров, затем опишите, что владельцу обновить вручную в сервисе.

Генерация на базовом тарифе полуручная: Claude создаёт «заготовку» дизайна и заполняет то, что позволяет API; владелец применяет брендовые правки в сервисе и возвращает ID дизайна для экспорта.

---

## Загрузка ассета

Используйте, когда бриф ссылается на фото товаров на диске владельца.

**Шаг 1 — инициализация загрузки:**
```
POST /asset-uploads
{ "name_base64": "<base64(имя файла)>", "types": ["image/jpeg"] }
```
Ответ: `{ "job": { "id": "<id_задачи>" }, "upload_url": "<presigned_url>" }`

**Шаг 2 — загрузка файла:**
```
PUT <upload_url>
Content-Type: image/jpeg
Body: <сырые байты файла>
```

**Шаг 3 — опрос до готовности:**
`GET /asset-uploads/{id_задачи}` → дождитесь `status == "success"` → захватите `asset.id`.

Макс. размер файла: 100 МБ. Поддерживаемые типы: `image/jpeg`, `image/png`, `image/webp`.

---

## Экспорт

**Зачем экспортировать каждый дизайн:** превью из ответа автозаполнения — это
короткоживущий аутентифицированный URL CDN. Он истекает за минуты и
рендерится как битая заглушка «Показать изображение», если встроить его в
markdown-картинку после истечения. Вывод `POST /exports` — **постоянный URL**,
безопасный для встраивания в превью в чате, прикрепления к публикации в
`~~crm` и отправки владельцу.

Всегда экспортируйте каждый дизайн после генерации, до показа превью.

```
POST /exports
{
  "design_id": "<id_дизайна>",
  "format": {
    "type": "png",
    "export_quality": "regular",
    "pages": [1]
  }
}
```

Опрашивайте `GET /exports/{id_задачи}` до `status == "success"`. В ответе `urls[]` — используйте `urls[0]` как ссылку превью и URL вложения для `~~crm`.

**Эквиваленты через MCP** (если используете коннектор `~~дизайна` в Cowork вместо прямого REST):

| Нужно | Инструмент MCP | Возвращает |
|-------|----------------|------------|
| Постоянный URL превью | `export-design` | Постоянный URL загрузки (безопасно встраивать) |
| Превью страницы (стабильнее ответа автозаполнения, но не постоянный) | `get-design-thumbnail` | URL превью страницы |
| Только метаданные дизайна | `get-design` | Название, владелец, число страниц, превью |
| Загрузка с машины владельца | `upload-asset-from-url` | `asset_id` (один URL на вызов) |

**Рекомендации по форматам по каналам:**

| Канал | Тип | Размеры |
|-------|-----|---------|
| Лента Telegram/VK (квадрат) | `png` | 1080×1080 |
| Сторис / вертикаль (VK Клипы, обложка) | `png` | 1080×1920 |
| Лента VK/ОК (горизонталь) | `png` | 1200×630 |
| Шапка письма | `png` | 600×200 |

---

## Лимиты частоты запросов и бюджет генерации

**Жёсткий лимит:** зависит от сервиса (например, N запросов в минуту на токен). Сверьте с документацией `~~дизайна`.

**Стоимость дизайна:** ~5 вызовов API — 1 `POST /autofills` + 1 `POST /exports` + ~3 раунда опроса (`GET /autofills/{id}`, `GET /exports/{id}`). Частота опроса — 3–5 секунд; более частый опрос жжёт квоту, не ускоряя завершение.

**Безопасный потолок:** ~15–20 дизайнов в минуту оставляют комфортный запас под лимит.

**Рекомендуемый темп (используется Стадией 3):**

```
3 кандидата на строку × 1 строка за раз × пауза 30 с между строками
= 6 дизайнов (~30 вызовов API) за 30 секунд
= 12 дизайнов / минуту, около половины потолка
```

**Формула бюджета на предполёте:**

```
всего_дизайнов = (строк под макет) × (кандидатов на строку, по умолч. 3)
всего_вызовов  ≈ всего_дизайнов × 5
время_генерации ≈ (всего_дизайнов / 12) минут
```

**Паттерн отката при `RATE_LIMIT_EXCEEDED`:**

1. Первый раз за сессию → ждём 60 с, повторяем этого одного кандидата. Трактуем как временный всплеск.
2. Второй раз за ту же сессию, или любая ошибка `quota_exceeded` / дневного лимита → останавливаем генерацию и показываем прогресс владельцу. Не повторяем. Скилл спрашивает владельца: (а) перейти на 1 кандидата на оставшуюся строку, (б) пауза и продолжение через 60 минут, (в) остановиться и перейти к текстам с тем, что уже сгенерировано.

---

## Коды ошибок

| Код | Значение | Что делать |
|-----|----------|------------|
| `PERMISSION_DENIED` | Нет права или не тот тариф | Проверьте тариф; попросите владельца переподключить `~~дизайн` с нужными правами |
| `DESIGN_NOT_FOUND` | Неверный ID дизайна | Запросите список дизайнов и подтвердите ID |
| `AUTOFILL_FIELD_NOT_FOUND` | Имя поля шаблона не совпадает | Запросите метаданные шаблона и перечитайте `dataset[].label` |
| `RATE_LIMIT_EXCEEDED` | Слишком много запросов | Первый раз: ждём 60 с, повтор. Второй раз: стоп и вопрос владельцу (см. выше) |
| `JOB_FAILED` | Асинхронная задача сбойнула | Проверьте `job.error.message`; частая причина — слишком большой ассет |

# Подводные камни

Типичные режимы сбоя скилла canva-creator.

> Во всём файле под `~~дизайн` понимается сервис дизайна (VistaCreate, Supa,
> Поликрафт), под `~~crm` — сервис постановки публикаций в очередь
> (Битрикс24, amoCRM). Каналы РФ: Telegram, VK, Дзен, Одноклассники, RuTube.

---

## Камень: генерация ЛЮБОГО макета `~~дизайна` для email-строки

**Почему важно:** владелец полностью вывел `~~дизайн` из email-пути.
Автозаполнение email-шаблонов даёт заглушки-картинки (стоковые пейзажи,
пустые прямоугольники) в плитках, а превью вариантов не рендерятся в чате.
Решение было: письма из этого скилла — только текст, точка. Сгенерировать
email-макет — даже один — это откат явного решения.

### ✗ Плохо

```
В календаре 6 строк соцсетей + 2 email-строки.
→ Стадия 2 генерирует 6 соцмакетов + 2 email-макета.
→ Email-макеты выходят с плитками-заглушками.
```

Или любой вариант: «сгенерирую email-шаблон просто для референса», «нашёл email-шаблон, показать превью?», «вот макет для письма 05.06…» — всё запрещено.

### ✓ Хорошо

```
Стадия 1: календарь собран со столбцом «Путь».
  - 6 строк помечены «Макет (соцсети)»
  - 2 строки помечены «Только текст» (без ~~дизайна)
Стадия 2: генерирует ровно 6 макетов ~~дизайна. Email-строки не передаются
          ни в один эндпоинт ~~дизайна.
Стадия 3: пишет 6 подписей для соцсетей + 2 полных письма (тема + прехедер + тело) текстом.
Стадия 5: ставит 6 соцпостов в очередь ~~crm. Выдаёт 2 письма инлайн для копирования в сервис рассылки.
```

Если владелец явно просит email-макет в `~~дизайне` («можешь сделать версию письма 05.06 в VistaCreate?»), перенаправьте: «Этот скилл держит письма текстовыми, потому что email-путь в дизайн-сервисе даёт заглушки-картинки. Если хотите письмо с дизайном — соберите его прямо в `~~дизайне`, а я помогу с текстом здесь.»

---

## Камень: генерация без плана бюджета

**Почему важно:** `~~дизайн` ограничивает частоту запросов, и каждый макет
стоит ~5 вызовов (автозаполнение + экспорт + опрос). Кампания на 10 строк с
4 кандидатами на строку генерирует 40 макетов и ~200 вызовов API — а при
параллелизме хуже. Без предполётного бюджета владелец упирается в квоту
посреди кампании без понятного пути восстановления, и четыре уже
сгенерированных поста лежат без дела.

### ✗ Плохо

```
Календарь согласован → сразу запускаем 4 кандидата × 8 строк параллельно
→ ~160 вызовов за 90 секунд → RATE_LIMIT_EXCEEDED на 5-м посте → цикл
повторов → владелец заблокирован.
```

### ✓ Хорошо

```
Предполёт: «8 строк под макет × 3 кандидата = 24 макета, ~120 вызовов API.
Идём по умолчанию 3 кандидата на строку?»

Стадия 3: 3 кандидата строки 1 параллельно → пауза 30 с → строка 2 →
пауза 30 с → строка 3 → … заканчивается на ~12 макетах/минуту, с запасом.

Если квота всё же сработала: стоп, показать прогресс, спросить владельца —
перейти на одного кандидата, пауза на час, или к текстам с тем, что есть.
```

---

## Камень: пропуск Контрольной точки 1 (согласование календаря) до генерации

**Почему важно:** генерация 10+ макетов `~~дизайна` стоит вызовов API,
времени и внимания. Если в календаре не те даты, не те каналы или владелец
передумал насчёт темы — вся работа в мусор. Контрольная точка календаря —
самое дешёвое место поймать рассинхрон.

### ✗ Плохо

Получили бриф → сразу начали вызывать автозаполнение по всем 12 постам → показываем макеты до того, как владелец согласовал расписание.

Владелец: «Стоп, я не хотел постов на неделе с 15-го, я в отъезде.»

### ✓ Хорошо

Сначала показать таблицу-календарь. Дождаться явного «годится», прежде чем открывать хоть один вызов API `~~дизайна`.

---

## Камень: в шаблоне больше слотов под изображения, чем фото в брифе

**Почему важно:** многослотовые соцшаблоны (карусели, товарные сетки) могут
иметь 3+ слота. Когда бриф даёт 1 фото, а шаблон требует 3, незаполненные
слоты молча рендерят стоковую заглушку — облака и зелёные холмы вместо фото
товара. Макет выглядит «готовым», пока владелец его не откроет.

(Примечание: email-строки полностью пропускают `~~дизайн` — см. SKILL.md, Стадия 3. Этот камень касается только соцшаблонов с несколькими слотами.)

### ✗ Плохо

Собрать манифест с одной строкой на макет («Карусель — нужен Hero_Image»). Загрузить одно фото. Сгенерировать. Карусель выходит со слайдом 1 заполненным и слайдами 2–3 с одинаковыми стоковыми пейзажами.

### ✓ Хорошо

Собрать манифест по слотам. Показать пробел явно:

```
В шаблоне «карусель из 3 товаров» 3 слота под изображения. Бриф дал мне
1 фото. Чем заполнить остальные 2?

1. Повторить то же фото во всех 3 слотах
2. Я пришлю ещё 2 фото
3. Выбрать одно-слотовый шаблон
```

Дождаться выбора владельца до генерации. Не дать заглушкам уйти в публикацию.

---

## Камень: доверять `status: success` без экспорта и визуальной проверки

**Почему важно:** успешная задача автозаполнения значит, что `~~дизайн`
принял запрос и создал дизайн — не что в дизайне правильные изображения.
Если `asset_id` был пустым, устаревшим или не того типа, задача всё равно
вернёт `status: success`, а дизайн отрендерится с дефолтными заглушками.
Единственный способ узнать — посмотреть на готовый вывод.

### ✗ Плохо

```
Статус задачи: success ✓
result.design.id: есть ✓
→ Показать владельцу
```

Результат: владелец открывает карусель и видит стоковые пейзажи в 3 из 4 макетов.

### ✓ Хорошо

После успеха задачи экспортируйте каждый дизайн в постоянный PNG. Посмотрите на каждый PNG и подтвердите, что в нём реальные ассеты — не дефолтный пейзаж, не серые прямоугольники, не текст-рыба. Показывайте владельцу только после прохождения визуальной проверки.

---

## Камень: один макет в пакете не отрендерился

**Почему важно:** когда 1 из 4 макетов в пакете сбоит (ошибка задачи,
истёкший URL превью, отрендеренная заглушка), а вы показываете частичную
карусель, владелец видит три реальных макета и один серый прямоугольник
«Показать изображение». Он теряет доверие к остальным, хотя они в порядке.

### ✗ Плохо

```
Макеты недели 1 готовы:
[Вариант A — реальное превью]
[Вариант B — реальное превью]
[Вариант C — реальное превью]
[Вариант D — заглушка «Показать изображение»]
Какой использовать?
```

### ✓ Хорошо

Когда поймали битый макет на проверке (Шаг 6), перегенерируйте только его с правильным asset_id. Переэкспортируйте, перепроверьте. Показывайте только когда все четыре макета пакета имеют постоянные проверенные превью. Если вторая попытка тоже сбоит — спросите владельца: пропустить, сменить шаблон или попробовать другое фото.

---

## Камень: генерация без подтверждения, что у всех полей автозаполнения есть значения

**Почему важно:** автозаполнение молча рендерит пустые заглушки, когда
значение поля отсутствует или указанный `asset_id` не существует. Результат —
профессионально выглядящий шаблон с пустыми белыми прямоугольниками там, где
должны быть фото товара и заголовок.

### ✗ Плохо

Собрать календарь → сразу запустить всё автозаполнение параллельно → половина макетов приходит с пустыми заглушками, потому что фото товаров не были загружены заранее.

### ✓ Хорошо

Собрать календарь → инвентаризировать каждый слот автозаполнения по отдельности → загрузить недостающие фото → подтвердить все значения полей с владельцем → затем генерировать параллельно, с заранее заполненными полями.

---

## Камень: передача неверных значений в поля изображений автозаполнения

**Почему важно:** когда поле изображения получает пустую строку, путь к
файлу, URL или устаревший/неверный `asset_id`, `~~дизайн` не выдаёт ошибку —
он молча рендерит дефолтную заглушку шаблона (например, обобщённый пейзаж с
облаками и холмами). Макет выглядит «готовым», но главное изображение —
сток, а не фото товара владельца.

### ✗ Плохо

Загрузить фото товара → не дождаться завершения задачи загрузки → передать `job_id` (а не `asset.id`) в данные автозаполнения → дизайн рендерится с заглушкой-пейзажем вместо фото.

### ✓ Хорошо

Загрузить фото через `POST /asset-uploads` → опрашивать `GET /asset-uploads/{job_id}` до `status == "success"` → извлечь `asset.id` из ответа → передать именно этот ID в поле изображения. Проверить, что у каждого поля изображения есть подтверждённый `asset.id`, до вызова автозаполнения.

---

## Камень: встраивание временных URL превью в markdown

**Почему важно:** ответ автозаполнения возвращает короткоживущие
аутентифицированные URL CDN. Они истекают за минуты. Если встроить их как
markdown-картинки (`![](.../...)`), к моменту показа сообщения они
отрендерятся как битые заглушки «Показать изображение».

### ✗ Плохо

Сгенерировать 8 макетов → вручную встроить каждый временный URL превью в ответ как `![Hero 1](https://...)` → все картинки показываются битыми серыми заглушками, потому что URL истекли до рендера.

### ✓ Хорошо

Либо дайте нативной карусели Cowork отрендерить результат инструмента автоматически, либо экспортируйте каждый дизайн через `POST /exports` и встройте **постоянный** URL экспорта. Финальный запасной вариант: ссылка на постоянный URL редактирования дизайна. Никогда не встраивайте повторно временные превью-URL.

---

## Камень: перечисление макетов по одному отдельными блоками-картинками

**Почему важно:** когда Claude перечисляет каждый макет отдельным блоком
(«Hero 1 / [картинка] / Hero 2 / [картинка]»), картинки рендерятся битыми
серыми заглушками «Показать изображение». Показ всех макетов вместе одним
сгруппированным пакетом запускает карусель Cowork, которая рендерится верно.

### ✗ Плохо

```
Hero 1 — Портфолио из нескольких объектов
[Показать изображение]
Открыть в ~~дизайне: https://.../d/xxx

Hero 2 — Кейс прибрежного рынка
[Показать изображение]
Открыть в ~~дизайне: https://.../d/yyy
```

### ✓ Хорошо

Показать все макеты в одном сгруппированном ответе, чтобы они отрендерились каруселью. Под каруселью — одна подсказка:

```
Вот 4 hero-макета для недели 1. Пролистайте карусель выше и скажите,
какой оставить.
```

---

## Камень: генерация макетов последовательно вместо параллельной

**Почему важно:** генерация по одному значит, что владелец ждёт N
оборотов вместо одного. Запускайте все запросы генерации в пакете сразу и
показывайте выбор после завершения всех задач.

### ✗ Плохо

Сгенерировать макет 1 → ждать → показать → макет 2 → ждать → показать → … × 8. Владелец смотрит медленную капельницу 10 минут.

### ✓ Хорошо

Запустить все макеты текущего пакета сразу → опрашивать все задачи параллельно → по завершении экспортировать каждый → проверить визуально → затем показать.

---

## Камень: автовыбор брендового шаблона на базовом тарифе

**Почему важно:** на базовых тарифах нет API-доступа к брендовым шаблонам.
Если Claude угадает шаблон по имени и сгенерирует не с тем, владелец получит
макеты в неверных цветах/шрифтах и будет переделывать вручную.

### ✗ Плохо

```
Нашёл шаблон «Квадрат — Синий». Использую его для всех постов в ленту.
```
…за чем следуют 8 макетов в синем, когда бренд — зелёный.

### ✓ Хорошо

```
Нашёл 3 шаблона в вашей библиотеке ~~дизайна для постов в ленту:
1. Квадрат — Синий  (правлен март 2026)
2. Летняя акция — Зелёный  (правлен апр. 2026)
3. Карточка товара  (правлен янв. 2026)

Какой использовать?
```

---

## Камень: дрейф голоса подписей по длинному календарю

**Почему важно:** при написании 12–20 подписей за один проход тон дрейфует —
ранние подписи следуют голосу брифа, поздние сползают в обобщённый
маркетинговый текст. Владельцы замечают сразу.

### ✗ Плохо

Пост 1: «Наши свечи ручной работы — идеальный летний подарок 🌿» (по брифу: «тёплый, разговорный»)
Пост 10: «Раскройте атмосферу с нашей коллекцией авторских ароматов.» (корпоративный дрейф)

### ✓ Хорошо

Перед написанием зафиксируйте 2–3 голосовых маркера из брифа (например, «непринуждённо, по-дружески, с лёгким юмором»). Перечитывайте первую черновую подпись перед каждой новой. Если владелец отметил рассинхрон голоса на какой-то подписи — перечитайте её и сделайте точкой перекалибровки для остальных черновиков.

---

## Камень: постановка постов в `~~crm` без проверки, что время публикации в будущем

**Почему важно:** `~~crm` отклоняет посты со временем публикации в прошлом с
ошибкой валидации. Если календарь строился на более раннюю дату, а владелец
ставит в очередь только сейчас, некоторые даты могли пройти.

### ✗ Плохо

Построить календарь 01.04 на июньские посты → владелец согласовал 15.05 → попытаться поставить в очередь без проверки → пост на «30.04 10:00» возвращает ошибку.

### ✓ Хорошо

Перед постановкой в очередь сравните каждое время публикации с текущим временем. Если какая-то дата прошла, покажите: «Пост на 30.04 уже прошёл. Пропустить или перенести на следующую неделю?»

---

## Камень: пропуск маркировки рекламы для платных размещений (РФ)

**Почему важно:** в РФ с 01.09.2022 рекламные креативы для **платных**
размещений (Яндекс Директ, VK Реклама, Telegram Ads, посевы в чужих каналах
за деньги) требуют маркировки: токен через ОРД (оператор рекламных данных) и
передача данных в ЕРИР. Пропуск = риск штрафа для владельца. Органические
посты в собственных каналах бренда маркировки не требуют.

### ✗ Плохо

Поставить платный креатив в очередь / запустить таргет без токена ОРД, не уточнив у владельца статус размещения.

### ✓ Хорошо

До постановки в очередь спросить владельца: «Это размещение платное (таргет/посев за деньги) или органический пост в вашем канале?» Если платное — напомнить, что нужен токен ОРД и передача в ЕРИР, и не ставить креатив в очередь без подтверждённого статуса маркировки. ⚠️

# Справочник: постановка кампании в очередь через `~~crm`

> Имя файла сохранено как `hubspot-staging.md` для совместимости со структурой
> пака. Содержимое адаптировано под РФ: вместо HubSpot — `~~crm` (**Битрикс24**,
> **amoCRM**, RetailCRM). Эндпоинты ниже — обобщённый шаблон; сверяйте с
> документацией вашей CRM (в Битрикс24 планирование публикаций живёт в модуле
> CRM-маркетинга / мессенджер-маркетинга).

Требуется: тариф `~~crm` с модулем планирования публикаций в соцсетях/мессенджерах.
Авторизация: Bearer-токен (OAuth 2.0 или ключ приложения).

---

## Содержание

1. [Проверка тарифа](#проверка-тарифа)
2. [Создание кампании](#создание-кампании)
3. [Создание поста](#создание-поста)
4. [Проверка очереди](#проверка-очереди)
5. [CSV-запасной вариант (без модуля планирования)](#csv-запасной-вариант-без-модуля-планирования)
6. [Справочник полей](#справочник-полей)

---

## Проверка тарифа

Если неясно, есть ли у владельца модуль планирования публикаций:

```
GET /crm/v3/objects/companies?limit=1
```

Проверьте тариф/подписку аккаунта. Если API возвращает 403 на эндпоинтах публикаций, скажите владельцу: «Постановка постов в очередь требует тарифа `~~crm` с модулем планирования публикаций. Ваш текущий тариф его не включает. Могу вместо этого выгрузить CSV для планировщика — подойдёт?»

---

## Создание кампании

```
POST /marketing/v3/campaigns
{
  "name": "Летняя акция 2026 — соцсети",
  "startDate": "2026-06-01",
  "endDate":   "2026-06-30",
  "currencyCode": "RUB",
  "utm": {
    "source": "social",
    "medium": "owned",
    "campaign": "letnyaya-akciya-2026"
  }
}
```

Ответ: `{ "id": "<id_кампании>", ... }` — сохраните для привязки постов.

---

## Создание поста

Один вызов на строку календаря. Ставьте как `ЗАПЛАНИРОВАНО` (`SCHEDULED`), никогда не `ОПУБЛИКОВАНО` (`PUBLISHED`).

```
POST /marketing/v3/social/posts
{
  "campaignId": "<id_кампании>",
  "channelId":  "<id_канала_в_crm>",
  "content": {
    "body": "<согласованный текст подписи>"
  },
  "scheduledAt": "2026-06-03T10:00:00+03:00",
  "attachments": [
    {
      "url": "<постоянный_png_url_из_дизайна>"
    }
  ],
  "status": "SCHEDULED"
}
```

**`channelId`** — ID подключённого аккаунта соцсети в `~~crm` (не название платформы). Получить подключённые аккаунты:
```
GET /marketing/v3/social/channels
```
Сопоставьте по `type` (`TELEGRAM`, `VK`, `OK`, `DZEN`) и используйте поле `id`.

**`scheduledAt`** — должно быть в будущем (относительно момента вызова API). Используйте время по часовому поясу владельца (МСК = `+03:00`), если он не указал иное.

---

## Проверка очереди

После постановки всех постов:

```
GET /marketing/v3/social/posts?status=SCHEDULED&campaignId=<id_кампании>
```

Покажите результат таблицей: дата, канал, первые 60 знаков подписи, статус. Дайте прямую ссылку на кампанию:
`https://<ваш-портал>.bitrix24.ru/marketing/campaigns/{id_кампании}`

Скажите владельцу: «Посты в очереди и опубликуются автоматически. Любой пост можно отменить или отредактировать в CRM до времени выхода.»

---

## CSV-запасной вариант (без модуля планирования)

Когда постановка через `~~crm` недоступна, выгрузите CSV, который владелец импортирует в свой планировщик (SMMplanner, Postoplan, Amplifr и т.п.).

Заголовки столбцов:
```
Дата,Время,Канал,Подпись,СсылкаНаКартинку,Статус
```

Пример строки:
```
03.06.2026,10:00 МСК,Telegram,"Летняя акция: −30% на свечи ☀️ ...",https://.../export/...,Запланировано
```

Скажите владельцу: «Подготовил CSV для планировщика, раз ваш тариф `~~crm` не включает планирование публикаций. Импортируйте его в SMMplanner или Postoplan. [путь к файлу]»

---

## Справочник полей

| Поле | Тип | Примечания |
|------|-----|------------|
| `campaignId` | строка | UUID из создания кампании |
| `channelId` | строка | Из `GET /social/channels` |
| `content.body` | строка | Текст подписи; до 2 000 знаков |
| `scheduledAt` | ISO 8601 | Время в будущем; со смещением часового пояса (МСК `+03:00`) |
| `attachments[].url` | строка | Публичный URL (URL экспорта из `~~дизайна` подходит) |
| `status` | enum | Всегда `"SCHEDULED"` — никогда `"PUBLISHED"` |