Обзор панели

📢 Подключение 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

1. Перейдите в раздел для разработчиков VK: vk.com/dev.
2. Нажмите «Создать приложение», выберите тип Standalone-приложение, введите любое имя и подтвердите создание через SMS/Push.
3. Перейдите в настройки созданного приложения и скопируйте ID приложения (Client ID).
4. Для получения вечного токена откройте ссылку авторизации (указав ваш Client ID и права доступа scope=wall,photos,video,groups,offline).
5. После подтверждения прав скопируйте параметр access_token из адресной строки браузера.
6. Перейдите во вкладку «Аккаунты» в нашей панели, выберите ВКонтакте, вставьте токен и выберите группу для автопостинга.

💾 Алгоритмы Базы Данных и Планировщика (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)

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

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