Обзор панели

📢 Подключение Telegram Bot API

1. Перейдите в Telegram и найдите официального бота для создания ботов: @BotFather.
2. Отправьте команду /newbot, задайте понятное имя бота (например, Давыдов Автопостинг) и уникальное юзернейм-имя, оканчивающееся на bot (например, davidov_smm_bot).
3. Скопируйте полученный длинный API Token (токен авторизации) вида 123456789:ABCdefGh....
4. Зайдите в настройки вашего Telegram-канала или группы и добавьте созданного бота в список Администраторов.
5. Дайте боту разрешение на Публикацию сообщений (Post Messages). Другие разрешения для базового постинга не требуются.
6. Перейдите на вкладку «Аккаунты» в панели SMM-Companion, выберите Telegram, вставьте API-токен и укажите ID вашего канала (например, @my_channel или числовой ID). Нажмите «Подключить».

👥 Подключение ВКонтакте API

Подключение ВКонтакте состоит из трёх независимых частей: (а) подтверждение вашего сообщества в VK Бизнес ID — без этого доступ к API может быть заблокирован; (б) подключение сообщества для публикации текста и фото; (в) отдельное подключение для загрузки видео.

Часть А. Подтверждение бизнес-профиля VK ID

1. Наша панель уже использует собственное зарегистрированное приложение VK для кнопок авторизации ниже — создавать своё приложение для базовой работы НЕ нужно.
2. Обязательно другое: подтвердите бизнес-профиль сообщества в VK Бизнес ID (кабинет bid.vk.com) — вход через VK ID. Без подтверждения доступ приложений к API сообщества блокируется через 60 дней (для сообществ, зарегистрированных ранее — дедлайн 1 марта 2026 года).
3. Необязательный шаг для продвинутых: если хотите своё отдельное приложение (например, для повышения личных лимитов запросов к API) — зайдите в кабинет id.vk.ru → «Мои приложения» → «Добавить приложение» → укажите название, платформу Web, базовый домен и доверенный redirect-адрес (должны в точности совпадать с доменом панели) → «Создать приложение». Чтобы поднять лимиты — сделайте приложение «Конфиденциальным» и укажите IP-адрес сервера в разделе «Ключи доступа».

Часть Б. Публикация текста и фото (пост на стене сообщества)

1. В настройках вашего сообщества ВКонтакте: Управление сообществом → Работа с API → Ключи доступа → создайте ключ с правами «стена», «фотографии», «управление сообществом».
2. Перейдите на вкладку «Аккаунты» в панели, найдите карточку «ВКонтакте — Сообщество (сервисный ключ)», вставьте ключ в поле и нажмите «Подключить» (либо используйте кнопку «Подключить ВКонтакте» в основной карточке ВКонтакте — она запросит тот же ключ).
3. Если нужно публиковать от имени личной страницы (а не сообщества) — используйте карточку «ВКонтакте — Постинг (Standalone)»: нажмите «Открыть авторизацию VK», разрешите доступ, затем скопируйте ВЕСЬ адрес страницы из адресной строки браузера и вставьте его в поле рядом с кнопкой «Подключить».

Часть В. Видео во ВКонтакте (VK ID)

1. Сервисный ключ сообщества (часть Б) НЕ умеет загружать видео — для этого нужен отдельный user-токен VK ID.
2. На вкладке «Аккаунты» найдите карточку «ВКонтакте — Видео (VK ID)» и нажмите «Открыть авторизацию VK». Вы должны быть администратором сообщества.
3. После нажатия «Разрешить» скопируйте ВЕСЬ адрес страницы из адресной строки (в нём будет параметр code) и вставьте его в поле под кнопкой.
4. Нажмите «Подключить видео». Сам пост при этом публикуется сервисным ключом из части Б, а видео загружается через VK ID — токен видео обновляется автоматически, повторно подключать не нужно.

📷 Подключение Instagram

1. Аккаунт Instagram должен быть типа Business или Creator (обычный личный аккаунт публиковать через API не может — переключить тип можно в настройках приложения Instagram: «Аккаунт» → «Переключиться на профессиональный аккаунт»). Привязка к странице Facebook больше не нужна — вход выполняется напрямую через Instagram.
2. На вкладке «Аккаунты» в панели найдите карточку «Instagram» и нажмите «Подключить Instagram». Откроется окно входа Instagram (компания-владелец — Meta).
3. Войдите в нужный аккаунт Instagram и подтвердите доступ — панель подключит этот аккаунт. Чтобы подключить несколько аккаунтов, повторите вход для каждого.
4. Тип публикации (Лента, Reels или Stories) выбирается в Конструкторе поста на вкладке «Instagram» — переключатель «Куда публиковать» над текстом.

Ограничения Instagram API: не больше 100 публикаций за 24 часа на один аккаунт; фото принимаются только в формате JPEG; Reels — до 90 секунд; Stories публикуются без текста подписи (текст поста для Stories не используется).

🎵 Подключение TikTok

1. На вкладке «Аккаунты» найдите карточку «TikTok» и нажмите «Подключить TikTok». Откроется окно согласия TikTok — войдите и разрешите доступ, панель вернёт вас обратно автоматически.
2. Если аккаунт TikTok уже был подключён ДО августа 2026 года и статистика (просмотры/лайки) по нему не собирается — нажмите «Подключить TikTok» ещё раз для этого же аккаунта: разрешение на сбор статистики расширилось, нужна переавторизация.

Важно: пока приложение панели не прошло аудит (проверку) в TikTok Developer Portal, ВСЕ публикации уходят в TikTok приватными — режим «Только я» (SELF_ONLY), их видит только владелец аккаунта. Как только аудит будет одобрен, публичность включится автоматически, без каких-либо действий с вашей стороны и без переподключения аккаунтов.

Фото-посты (карусель до 35 фото) заработают после того, как разработчик подтвердит домен панели в TikTok Developer Portal (верификация URL) — статус уточняйте у разработчика.

Лимиты: видео от 3 секунд до 10 минут, до 287 МБ; подпись — до 2200 символов; примерно 25 видео в сутки на один аккаунт.

▶️ Подключение YouTube

1. На вкладке «Аккаунты» найдите карточку «YouTube» и нажмите «Подключить YouTube». Откроется окно входа и согласия Google — войдите под тем аккаунтом Google, к которому привязан ваш YouTube-канал, и разрешите доступ.
2. После подтверждения панель вернёт вас обратно и покажет сообщение «YouTube канал подключён».

Важно: пока проект панели в Google не прошёл верификацию (проверку), ВСЕ видео, загруженные через API, принудительно становятся приватными — снять это ограничение может только аудит Google, действий с вашей стороны не требуется, кроме ожидания.

Квота — примерно 100 загрузок в сутки на приложение. Shorts не нужно включать отдельно: видео до 3 минут в вертикальном или квадратном формате YouTube автоматически определяет как Shorts.

Отдельной вкладки настроек YouTube (заголовок, описание, теги, приватность, «для детей») в Конструкторе публикации сейчас нет. Заголовок и описание видео берутся из общего текста поста, приватность выставляется автоматически: «Публично» для мгновенной публикации и «Приватно» для отложенной (так требует сам YouTube для запланированных видео). Если нужны свои заголовок/теги/отметка «для детей» на конкретное видео — передайте это разработчику.

🔀 Несколько аккаунтов одной сети

• Можно подключить два и более аккаунта одной и той же соцсети — для каждой сети на вкладке «Аккаунты» после первого подключённого аккаунта появляется кнопка «Добавить ещё» с тем же названием сети.
• При создании поста в Конструкторе, в блоке «Аккаунты для публикации», отметьте галочками нужные аккаунты — они сгруппированы по соцсетям.
• Если для одной сети выбрано 2 и более аккаунта — под текстом появляется блок «Тексты по аккаунтам», где можно задать свой уникальный текст для каждого конкретного аккаунта (по умолчанию используется общий текст поста).
• Медиафайлы (фото и видео) система АВТОМАТИЧЕСКИ делает разными для каждого аккаунта: очищает служебные метаданные файла и незаметно для глаза видоизменяет картинку/видео. Соцсети видят разный контент на разных аккаунтах, что снижает риск пометки «повторяющийся контент».
• Интервалы между публикациями в разные аккаунты одной сети система разводит по времени автоматически — вручную ничего рассчитывать не нужно.

📋 Лимиты и форматы сетей

💾 Алгоритмы Базы Данных и Планировщика (Cron)

Панель автоматизирует отложенную публикацию с использованием фонового планировщика на сервере:

• Сохранение записи: При нажатии кнопки «Запланировать» в Конструкторе, бэкенд сохраняет пост в таблице posts (текст, пути к медиафайлам, статус scheduled, время scheduled_at).
• Очередь публикации: Для каждой выбранной соцсети создается связанная задача в таблице publication_queue со статусом pending.
• Фоновый обработчик (Cron-задача): На сервере каждую минуту запускается планировщик. Он находит задачи со временем публикации меньше или равным текущему, переводит их в статус processing, отправляет данные через подключенные официальные API и меняет статус на success (при успехе) или failed (сохраняя лог ошибки для отладки).

🔗 Генерация UTM и Работа Клик-Трекера

1. При составлении поста в Конструкторе вставьте вашу целевую ссылку в поле Генератор коротких ссылок.
2. Система автоматически сгенерирует короткую ссылку (например, https://smmc.ru/l/aB3dE), привязав к ней исходный URL с автоматически добавленными UTM-метками (source, medium, campaign).
3. При клике на эту ссылку пользователь попадает на наш серверный эндпоинт GET /l/:code, который мгновенно записывает в БД статистику перехода (время клика, IP-адрес, операционную систему, браузер).
4. После этого сервер выполняет мгновенное перенаправление (302 Redirect) на ваш сайт, сохраняя UTM-параметры для вашей Яндекс.Метрики или Google Analytics.

📅 Тепловая карта активности и Engagement Rate (ER)

Тепловая карта на главном экране помогает находить идеальные временные интервалы для постинга:

• Каждые 2 часа серверный скрипт опрашивает API подключенных соцсетей для сбора актуальной статистики (просмотры, лайки, комментарии, репосты) по вашим публикациям. Сбор охватывает все 5 поддерживаемых сетей, включая YouTube и TikTok.
• Показатель Engagement Rate (ER) для каждого поста считается по формуле:
  ER = ((Лайки + Комментарии + Репосты + UTM-клики) / Просмотры) * 100%.
• Все рассчитанные показатели группируются по дням недели и часам публикации и нормируются в интервале от 0 до 1.
• Полученная сетка 24х7 передается во фронтенд, который подсвечивает слоты с наивысшим ER зеленым цветом. Кликнув на яркий зеленый слот, вы можете мгновенно запланировать публикацию на это эффективное время!