# Postiz

Self-hosted или cloud планировщик соцсетей — X, LinkedIn, Bluesky, Mastodon, Discord, Telegram, TikTok и др.; ключ из Settings → Developers → Public API

## Сценарии

### Анонс во все каналы сразу
Агент разложит один анонс по подключённым каналам Postiz — X, LinkedIn, Telegram, Mastodon — своим текстом под каждую площадку.

### План публикаций на неделю
Агент подберёт свободные слоты в расписании каналов, поставит посты и покажет, что уже стоит в плане на ближайшие дни.

### Сводка по охватам каналов
Агент соберёт аналитику подключённых каналов за 7, 30 или 90 дней и назовёт посты, собравшие больше реакций, чем остальные.

### Проверка, что пост ушёл
Агент прочитает ленту уведомлений Postiz и покажет, какие публикации прошли, а какие площадка отклонила и с какой ошибкой.

## Как подключить

### Войдите владельцем рабочего пространства
В облаке это postiz.com, в self-hosted — адрес, по которому у вас открывается кабинет Postiz. Ключ выдаётся на всё рабочее пространство, поэтому нужен аккаунт, который им владеет.

### Подключите хотя бы один соцканал
На главном экране Postiz добавьте каналы, в которые будете публиковать — X, LinkedIn, Telegram, Bluesky, Mastodon, TikTok и другие. Без подключённых каналов ключ рабочий, но публиковать некуда.

### Скопируйте ключ в Settings → Developers → Public API
Откройте «Settings» → «Developers» → «Public API» и скопируйте ключ целиком. Он передаётся как есть, без префикса; отдельные OAuth2-токены Postiz начинаются с pos_ — для доступа по ключу они не нужны.

### Запишите адрес своего инстанса
Для облака адрес один — https://api.postiz.com. Для self-hosted возьмите корневой адрес инстанса, тот же, по которому открывается кабинет; путь до API дописывать не нужно.

## Частые вопросы

### Как подключить Postiz?
Ключом Public API: в Postiz откройте «Settings» → «Developers» → «Public API» и скопируйте ключ целиком, он передаётся без префикса. Второе поле — адрес инстанса: для облака https://api.postiz.com, для self-hosted корневой адрес вашего кабинета.

### Что агент видит в Postiz?
Подключённые соцаккаунты, ленту постов за период, свободные слоты расписания, аналитику каналов и отдельных постов и уведомления о результате публикации.

### Пишет ли агент в Postiz?
Да: создаёт черновики и запланированные посты, переключает пост между черновиком и расписанием, загружает медиа и может удалять посты и отключать каналы.

### Что с лимитами?
Public API Postiz даёт 30 запросов в час сразу на все эндпоинты, поэтому веерная публикация на несколько площадок собирается в один запрос с массивом постов.

[Открыть Postiz](https://postiz.com)