Коротко (TL;DR). Чтобы постить в сообщество VK через Uni5, нужен ключ доступа сообщества (community token) с правами «Стена», «Фото», «Документы», «Видео» и «Управление сообществом» — не user-токен. Ключ создаётся вручную в настройках сообщества и вставляется в форму на странице канала в Uni5. Вход через VK ID работает по OAuth 2.1, но для публикации в сообщество Uni5 использует именно ключ сообщества — почему, разберём ниже. Три частые проблемы: ключ создан без «Стены» или «Управления» (Uni5 его не примет), ключ отозвали в настройках сообщества (ошибка 5), VK не даёт добавить запись на стену (ошибка 214).
VK API существует давно и не раз менял схему авторизации. Актуальная схема для Uni5 (на сентябрь 2026) — ключ доступа сообщества с набором прав. Это работает, но первый раз настроить — небанально. Ниже — все шаги и типичные ошибки, которые всплывают у нас в поддержке.
Базовая схема: как VK видит ваше сообщество
В VK три уровня сущностей:
- Пользователь (вы, как админ).
- Сообщество (группа или публичная страница).
- Приложение — то, через которое внешний сервис общается с API VK.
Чтобы что-то опубликовать в сообщество от имени сообщества, Uni5 нужен ключ доступа сообщества — отдельный токен, привязанный конкретно к одному сообществу, со списком разрешённых прав (стена, фото, видео, документы, управление).
Не путайте: user access token — от лица пользователя; ключ сообщества — от лица сообщества. Для постинга в сообщество нужен второй. Личную стену Uni5 подключить не даёт — публикация идёт только в сообщества.
Что изменилось с VK ID OAuth 2.1
Вход через VK ID работает по протоколу OAuth 2.1 — в официальном SDK авторизация идёт по коду с параметром codeVerifier (PKCE). В самом OAuth 2.1 implicit-flow (response_type=token) исключён из спецификации — вместо него используется authorization code + PKCE.
Что это значит для вас как пользователя Uni5:
- Для публикации VK ID не используется. По нашему опыту, токены, которые выдаёт VK ID, годятся для входа, но не для публикации на стену сообщества, а ключ сообщества, полученный через старый OAuth-flow в URL, VK отвергал при публикации. Поэтому Uni5 принимает ключ, созданный вручную в настройках сообщества.
- Ключ бессрочный. Refresh-токена у него нет, продлевать его не нужно: ключ работает, пока его не отзовут.
- Uni5 проверяет ключ при подключении: что он принадлежит именно этому сообществу и что у него есть права «Стена» и «Управление сообществом».
На странице канала в дашборде Uni5 при подключении VK вы видите форму из двух полей: ID или ссылка сообщества и ключ доступа сообщества. Рядом — инструкция из трёх шагов и прямая ссылка на раздел ключей нужного сообщества.
Ключ создаёт администратор сообщества: откройте сообщество → Управление → Работа с API → Ключи доступа → «Создать ключ». Если у вас несколько сообществ, создавайте ключ внутри того, которое подключаете: ключ от другого сообщества Uni5 не примет и скажет об этом.
Права (scope), которые нужны Uni5
Набор, который Uni5 просит отметить при создании ключа:
- Стена (
wall) — постить на стену сообщества. - Фото (
photos) — загружать фотографии к постам. - Видео (
video) — загружать видео. - Документы (
docs) — гифки, файлы. - Управление сообществом (
manage) — без него (как и без «Стены») Uni5 ключ не примет.
Если при подключении вы видите сообщение «Токен не имеет нужных прав» — ключ создан без «Стены» или без «Управления сообществом». Создайте новый ключ с полным набором прав и вставьте его заново.
Главный грабль: «сообщество перестало принимать посты»
Вы подключили сообщество, всё работало, и вдруг каждая публикация падает с ошибкой 5 (User authorization failed).
Причина — ключ больше не действует. Чаще всего его удалили в разделе «Работа с API» настроек сообщества (это может сделать администратор сообщества), или само сообщество заблокировано либо удалено.
Ключ сообщества бессрочный, но после отзыва он перестаёт работать молча — VK никого не предупреждает. Uni5 видит ошибку при первой же публикации, помечает приёмник как сломанный и присылает уведомление в бот, если у вас привязан Telegram. Дальше — кнопка «Переподключить ВКонтакте» на странице канала и новый ключ.
Нужно ли продлевать ключ
Нет. Ключ сообщества бессрочный, refresh-токена у него нет, и продлевать его не нужно. Ручное действие требуется, только если ключ отозвали: тогда приёмник VK переходит в статус ошибки, и вы переподключаете его новым ключом через ту же форму. Если вы переносите в VK архив канала — подробнее в статье как перенести Telegram-канал в ВКонтакте.
Если хотите проверить статус — откройте канал в дашборде, вкладка «Приёмники»: там видно, работает ли подключение VK, и при ошибке есть кнопка переподключения.
Что разрешено постить в сообщество
VK строже Telegram в плане модерации. Правила ниже сверены с описанием метода wall.post в сентябре 2026; VK иногда меняет лимиты, поэтому перед крупной загрузкой сверяйтесь с документацией.
- Текст. В Telegram — до 4096 символов на сообщение бота. По нашему опыту, TG-пост такой длины уходит в VK без обрезки.
- Не более 10 медиа (фото, видео) в посте — ограничение метода
wall.post. - Видео — VK ограничивает размер файла, и значение периодически меняется, поэтому точный лимит смотрите в документации VK. Uni5 не перекодирует видео — если файл больше лимита, пост уйдёт с ошибкой, и вы увидите её в логах.
- Опросы — сам VK их поддерживает (в пост можно добавить один опрос, и он не может быть единственным вложением), но Uni5 пока не переносит Telegram-опросы в VK: такой пост в VK не уйдёт, а в логах будет ошибка.
- Хэштеги — Uni5 переносит текст как есть, хэштеги остаются в посте.
В VK есть фича «отложенный постинг» — можно запостить с датой в будущем. Uni5 этим не пользуется: мы постим в момент публикации в Telegram, чтобы момент попадания в ленту совпал. Если вы используете отложенные посты в TG (через scheduled message) — Uni5 публикует их в момент, когда они появились в канале, не в момент шедулинга.
Особенности сообществ vs публичных страниц
В VK два типа сообществ: группа (открытая, закрытая, частная) и публичная страница. Они различаются настройками стены и комментариев внутри VK.
Для кросспостинга это не имеет значения — Uni5 постит от имени сообщества по ключу сообщества, и в форме подключения принимает оба вида ссылок: club… и public….
Как диагностировать ошибки публикации
В дашборде Uni5 → «Логи синхронизации» у каждого поста есть статус и при ошибке — сырая ошибка от VK API.
Самые частые коды от VK (формулировки — по официальной схеме ошибок VK API и справочнику кодов ошибок):
5— User authorization failed. Ключ недействителен — переподключайте.15— Access denied. Доступ запрещён: проверьте, что ключ создан в нужном сообществе и вы по-прежнему его администратор.100— один из параметров отсутствует или неверен. По нашему опыту — чаще всего невалидное вложение.214— Access to adding post denied. VK не дал добавить запись на стену. Проверьте в настройках сообщества, что стена включена и публикации от имени сообщества разрешены.9— Flood control, «слишком много однотипных действий». Обычно всплывает, когда у вас параллельно идёт миграция архива и регулярный кросспостинг. Подождите — Uni5 повторит публикацию с паузой.
Если на новом сообществе публикации падают с 214, первым делом откройте настройки сообщества и проверьте раздел стены: она должна быть включена. Пока VK запрещает добавлять записи, кросс-посты на стене не появятся.
Скорость и очерёдность
VK лимитирует частоту обращений к API по типу ключа (см. ограничения VK API, на сентябрь 2026):
- 20 запросов в секунду на ключ доступа сообщества.
- 3 запроса в секунду на ключ доступа пользователя.
Для кросспостинга это с запасом: даже канал с десятками постов в час в лимит не упирается. При превышении VK возвращает ошибку 6 («Too many requests per second»). Если идёт перенос архива, система делает паузы между публикациями, чтобы не упираться в лимиты. Как устроен сам процесс переноса, разбираем в статье как сделать репост из Telegram во ВКонтакте автоматически.
Резюме: чек-лист подключения
Чтобы не возвращаться в эту статью при следующем сообществе:
- ✅ Открыть канал в дашборде Uni5 → вкладка «Приёмники» → подключить VK.
- ✅ В сообществе VK: Управление → Работа с API → Ключи доступа → «Создать ключ».
- ✅ Отметить права: Стена, Фото, Документы, Видео, Управление сообществом.
- ✅ Скопировать ключ и вставить его в форму Uni5 вместе с ID или ссылкой сообщества.
- ✅ В настройках сообщества VK проверить, что стена включена.
- ✅ Сделать тестовый пост в Telegram-привязанном канале.
- ✅ Убедиться, что пост появился в VK — Uni5 запоминает связку постов, по ней потом проходят правки и удаления.
После этого про VK-настройки можно забыть — ключ бессрочный, а если его отзовут, Uni5 пришлёт уведомление в бот.
Если что-то не работает — напишите в поддержку командой /support в боте @uni5_sync_bot и приложите скриншот ошибки из «Логов синхронизации»: это сильно ускорит разбор.
Частые вопросы
Почему сообщество вдруг перестало принимать посты?
Чаще всего ключ сообщества отозвали: его удалили в разделе «Работа с API» настроек сообщества. VK делает это молча, а публикации начинают падать с ошибкой 5. Создайте новый ключ и переподключите сообщество кнопкой «Переподключить ВКонтакте» на странице канала.
Какие права обязательно выдать для кросспостинга?
Uni5 просит отметить «Стену», «Фото», «Документы», «Видео» и «Управление сообществом». Без «Стены» или «Управления сообществом» ключ не пройдёт проверку при подключении — вы увидите сообщение «Токен не имеет нужных прав».
Что означает ошибка 214 и как её убрать?
Код 214 — «Access to adding post denied»: VK не дал добавить запись на стену. Проверьте в настройках сообщества, что стена включена и публикации от имени сообщества разрешены.
Нужно ли вручную продлевать токен VK?
Нет. Ключ сообщества бессрочный, refresh-токена у него нет. Ручное действие нужно, только если ключ отозвали: тогда создайте новый и переподключите сообщество.
Можно ли постить в закрытую группу или публичную страницу одинаково?
Да. Uni5 постит от имени сообщества по ключу сообщества, и оба типа работают одинаково. Разница только в настройках стены и комментариев внутри VK.
