# Viralmaxing — полная документация (для AI) Единый корпус продуктовой и developer-документации: 40 страниц. Каждая страница помечена заголовком и каноническим путём (routePath). Отвечая на вопросы, ссылайся на страницы через их routePath, например [Поиск идей](/docs/research/idea-search) или [MCP quick start](/developers/mcp/quick-start). Если ответа в корпусе нет — скажи об этом прямо, не выдумывай. --- # Что такое Viralmaxing routePath: /docs Раздел: Начало работы Описание: Найдите рабочий формат, проверьте его по аналитике и превратите в сценарий. # Что такое Viralmaxing Viralmaxing помогает выбрать тему для короткого видео, проверить её по данным и подготовить сценарий. Работа идёт в одном пространстве, поэтому аккаунты, ролики и сценарии разных клиентов не смешиваются. Хотите получить первый сценарий без обзора всех функций? Откройте [маршрут от идеи до сценария](/docs/guides/getting-started). ## Первый результат Введите задачу в строку «Спросите что угодно…» на [главной](/dashboard). Например: `найди идеи для рилсов кофейни и собери один сценарий`. Строка ассистента и быстрые действия на главной. Дальше продукт проведёт вас по трём шагам: 1. [Поиск идей](/docs/research/idea-search) находит ролики по теме, описанию или аккаунту конкурента. 2. [Аналитика](/docs/analytics/overview) показывает, какие форматы уже работают у вас. 3. [План](/docs/scenarios/plan) хранит сценарий, его статус и дату публикации. Поиск идей стоит 30 энергии. Создание сценария из ролика стоит 1 энергии. Перед платным действием Viralmaxing показывает итоговую цену. Как устроена [энергия и где смотреть баланс](/docs/reference/energy), описано отдельно. ## Выберите свой маршрут Пять гайдов повторяют реальные задачи, с которыми приходят пользователи. Каждый заканчивается проверяемым результатом. - [С чего начать](/docs/guides/getting-started): от поиска ролика до готового текста в Плане за один проход. - [Хочу понять, что залетит](/docs/guides/what-to-film): 3–5 идей для следующей съёмки из данных ниши. - [Уже снимаю, хочу расти](/docs/guides/track-results): разбор своих результатов и один эксперимент на период. - [Я бренд, продвигаю продукт](/docs/guides/beat-competitors): форматы конкурентов, адаптация и сравнение результатов. - [Я веду клиентов](/docs/guides/agency): пространство на клиента, роли и общий баланс. - [Ловлю тренды раньше](/docs/guides/catch-trends): радар свежих выбросов у нишевых авторов. ## Куда идти с конкретной задачей | Задача | Раздел | | ------------------------------ | -------------------------------------------------- | | Найти тему или формат | [Поиск идей](/docs/research/idea-search) | | Копить идеи | [Подборки](/docs/research/collections) | | Следить за конкурентами | [Аккаунты](/docs/settings/accounts) | | Вести сценарии | [План](/docs/scenarios/plan) | | Получать сигналы в Telegram | [Уведомления](/docs/analytics/notifications) | | Собирать лидов из комментариев | [Воронки в Instagram](/docs/automations/funnels) | | Задать вопрос по данным | [AI-ассистент](/docs/assistant/overview) | | Разделить клиентов и команду | [Команда и пространства](/docs/collaboration/team) | | Понять расход энергии | [Энергия и лимиты](/docs/reference/energy) | | Подключить агента, MCP или API | [Для разработчиков](/developers) | ## Термины, которые встретятся дальше - **VM Score** оценивает вирусный потенциал ролика по шкале от 0 до 100. Полный разбор метрик собран в [шпаргалке](/docs/analytics/metrics). - **Сценарий** содержит текст и материалы для съёмки. Его можно создать вручную или из найденного ролика. - **Подборка** хранит сохранённые ролики. Сохранение бесплатно и не создаёт сценарий. - **Энергия** списывается за поиск, генерацию и сбор новых данных. Просмотр уже собранной аналитики бесплатен. Если вы ведёте несколько брендов, создайте для каждого отдельное [пространство](/docs/collaboration/team). Перед поиском, импортом или работой через [MCP и API](/developers) проверьте выбранное пространство. --- # Главная routePath: /docs/getting-started/dashboard Раздел: Начало работы Описание: Начните день со сводки результатов, лучших роликов и строки ассистента. # Главная [Главная](/dashboard) отвечает на три утренних вопроса: что сработало за месяц, что сейчас в работе и что сделать следующим. Это точка старта дня, а не ещё один экран аналитики: каждый блок ведёт в свой раздел одним кликом. ## Начните со строки ассистента Строка «Спросите что угодно…» вверху принимает задачу словами: `найди идеи для рилсов кофейни и собери один сценарий`. Чипы под ней запускают частые маршруты: **«Найти идеи»**, **«Тренды»**, **«Моя аналитика»**, **«Написать сценарий»**. Как формулировать запросы, разобрано в [гайде по промптам](/docs/assistant/effective-prompts). ## Прочитайте сводку за 30 дней Блок «Ваши результаты за последние 30 дней» собирает подписчиков по всем аккаунтам, просмотры, публикации и лайки со сравнением к прошлому периоду. Ниже: динамика просмотров по дням и накопительно, «Лучшие ролики» и срез контент-плана с числом сценариев в работе и просроченными. Сводка: метрики с дельтами, динамика просмотров и лучшие ролики. Как читать эти цифры: - Процент у метрики сравнивает с предыдущими 30 днями. Метка «новое» означает, что раньше данных не было. - «Лучшие ролики» за период: кандидаты на повтор формата, проверьте их в [разборе контента](/docs/analytics/content). - Кнопка **«Вся аналитика»** открывает [полный обзор](/docs/analytics/overview) с фильтрами и распределениями. ## Если сводка пустая | Состояние | Что это значит и что нажать | | -------------------- | ------------------------------------------------------------------ | | «Подключите свой аккаунт» | своих профилей ещё нет: добавьте их в [Аккаунтах](/docs/settings/accounts) | | «Собираем данные» | аккаунт подключён, первая выгрузка занимает несколько минут | | «Данные устарели» | аккаунты давно не обновлялись: кнопка ведёт в [Обновление](/docs/analytics/refresh) | ## Ниже по странице - «Что растёт у конкурентов» показывает свежие выбросы отслеживаемых профилей: быстрый вход в [наблюдение за нишей](/docs/guides/catch-trends). - «Автоматизации» показывают результаты воронок; строка «Воронка включена, но за N дней кодовое слово никто не написал» означает тишину, а не поломку. Подробнее в разделе [Воронки](/docs/automations/funnels). - «Быстрые действия» запускают типовые задачи одним кликом: добавить конкурента, найти идеи, собрать сценарий из роликов, выдать доступ команде. Следующий шаг: пройдите [маршрут от идеи до сценария](/docs/guides/getting-started), он заканчивается готовым текстом в Плане. --- # С чего начать routePath: /docs/guides/getting-started Раздел: Гайды Описание: Пройдите путь от поиска ролика до готового сценария в Плане. # С чего начать За один проход вы найдёте ролик по теме, создадите из него сценарий и откроете текст в Плане. Подключать аккаунт для поиска по слову или описанию не нужно. Минимальная стоимость прохода составляет 31 энергию. Поиск стоит 30 энергии, создание сценария из выбранного ролика стоит 1 энергии. Расшифровка и AI-правки списываются только после отдельного запуска. ## 1. Найдите ролик Откройте **Контент-план → Предложено**. Во вкладках «От конкурентов» и «Для вас» уже лежат сильные свежие ролики: каждый набрал втрое больше обычного для своего автора. Если нужна конкретная тема, откройте вкладку **«Поиск»**, опишите её и нажмите «Найти». Подробности о поиске есть в статье [Поиск идей](/docs/research/idea-search). ## 2. Создайте сценарий На карточке подходящего ролика нажмите **«В план»**. Viralmaxing создаст сценарий и добавит его в [План](/plan). **«⋯ → Во входящие»** на карточке выполняет другую задачу: бесплатно сохраняет ролик во Входящие, но не создаёт сценарий. Используйте его для идей, к которым хотите вернуться позже. ## 3. Подготовьте текст Откройте карточку сценария в Плане. Там находятся текст, исходный ролик и чат с AI. ### Соберите черновик Используйте готовую расшифровку или добавьте свои тезисы. Если текста ролика нет, запустите расшифровку за 10 энергии. ### Исправляйте конкретные места Выделите хук, призыв или длинный фрагмент и попросите сократить, перефразировать или усилить его. Полное AI-переписывание стоит 3 энергии. ### Проверьте предложение AI показывает сравнение «До» и «После». Изменение попадёт в сценарий только после нажатия **«Применить»**. Готовый текст можно скопировать без таймкодов или скачать в `.txt`. Публикация из Viralmaxing не выполняется. ## Как проверить результат Проход завершён, если в [Плане](/plan) появилась карточка с вашим текстом, исходным роликом и нужным статусом. Дальше соберите ещё несколько кандидатов по маршруту [«Хочу понять, что залетит»](/docs/guides/what-to-film). Переключение пространства меняет весь рабочий контекст. Перед поиском и созданием сценария проверьте название пространства в навигации. --- # Хочу понять, что залетит routePath: /docs/guides/what-to-film Раздел: Гайды Описание: Сопоставьте сильные форматы ниши со своей аналитикой и соберите план съёмки. # Хочу понять, что залетит Этот маршрут даёт 3–5 идей для следующей съёмки. Вы сравните сильные ролики ниши со своими результатами и сохраните выбранные форматы в План. ### Открыть поиск идей Поиск по слову, хэштегу или описанию: первая сессия занимает пару минут. ## Найдите устойчивый формат 1. Откройте [поиск](/plan/suggested?source=search) во вкладке «Предложено» и задайте узкую тему. 2. Отсортируйте выдачу по **Вирусности**. 3. Сохраните 3–5 роликов, у которых одновременно сильный VM Score и высокая вирусность. Сочетание VM Score и вирусности полезнее абсолютных просмотров: крупный аккаунт может набрать много за счёт своей базы, а высокий относительный результат чаще указывает на сильный формат. Как читать обе метрики, описано в [шпаргалке метрик](/docs/analytics/metrics). Один поиск стоит 30 энергии. Расширяйте удачную сессию дополнительными ключами, прежде чем запускать новый поиск. ## Сверьте со своими результатами Откройте [Результаты](/analytics/insights) и найдите форматы, которые уже работают на ваших аккаунтах. Смотрите на топ публикаций, среднее на пост и динамику за сопоставимый период. Выберите идею, если выполняется хотя бы одно условие: - похожий формат уже даёт результат у вас; - один паттерн повторяется у нескольких авторов ниши; - ролик заметно превысил обычный уровень своего автора. Единичный хит без повторов оставьте в подборке. Он может быть исключением, а не рабочим форматом. ## Перенесите формат в План Нажмите **«Адаптировать»** на выбранных роликах. Каждый сценарий стоит 1 энергии. В [Плане](/plan) перепишите хук, аргументы и призыв под свой продукт и голос. Не копируйте исходный текст. Забирайте структуру, темп и способ раскрытия темы. Это даёт проверенную основу без дословного повторения чужого ролика. ## Повторяйте раз в неделю Один рабочий ритм выглядит так: - раз в неделю найти 3–5 кандидатов; - сравнить их со своими результатами; - добавить выбранные форматы в План; - после публикации проверить тот же период в аналитике. Следующий шаг: [разбор своих результатов](/docs/guides/track-results). --- # Уже снимаю, хочу расти routePath: /docs/guides/track-results Раздел: Гайды Описание: Проведите короткий разбор своих результатов и выберите следующий эксперимент. # Уже снимаю, хочу расти За пять минут вы определите один формат для повтора и одну гипотезу для следующего периода. Для этого нужны подключённые аккаунты с собранными публикациями. ### Открыть свои результаты Экран «Результаты» показывает первый срез сразу после подключения аккаунтов. ## Проведите короткий разбор ### Выберите период Откройте [Результаты](/analytics/insights) и задайте окно, которое соответствует вашему ритму публикаций. Сравнение строится с предыдущим периодом такой же длины. ### Найдите сильный формат В блоке «Топ публикации» сравните сортировку по просмотрам и VM Score. Высокий VM Score показывает силу формата, а просмотры показывают полученный охват. ### Проверьте источник результата Сравните аккаунты, платформы и длину роликов. Используйте среднее на пост, если в группах разное число публикаций. ### Выберите один эксперимент Запишите, что именно меняете в следующем периоде: хук, длину, тему или частоту. Назовите метрику, по которой проверите результат. ## Как читать сравнение | Состояние | Значение | | ---------- | ----------------------------------- | | «новое» | в прошлом периоде не было данных | | 0% | изменение округлилось до нуля | | дельты нет | данных нет в обоих периодах | Календарь активности показывает ритм публикаций по дням. Он не содержит почасовой аналитики и не отвечает на вопрос о лучшем времени публикации. ## Частые причины пустого результата - Новый аккаунт ещё не прошёл первый сбор. - За выбранный период нет публикаций. - В фильтре остался аккаунт или платформа без данных. - Для регулярного отчёта вы забыли заново выбрать период. Фильтры между визитами не сохраняются. Просмотр аналитики и изменение фильтров бесплатны. Перед обновлением статистики Viralmaxing показывает итоговый расход энергии. Следующий шаг: соедините свой результат с данными ниши в гайде [«Хочу понять, что залетит»](/docs/guides/what-to-film). --- # Я бренд, продвигаю продукт routePath: /docs/guides/beat-competitors Раздел: Гайды Описание: Найдите сильные форматы конкурентов, адаптируйте их и сравните результаты. # Я бренд, продвигаю продукт Этот маршрут помогает найти формат конкурента, адаптировать его под бренд и проверить результат на одинаковом периоде. ### Открыть аккаунты конкурентов Вкладка «Конкуренты» в Аккаунтах: сюда добавляются профили для наблюдения. ## Добавьте конкурентов Откройте [Аккаунты](/analytics/accounts?scope=competitor) или вкладку [Видео → Конкуренты](/analytics/posts?scope=competitor). Нажмите **«Добавить конкурента»** и вставьте ссылки на Instagram, TikTok, YouTube или Facebook. Viralmaxing показывает стоимость до импорта. Один загруженный ролик стоит 1 энергии. Для Facebook действует коэффициент ×2, итог также виден до запуска. ## Найдите формат, который выбился из нормы 1. Ограничьте период последними днями или неделями. 2. Отсортируйте ролики по VM Score. 3. Проверьте множитель и вирусность у лучших кандидатов. 4. Откройте ролик и разберите хук, структуру и подачу. Множитель сравнивает ролик с обычным уровнем автора. Высокое значение помогает заметить формат, который сработал лучше его стандартного результата. ## Сравните бренд с конкурентами В [Результатах](/analytics/insights) переключайте охват вкладками «Свои» и «Конкуренты» на одинаковом периоде и одинаковых платформах. Если число публикаций отличается, сравнивайте среднее на пост, а не только общий охват. Выберите один разрыв, который можно проверить в следующем цикле. Например, длину ролика, тип хука или частоту публикаций. ## Адаптируйте ролик В карточке ролика нажмите **«Адаптировать в сценарий»**. Viralmaxing создаст сценарий в [Плане](/plan) за 1 энергии. Перепишите сюжет и аргументы под свой продукт. Сохраняйте формат, но не исходный текст. Если вы не знаете, кого отслеживать, [поиск конкурентов](/explore/discover) подберёт похожие аккаунты по нескольким источникам. Операция стоит 200 энергии за каждый источник, поэтому начните с небольшой группы точных профилей. Перед удалением конкурента проверьте подтверждение в интерфейсе. Удаление останавливает отслеживание и может убрать собранные ролики из вашей аналитики. Чтобы только остановить расходы, сначала рассмотрите ручной режим обновления. --- # Я веду клиентов routePath: /docs/guides/agency Раздел: Гайды Описание: Создайте пространство для каждого клиента и ограничьте доступ ролями. # Я веду клиентов Создайте отдельное пространство для каждого клиента. Пространство отделяет его аккаунты, ролики и сценарии. Роль определяет, что приглашённый участник может делать. Полная модель доступа, таблица ролей и восстановление ошибок описаны в разделе [Команда и пространства](/docs/collaboration/team); этот гайд проходит агентский маршрут по шагам. ### Открыть пространства Здесь создаётся отдельное пространство под каждого клиента. ## Настройте клиента ### Создайте пространство В [Пространствах](/settings/workspaces) нажмите **«Создать»** и используйте название клиента или бренда. Затем переключитесь в новое пространство. Оно появляется пустым. ### Подключите аккаунты Добавьте профили клиента в [Аккаунтах](/analytics/accounts?scope=own). Аккаунты из других пространств сюда не переносятся. ### Пригласите участника В [Команде](/settings/team) укажите email, роль и доступные пространства. Снимите доступ ко всем пространствам, если человек должен видеть только одного клиента. Клиенту обычно подходит роль Наблюдатель, внешнему автору Редактор. ### Проверьте результат Переключитесь в пространство клиента и убедитесь, что там находятся только его аккаунты. Попросите участника открыть тот же раздел под своим email. ## Покажите клиенту результат - Наблюдатель видит аналитику и План клиента сам, без пересылки скриншотов. - Экспорт из аналитики и Плана сохраняет текущие фильтры: удобно прикладывать к отчёту за период. - Уведомления в Telegram можно направить в общий чат с клиентом. Типы и настройка описаны в разделе [Уведомления](/docs/analytics/notifications). ## Учтите общий баланс Отдельного бюджета энергии на пространство нет: все участники тратят из общего [баланса владельца](/docs/reference/energy). Основной регулярный расход создаёт обновление аккаунтов, поэтому для неактивного клиента переведите расписание его профилей в ручной режим. Если команда работает через ассистента, [MCP или API](/developers), каждый вызов также действует в выбранном пространстве и тратит общий баланс. Переключение, архивирование или удаление активного пространства перезагружает страницу. Сохраните черновик и закончите текущий ответ ассистента до действия. --- # Ловлю тренды раньше routePath: /docs/guides/catch-trends Раздел: Гайды Описание: Следите за свежими выбросами у нишевых конкурентов и быстро забирайте формат в работу. # Ловлю тренды раньше Ранний сигнал появляется, когда свежий ролик заметно превышает обычный результат автора. Этот маршрут помогает увидеть такой выброс и перенести формат в План до того, как он станет массовым. ## Подготовьте радар 1. Добавьте нишевых конкурентов и включите им [регулярное обновление](/docs/analytics/refresh). 2. Откройте [Видео → Конкуренты](/analytics/posts?scope=competitor). 3. Выберите короткий период и включите фильтр новых роликов. 4. Отсортируйте выдачу по множителю или VM Score. Жёлтая или красная метка свежести означает, что данные аккаунта устарели. Сначала обновите его, иначе старый ролик может выглядеть как новый сигнал. ## Проверьте сигнал Не принимайте один большой показатель за тренд. Ищите сочетание: - ролик опубликован недавно; - множитель заметно выше обычного уровня автора; - похожая структура появляется у нескольких аккаунтов; - формат подходит вашей теме и производственным возможностям. Абсолютные просмотры крупного автора сами по себе ничего не доказывают. Маленький аккаунт с резким выбросом часто даёт более ранний сигнал. ## Заберите формат в работу Откройте ролик и нажмите **«Адаптировать в сценарий»**. Создание сценария стоит 1 энергии. В [Плане](/plan) перепишите хук, примеры и призыв под свой продукт. Если отслеживаемых аккаунтов мало, используйте [поиск конкурентов](/explore/discover). Он стоит 200 энергии за источник, поэтому выбирайте несколько точных профилей. Для регулярного мониторинга дешевле один раз настроить качественный список и расписание. Фильтр новых роликов считается от прошлого визита. Проверяйте ленту с постоянным ритмом, иначе выборка накопится и перестанет быть ранним сигналом. --- # Аналитика: обзор routePath: /docs/analytics/overview Раздел: Аналитика Описание: Сводка результатов, тренды, топ-контент и сравнение аккаунтов за период. # Аналитика: обзор Экран [Результаты](/analytics/insights) показывает сводку по подключённым аккаунтам. Здесь удобно проверить динамику за период, найти лучшие публикации и выбрать следующий эксперимент. ## Получите первый срез 1. Выберите период. 2. Оставьте только нужные платформы и аккаунты. 3. Сравните текущий период с предыдущим окном такой же длины. 4. Откройте лучший и слабый ролик для детального разбора. Если аккаунт только добавлен, аналитика появится после первого сбора. Стоимость импорта видна до запуска и зависит от числа загружаемых роликов. ## Когда какой блок смотреть - Вопрос «повторить какой формат»: откройте «Топ публикации» и сравните лидеров по просмотрам и VM Score. Расхождение сортировок само по себе подсказка: охват дал размер аккаунта или сила формата. - Вопрос «откуда результат»: распределения показывают вклад аккаунтов, платформ и длины роликов. Используйте среднее на пост при разном числе публикаций в группах. - Вопрос «держу ли ритм»: календарь активности показывает публикации по дням. Почасовой аналитики в нём нет, лучшее время публикации он не выбирает. Топ публикаций, распределения и календарь активности. ## Как читать сравнение Используйте среднее на пост, если группы опубликовали разное число роликов. Общий охват без объёма публикаций может создать ложное преимущество. Метка «новое» означает, что в прошлом периоде данных не было. Нулевая дельта может означать очень маленькое изменение, округлённое до нуля. Если данных нет в обоих окнах, сравнение не показывается. ## Если экран пустой Проверьте по порядку: - подключён ли профиль в [Аккаунтах](/docs/settings/accounts); - завершился ли первый сбор; - есть ли публикации в выбранном периоде; - не исключили ли данные фильтры; - достаточно ли у вашей роли прав на подключение аккаунтов. Фильтры и период могут сбрасываться между визитами. Для регулярного отчёта сохраняйте выбранный срез через экспорт. Следующий шаг: откройте [разбор контента](/docs/analytics/content), чтобы понять причину результата конкретного ролика. --- # Разбор контента routePath: /docs/analytics/content Раздел: Аналитика Описание: Найдите ролик по метрикам, откройте расшифровку и разберите удержание. # Разбор контента Найдите сильный и слабый ролик, затем сравните их метрики, начало и удержание. Это быстрее даёт рабочую гипотезу, чем просмотр таблицы без критерия. ## Выберите экран | Экран | Для чего нужен | | ------------------------------------- | ------------------------------------------- | | [Видео](/analytics/posts) | публикации своих аккаунтов и конкурентов; охват переключают вкладки «Свои» и «Конкуренты» | | [Глубокая аналитика](/analytics/deep) | хук и удержание по доступным данным YouTube | Если таблица пуста, проверьте выбранную вкладку, фильтры и статус первого сбора. Ролик по прямой ссылке добавляется в [Подборках](/docs/research/collections) без подключения аккаунта. ## Найдите ролики для сравнения 1. Отсортируйте таблицу по вирусности или VM Score. 2. Откройте несколько лидеров, а затем ролик с заметно более слабым результатом. 3. Сравните тему, хук, длину и реакции. 4. Сформулируйте одно отличие, которое можно проверить в следующем сценарии. Фильтры по периоду, платформе, аккаунту и группе сужают выборку. Набор колонок можно настроить под задачу и использовать в экспорте. Публикации с VM Score, вирусностью, ER и множителем. ## Разберите удержание Глубокая аналитика показывает хук, среднее удержание и кривую досмотра, когда YouTube предоставляет эти данные. Резкий спад в начале указывает на проблему с входом в тему. Поздний спад чаще связан с темпом или структурой. Сравнивайте ролики внутри одного канала. Тема, длина и аудитория влияют на удержание, поэтому универсальный порог редко объясняет причину. Хук, удержание и кривая досмотра по роликам канала. Прочерк означает, что платформа ещё не отдала показатель или данных недостаточно. Не заменяйте его нулём при экспорте и сравнении. ## Откройте карточку ролика Карточка собирает метрики, доступную расшифровку и действия. Просмотр уже собранных данных бесплатен. Новый разбор или расшифровка стоит 10 энергии. Кнопка **«Адаптировать в сценарий»** создаёт сценарий в [Плане](/docs/scenarios/plan) за 1 энергии, если этот тип ролика поддерживает действие. Используйте YouTube-удержание для диагностики, даже когда создание сценария из конкретного ролика недоступно. Удалённый на платформе ролик может остаться в аналитике, но его превью, скачивание и повторная расшифровка будут недоступны. --- # Шпаргалка метрик: как читать цифры routePath: /docs/analytics/metrics Раздел: Аналитика Описание: Как читать VM Score, вирусность, множитель, ER и сырые реакции. # Шпаргалка метрик: как читать цифры Каждая метрика отвечает на отдельный вопрос. Сравнивайте ролики одного периода и учитывайте размер аккаунта. Десять тысяч просмотров могут быть сильным результатом для небольшого автора и обычным для крупного. ## Основные метрики | Метрика | Что показывает | Когда использовать | | ---------- | ---------------------------------------------- | ------------------------------ | | VM Score | вирусный потенциал ролика по шкале от 0 до 100 | первичный отбор форматов | | Вирусность | просмотры относительно подписчиков | выход ролика за свою аудиторию | | Множитель | просмотры относительно обычного уровня автора | выброс на конкретном аккаунте | | ER | долю реакций среди просмотров | способность ролика вовлекать | | Просмотры | полученный охват | итоговый масштаб результата | В таблицах, сортировке и карточке ролика показатели называются так же, как здесь; ER в интерфейсе подписан «Вовлечённость». ## Вирусность Формула: ```text просмотры / подписчики × 100% ``` Значение 100% означает, что число просмотров равно числу подписчиков. Результат выше 100% показывает, что ролик вышел за размер своей аудитории. Метрика не доказывает, что все просмотры пришли от новых людей. ## Множитель Множитель сравнивает ролик со средними просмотрами аккаунта. Значение `1×` соответствует обычному уровню автора. Значение выше `1×` показывает отрыв от его нормы. На новом или небольшом аккаунте среднее может быть нестабильным. Не принимайте высокий множитель одного ролика за устойчивый паттерн без сравнения с другими публикациями. ## ER Отображаемая формула: ```text (лайки + комментарии + репосты + сохранения) / просмотры × 100% ``` ER помогает отличить охват от реакции. Сравнивайте ролики одной платформы, потому что доступность отдельных реакций зависит от источника данных. ## Как принять решение 1. Отберите ролики по VM Score. 2. Проверьте вирусность и множитель в контексте размера автора. 3. Сравните ER у роликов одного типа и платформы. 4. Откройте сильный и слабый ролик, затем сравните их хук и удержание. Цифры не объясняют причину результата. Для этого используйте [разбор контента](/docs/analytics/content) и данные удержания, если платформа их предоставляет. --- # Обновление аккаунтов routePath: /docs/analytics/refresh Раздел: Аналитика Описание: Настройте частоту, окно сбора и ручное обновление профилей. # Обновление аккаунтов На странице [Обновление](/analytics/refresh) вы управляете свежестью аналитики. Здесь задаются частота, окно сбора и ручной запуск для своих аккаунтов и конкурентов. Обновление статистики стоит 1 энергии за ролик в день, для Facebook применяется коэффициент ×2. Свой аккаунт, подключённый через вход в Instagram, обновляется бесплатно. Пример: 3 аккаунта конкурентов с окном в 20 роликов при ежедневном сборе расходуют до 60 энергии в день. Итог платного запуска всегда виден до подтверждения, подробнее в разделе [Энергия и лимиты](/docs/reference/energy). ## Прочитайте статус | Статус | Что делать | | ----------- | ------------------------------------------- | | Свежий | ничего, данные соответствуют расписанию | | Устарел | запустить обновление или проверить частоту | | На паузе | проверить подписку и возобновить расписание | | Нет доступа | переподключить Instagram по ссылке в строке | | Ошибка | исправить профиль и запустить перепроверку | | Вручную | обновлять только по запросу | | Без данных | запустить первый сбор | Цветная метка в списке аккаунтов показывает ту же свежесть. Расшифровка цветов приведена в разделе [Подключение аккаунтов](/docs/settings/accounts). Таблица: статус, последнее обновление, период и настройка по строке. ## Запустите обновление - Для одного профиля откройте строку и выберите разовый запуск или расписание. - Для нескольких профилей отметьте строки и используйте массовое действие. - Кнопка обновления устаревших запускает сбор по профилям, которым он нужен. Новый Reels своего аккаунта, подключённого через вход в Instagram, появляется в [Видео](/analytics/posts) сам. На активной подписке Viralmaxing замечает публикацию и запускает обновление аккаунта, обычно в пределах 15 минут после выхода ролика. Энергия за такое обновление не списывается. Выбор публикации в [воронке](/docs/automations/funnels) от обновления не зависит: он читает список из Instagram. Если аккаунт отслеживается только по нику или его нужно переподключить, новый ролик появится после обновления по расписанию или после разового запуска. У профиля в режиме «Вручную» расписания нет. Чтобы запустить обновление, на вкладке «Свои» нажмите в строке профиля кнопку с тремя точками (⋯), выберите **«Обновить данные»** и подтвердите запуск. Платное обновление списывает энергию по фактически обработанным роликам. Ошибочный профиль обычный запуск пропускает. После смены ника или открытия приватного аккаунта используйте **«Перепроверить»**. ## Выберите окно Пресет автоматического обновления запускается ежедневно ночью, с 00:30 до 02:00, и собирает публикации с метриками за последние 7 дней. Короткое окно и частое расписание подходят активным аккаунтам. Режим с последними роликами полезен, когда важнее фиксированное число публикаций. Ручной режим сохраняет собранные данные и останавливает автоматические расходы. На активной подписке свой аккаунт, подключённый через вход в Instagram, обновляется каждые 4 часа. В колонке «Расписание» и в списке [Аккаунты](/analytics/accounts) у него стоит **«Каждые 4 часа · бесплатно»**. Частоту, время запуска и ручной режим для него выбрать нельзя: в настройке стоит включённый переключатель. Окно сбора и тип контента настраиваются как обычно. Такое обновление идёт, пока активна подписка или пробный период, Instagram принимает подключение и у профиля нет ошибки. Без подписки и пробного периода в колонке «Расписание» стоит ссылка **«Нужна подписка»**, переключатель в настройке выключен, обновление вернётся с подпиской. Если Instagram отклонил доступ, у строки статус «Нет доступа», а в колонке «Расписание» стоит «Доступ отклонён» и ссылка **«Переподключить»**. Кнопка **«Переподключить Instagram»** есть и в настройке под выключенным переключателем. Если профиль не найден, закрыт или на нём нет видео, у строки статус «Ошибка», а в колонке «Расписание» стоит «Остановлено»: обновление вернётся после перепроверки профиля. Статус такого аккаунта считается от этих 4 часов, а не от сохранённой частоты: «Устарел» появляется, когда обновления не было больше 28 часов. Кнопка обновления устаревших запускает его бесплатно, и окно подтверждения говорит об этом словом «бесплатно». Если свой аккаунт Instagram отслеживается только по нику, над таблицей стоит строка с его ником и ссылкой **«Подключить напрямую: обновление каждые 4 часа бесплатно»**. Она открывает окно подключения. Та же строка есть над списком [Аккаунты](/analytics/accounts). Без подписки и пробного периода строки нет. Для Instagram можно выбрать тип контента, если этот параметр доступен у выбранного профиля. Массовая настройка применяет одну частоту ко всем отмеченным строкам, кроме своих подключённых аккаунтов: под выбором частоты названо, на какие аккаунты она не действует. Если отмечены только такие аккаунты, выбора частоты нет, стоит тот же переключатель. Слишком узкий лимит роликов может пропустить часть публикаций в день массового постинга. Если интерфейс показывает пик, увеличьте лимит или выберите более частое расписание. Текущий баланс и управление оплатой находятся в [настройках тарифа](/settings/billing). --- # Уведомления routePath: /docs/analytics/notifications Раздел: Аналитика Описание: Настройте сигналы и сводки в Telegram и проверьте, почему они не приходят. # Уведомления Уведомления отправляют сигналы и сводки в Telegram. Настройка бесплатна и не расходует энергию. Всё настраивается в одном месте, в разделе [Настройки → Интеграции](/settings/notifications): сначала подключите Telegram, затем в блоке «Уведомления» создайте подписку. Продукт сам предложит первое уведомление, когда вы добавите свой аккаунт, конкурента или креатора. ## Создайте подписку Каждая строка связывает один тип уведомления с одним чатом. Один сигнал можно отправлять в несколько чатов, а один чат может получать разные типы. 1. Нажмите **«Добавить уведомление»**. 2. Выберите тип. 3. Выберите личный или групповой чат. 4. Настройте расписание и параметры типа. 5. Выполните тестовую отправку из меню строки. Расписание задаётся днями недели и временем в часовом поясе подписки. Изменения сохраняются сразу. Статус и время последней отправки помогают проверить, что подписка работает. ## Доступные сигналы | Тип | Что придёт | | ------------------------------ | --------------------------------------------------- | | Залетевшее видео | ролик резко набирает просмотры у вас или конкурента | | Видео пробило планку | ролик набрал заданные просмотры или репосты | | Сводка по моим аккаунтам | публикации и просмотры за период | | Рекап по конкурентам за неделю | просмотры за скользящие 7 дней и топ прироста | | Напоминания о съёмках | сценарии на сегодня и просроченные за 14 дней | | Автоматизация остановилась | слетел доступ или ответы воронки не уходят | | Дайджест по креаторам за день | кто сколько выложил вчера и кто недобрал норму | | Итоги недели по креаторам | видео и просмотры каждого креатора за неделю | Для «Залетевшего видео» вы выбираете охват и чувствительность. Для планки задаёте пороги сами: до пяти на метрику, например 1000, 5000, 10 000 и 15 000 просмотров. По умолчанию планка следит за вашими аккаунтами, конкурентов можно добавить в настройках. Каждая взятая планка приходит отдельным сообщением со списком роликов, которые её пробили. О ролике на одной планке мы сообщаем один раз. Если между обновлениями ролик перескочил несколько планок, он придёт только на самой высокой. Пустое поле означает, что метрика не отслеживается. Просмотры роликов мы узнаём при обновлении аккаунта, поэтому сообщение приходит после ближайшего обновления, а не в момент пробития. Частоту обновления настраивают в разделе [«Обновление»](/docs/analytics/refresh). «Автоматизация остановилась» присылает одно сообщение на инцидент и одно о восстановлении. Креаторские типы доставляются только при доступе к разделу креаторов. Остальные работают с подключёнными своими аккаунтами и конкурентами. ## Если сообщение не пришло Проверьте: - бот всё ещё находится в выбранном чате; - у подписки включён статус; - расписание использует правильный часовой пояс; - в выбранном окне есть данные, которые проходят условие; - аккаунты обновлялись после создания подписки. «Залетевшее видео» и напоминания не отправляют сообщение, если событий нет: тишина в такой день не ошибка. Используйте предпросмотр и тест, чтобы отделить отсутствие события от ошибки доставки. Slack, Discord и Google Таблицы используются для экспорта отчётов. Уведомления сейчас доставляются через Telegram. --- # Воронки в Instagram routePath: /docs/automations/funnels Раздел: Автоматизации Описание: Настройте ответ на кодовое слово в Instagram и проверьте доставку и лиды. # Воронки в Instagram Воронка отвечает на комментарий или сообщение и отправляет материал в Direct. Она работает от имени подключённого профессионального Instagram-аккаунта. ## Подготовьте аккаунт Для автоматизации нужен отдельный вход в Instagram с разрешениями на комментарии и сообщения. Подключения для публичной аналитики недостаточно. Если Meta отозвала доступ, в разделе [Аккаунты автоматизаций](/automations/accounts) появится требование переподключить профиль. На экране Instagram каждое разрешение можно выключить отдельно. Если аккаунт подключён без разрешения на комментарии или на сообщения, воронка на нём не заработает. Viralmaxing говорит об этом сразу после подключения, а в разделе [Аккаунты автоматизаций](/automations/accounts) в колонке **«Состояние»** написано, какого разрешения нет. Нажмите **«Переподключить»** и оставьте все разрешения включёнными. После переподключения состояние аккаунта меняется. То же предупреждение стоит в форме воронки под выбором аккаунта. Число аккаунтов с включёнными воронками зависит от тарифа: на Стандарте их два на все ваши пространства вместе, на Бизнесе ограничения нет. Подробнее в разделе [Энергия и лимиты](/docs/reference/energy). Сами срабатывания не расходуют энергию. ## Создайте правило Откройте [Воронки](/automations/rules) и нажмите **«Создать воронку»**. Можно начать с шаблона или пустой формы. ### Выберите точку входа Укажите аккаунт, кодовые слова и события. Воронка может реагировать на комментарии, ответы на сторис или сообщения в Direct. ### Настройте путь Решите, отправлять материал сразу или после нажатия кнопки. Проверка подписки доступна в пути с кнопкой. ### Напишите финальное сообщение Добавьте текст и при необходимости кнопку со ссылкой. Предпросмотр справа показывает путь человека до сохранения. ### Проверьте публичный ответ Если нужен ответ под комментарием, добавьте несколько естественных вариантов. Он сообщает, что материал уже отправлен в Direct. Короткое кодовое слово может совпадать с обычными комментариями. Выбирайте фразу, которую человек пишет намеренно. Viralmaxing не разрешает конфликтующие слова у правил одного аккаунта. ## Выберите, под какими публикациями отвечать Если воронка слушает комментарии, сразу под блоком **«Где запускается воронка»** стоит выбор из трёх вариантов. | Вариант | Где воронка отвечает | |---|---| | **«Все ролики»** | под любой публикацией аккаунта: роликом, видео, каруселью или фото, включая будущие | | **«Следующий ролик»** | под первой публикацией, которая выйдет после включения воронки | | **«Выбранные»** | только под публикациями, которые вы отметили в списке | «Следующий ролик» и «Выбранные» доступны, когда в воронке выбран один аккаунт, а не «Все аккаунты». ### Следующий ролик Воронку можно поставить до публикации. Она сама привяжется к первой публикации, которая выйдет после включения: к ролику, видео, карусели или фото. Сторис и реклама не считаются. Первые комментарии получают ответ в течение нескольких минут после выхода. После этого воронка работает только под пойманной публикацией. В форме и на карточке видно, под какой. Чтобы поставить такую же воронку на следующий ролик, сделайте копию: на карточке воронки нажмите **«На следующий ролик»** (в таблице кнопка называется **«Копия на следующий»**, в узкой таблице **«Копия»**). То же кодовое слово можно занять сразу, как первая воронка поймала свою публикацию. В Direct одно слово слушает только одна воронка, какие бы ролики ни были выбраны. Поэтому у новой воронки на следующий ролик форма сама выключает запуск из Direct и пишет об этом под выбором. Включить его обратно можно тем же переключателем. Тогда в другой воронке с этим словом Direct придётся выключить. ### Любой комментарий Переключатель **«Запускать на любой комментарий»** стоит там же. С ним сообщение получает каждый, кто оставил комментарий, и кодовое слово не нужно. Он работает со «Следующим роликом» и с отмеченными публикациями в «Выбранных». На всех роликах сразу он недоступен: сообщение уходило бы на каждый комментарий аккаунта. ### Что уже пишут под публикацией Когда вы отметили публикацию в «Выбранных», форма читает её свежие комментарии и показывает короткие тексты, которые написали хотя бы два человека, с числом людей. Кнопка **«Сделать кодовым словом»** добавляет такой текст в кодовые слова. Знак вроде «+» под выбранной публикацией или следующим роликом не считается слишком частым словом. Если повторов в комментариях нет и кодового слова нет в подписи публикации, форма говорит об этом. Люди узнают слово из подписи или из самого ролика. Когда Instagram не отдал комментарии, подсказка не появляется. ## Заполните шаблон В текстах шаблона есть места в квадратных скобках: дата, тема, ссылка. Форма показывает их полями в блоке **«Заполните шаблон»** над выбором аккаунта. На компьютере под полями сказано, в сообщения каких шагов попадёт текст, а шаги с пустыми полями отмечены в воронке справа. На телефоне над полями стоит само сообщение. Заполнить поля можно и с телефона. Очищенное поле возвращает место в скобках обратно в текст. Воронку с незаполненным местом можно сохранить. Она сохранится выключенной, чтобы человеку в Direct не ушёл текст в скобках. Рядом с кнопкой **«Сохранить»** и на карточке воронки написано, что осталось. Когда всё заполнено, сохраните воронку и включите её: кнопкой **«Включить»** в сообщении после сохранения или переключателем в списке. ## Отметьте контрольный шаг Контрольный шаг отмечает, где засчитывается заявка. Заявка в Viralmaxing: человек, который дошёл до этого шага. Без него воронка работает и доставляет материал, но заявок по ней не посчитать. Флажок **«Контрольный шаг»** есть в карточке шага воронки. Контрольный шаг в воронке один: новая отметка снимает прежнюю. Когда заявка засчитывается, зависит от вида шага: | Шаг | Заявка засчитана, когда человек | |---|---| | Вопрос | ответил или ответ у него уже был и вопрос пропущен | | Подписка | прошёл проверку подписки (уже подписанные её тоже проходят) | | Сообщение с кнопкой, которая ведёт дальше по воронке | нажал эту кнопку | | Материал или последнее сообщение ветки | получил это сообщение | Переход по ссылке из материала не засчитывается: его не всегда удаётся измерить. Напоминание и досылка контрольными не бывают, потому что их отправляет время, а не действие человека. Число видно в плитке **«Заявки»** в [Обзоре](/automations/results) и в строке воронки в [списке воронок](/automations/rules). Пока шаг не отмечен ни у одной воронки, в плитке вместо числа стоит прочерк и ссылка **«Отметить в воронке»**, а подсказка к числу в списке воронок говорит «Контрольный шаг не отмечен». Воронки без отметки в число не входят. В [Лидах](/automations/leads) у таких людей стоит значок **«Заявка»**, а фильтр **«Заявки»** оставляет в списке только их. ## Проверьте запуск Воронка начинает работать после сохранения. Исключение одно: воронка с незаполненным местом из шаблона сохраняется выключенной. Оставьте тестовый комментарий с другого аккаунта и проверьте четыре точки: 1. правило зарегистрировало событие; 2. сообщение пришло в Direct; 3. публичный ответ появился, если он включён; 4. человек появился в [Лидах](/automations/leads). [Обзор](/automations/results) показывает срабатывания, слова и публикации. В [Лидах](/automations/leads) находится история конкретного человека и ручной ответ. Сообщения, которые не дошли, стоят внизу Обзора в блоке **«Не доставлено»**. В строке видно ролик, кодовое слово, время и причину словами: человек не подписан на аккаунт, прошло больше 24 часов с его последнего сообщения, Instagram не дал ответить на комментарий, аккаунт нужно подключить заново. Под заголовком написано, сколько сообщений не дошло за выбранный период и из скольких. Список собран из последних 200 сообщений каждого аккаунта за период: если отказов больше, под числом сказано, сколько из них в списке. Когда за период всё доставлено, блока на странице нет. Meta ограничивает ручной ответ временным окном после сообщения человека. Если карточка показывает «Окно закрыто», первым написать уже нельзя. ## Если новой публикации нет в списке Список публикаций для варианта «Выбранные» Viralmaxing читает из Instagram в момент, когда вы его открываете. В нём все публикации профиля: Reels, видео, карусели и фото, у каждой строки стоит пометка типа. Воронку можно привязать к любой из них. Если вы опубликовали ролик при открытой форме, нажмите **«Обновить список»** под списком. Когда Instagram не отвечает, список показывает копию аккаунта из Viralmaxing: в ней только Reels, и только что вышедшей публикации может не быть. Нажмите **«Обновить список»**. Если доступ к аккаунту потерян, над списком стоит предупреждение с кнопкой **«Переподключить Instagram»**: она ведёт в раздел [Аккаунты](/automations/accounts). Чтобы не выбирать публикацию вовсе, оставьте **«Все ролики»**. Такая воронка отвечает под любой публикацией, включая только что вышедшую. ## Ответьте тем, кто написал раньше Комментарии, оставленные до включения воронки, она сама не разбирает: иначе первое же включение разослало бы сообщения по всей истории. Ответить этим людям можно кнопкой **«Ответить написавшим»** на карточке воронки и в её строке в [списке воронок](/automations/rules). В узкой таблице кнопка называется **«Ответить»**. 1. Viralmaxing читает комментарии под роликами воронки и показывает, сколько их и сколько человек написали кодовое слово. В окне видно, от какой воронки уйдёт ответ и как начинается сообщение. 2. Сообщения уходят, только когда вы нажмёте **«Отправить всем»**. Тем, кому аккаунт уже писал, повторно ничего не уйдёт. Срок выбирается сам: у воронки на выбранные ролики он считается от выхода ролика, у воронки на все ролики это последние сутки. Его можно поменять, но не больше 7 дней: дольше Instagram не принимает ответ на комментарий. Если никого не нашлось и срок можно расширить, окно предлагает проверить за 7 дней. Сообщения уходят по очереди, примерно 15 в минуту на аккаунт. Окно можно закрыть: отправка продолжится. Чтобы остановить её, выключите воронку. Пока воронка выключена, сообщения не уходят; после включения оставшиеся продолжат уходить. После сохранения включённой воронки и после включения переключателем список сам проверяет комментарии под её роликами и, если они есть, спрашивает, ответить ли этим людям. Воронка с вариантом **«Любой комментарий»** отвечает так же, но каждому, кто написал под выбранным роликом. Число получателей видно до отправки. Выключенная воронка, воронка с незаполненным местом из шаблона и воронка, которая ещё ждёт свой ролик, написавшим раньше не отвечают. ## Если под роликами пишут, а воронки нет Когда на подключённом аккаунте нет включённой воронки, а под его роликами оставляют комментарии, над страницами [Обзор](/automations/results), [Воронки](/automations/rules) и [Аккаунты](/automations/accounts) появляется строка **«N комментариев без ответа»**. Она стоит там на любом экране: и на компьютере, и на телефоне. Кнопка **«Создать воронку»** открывает создание воронки для этого аккаунта: можно начать с шаблона или с пустой формы. Если аккаунтов без воронки несколько, кнопка ведёт на самый комментируемый: в строке он назван первым. То же число стоит в таблице **«Пишут без ответа»** на [Обзоре](/automations/results) и в колонке **«Состояние»** на странице [Аккаунты](/automations/accounts): там у каждого аккаунта своя строка и своя кнопка **«Создать воронку»**. - Считаются комментарии других людей за последние 7 дней. Ответы в ветках и ваши собственные комментарии не считаются, поэтому число меньше, чем в Instagram. - «Без ответа» значит без ответа воронки: отвечали ли вы вручную, Viralmaxing не знает. Тексты этих комментариев он не хранит. - Число исчезает, когда на аккаунте включена воронка. Тем, кто написал раньше, воронка сама не ответит: после включения список проверит комментарии под её роликами и, если есть кому ответить, предложит **«Ответить написавшим»**. - Строку можно закрыть крестиком на 30 дней. В таблице и в строке аккаунта число останется. ## Если вышел новый ролик Когда на подключённом аккаунте выходит публикация, под которой не отвечает ни одна воронка, над страницами [Обзор](/automations/results), [Воронки](/automations/rules) и [Аккаунты](/automations/accounts) появляется строка **«Вышел ролик без воронки»**. Она стоит там на любом экране: и на компьютере, и на телефоне. Кнопка **«Поставить воронку»** открывает форму воронки с уже выбранным роликом. То же предложение приходит в Telegram, если у вас включены уведомления карточки «Воронки» в [настройках уведомлений](/settings/notifications). Предложение исчезает само, когда ролик покрыт воронкой или с его выхода прошли сутки. Если работает воронка на все ролики или воронка на следующий ролик, его не будет. Строку можно закрыть крестиком. Она закрывается для этого ролика и в этом браузере: на другом устройстве строка простоит до конца суток. Если без воронки вышел ещё один ролик, на месте закрытой строки появится строка о нём. ## Если воронка молчит Если воронка включена и ни разу не сработала, а под её роликами пишут, в списке воронок в колонке **«До финала»** стоит 0, а под ним написано **«мимо слова»** с числом комментариев за 7 дней. Когда Viralmaxing знает, что именно пишут, число ведёт в таблицу **«Пишут без ответа»** на [Обзоре](/automations/results): в ней видно тексты, сколько человек их написали и вместо какого слова. Чаще всего это значит, что подпись ролика просит написать одно, а в воронке стоит другое слово. У строки со словом одна кнопка, **«Сделать кодовым словом»**: - если так написали хотя бы двое и слово не частое, оно сразу становится кодовым словом воронки, и таблица предлагает ответить тем, кто его уже написал; - у частого слова и у текста, который написал один человек, кнопка открывает форму воронки, где слово уже добавлено и рядом написано, чем оно грозит. Например, «+» у воронки на все ролики сработает на любой комментарий со знаком. Чтобы слово заработало, нажмите **«Сохранить»**. Если в воронке уже 10 кодовых слов, форма скажет, что места нет. В той же таблице стоят написания, похожие на кодовое слово работающей воронки (например, «boook» вместо «book»). Если под роликами не пишут вовсе, проверьте статус правила, выбранный аккаунт, права Meta, кодовое слово и включённые типы событий. Для группы «Все аккаунты» учтите, что новые подключения тоже попадают под активное правило и занимают лимит тарифа. Простую воронку можно создать через [ассистента](/assistant). Перед подтверждением он показывает текст, слово и ссылку. Сложные шаги добавьте в редакторе правила. --- # Поиск идей routePath: /docs/research/idea-search Раздел: Поиск идей Описание: Найдите сильные свежие ролики по теме во вкладке «Поиск» контент-плана и заберите их в план. # Поиск идей Поиск живёт в контент-плане: **Контент-план → Предложено → Поиск**. Рядом лежит подборка, которую Viralmaxing собирает сам: сильные свежие ролики ваших конкурентов («От конкурентов») и авторов вашей ниши («Для вас»). Поиск нужен, когда хочется снять ролик на конкретную тему, а в подборке её нет. Запуск стоит 30 энергии. Если ничего не нашлось или поиск не удался, энергия не списывается. ## Запустите поиск ### Опишите тему Напишите тему или идею ролика, например `уход за кожей после 30`. Поиск идёт по словам, и под полем видно, какие слова пойдут в поиск, а какие отброшены как общие. Хэштеги ищутся как есть. ### Нажмите «Найти» Кнопка показывает цену. Поиск идёт обычно меньше минуты; со страницы можно уйти, а когда он закончится, придёт уведомление. ## Отберите ролики В выдаче те же карточки, что во всей подборке: клик открывает ролик, **«В план»** берёт его в работу, **«⋯ → Во входящие»** сохраняет на потом. Ролики за выбранный период (по умолчанию за 90 дней) из Instagram, TikTok и YouTube, Instagram идёт первым и занимает половину выдачи. - **Площадка**: значки над выдачей, как в аналитике. - **Период**: 7, 30, 90 дней, год или всё время. Новый поиск ищет за выбранный период прямо на площадках, срок написан под полем запроса. У открытой выдачи период короче её срока сужает её бесплатно; если роликов осталось мало, рядом кнопки «Искать за … на площадках» и «Показать всю выдачу». Свой диапазон дат внутри срока выдачи только сужает её. Период длиннее срока выдачи означает новый поиск за 30 энергии. - **Сортировка**: «По теме» (порядок самого поиска), «Свежие» или «Больше просмотров». Если по словам нашлось не то, **«Искать по смыслу»** под выдачей повторит запрос через ИИ за 30 энергии. Если не нашлось ничего, Viralmaxing бесплатно предложит соседние запросы. Под полем открытой выдачи стоит строка **«Уточнить»**: крестик у слова убирает его из запроса бесплатно, а **«+ слово»** за 30 энергии ищет ролики по запросу вместе с новым словом и дописывает в конец этой выдачи только те, которых в ней ещё нет. ## Найдите ещё такие ролики **«⋯ → Ещё такие»** на любой карточке «Предложено» и **«Показать похожие»** в открытом ролике показывают до 24 роликов из нашей базы, похожих на этот по смыслу: бесплатно и сразу, не больше двух от одного автора. Похожие ищутся на той же площадке, что и ролик: за 90 дней, а во вкладке «Поиск» за выбранный период. В Instagram ролики на другом языке, чем этот, не показываются, в TikTok и YouTube они идут после роликов на том же языке. Кнопка **«Искать на площадках»** бесплатно подберёт слова этого ролика и подставит их в поле «Поиска»: вы их проверите, а поиск за 30 энергии запустит «Найти». В открытом ролике та же кнопка покажет слова и два поиска по ним, у каждого цена: дописать ролики в открытую выдачу или начать новый поиск. Если похожих в нашей базе не нашли, например ролик только что попал в базу, там же будет эта кнопка. ## Вернитесь к прошлым поискам Справа стоит колонка **«Недавние запросы»**, на телефоне она под полем запроса. Открыть прошлую выдачу бесплатно: она уже оплачена. Когда вы открываете вкладку «Поиск», сразу показывается выдача, которую вы смотрели последней, а поле для нового запроса остаётся сверху. Лишний запрос убирается из истории крестиком. Если написать запрос, который уже искали, «Найти» тоже откроет ту выдачу бесплатно: цены на кнопке тогда нет, а под полем написано, что откроется. Так бывает, если выдаче не больше 7 дней, а при периоде 7 дней не больше 42 часов: иначе в ней мало роликов за последнюю неделю. Поиск, который ещё идёт, тоже откроется, а не начнётся второй раз. Кнопка **«Обновить: только новое»** за 30 энергии допишет в конец выдачи ролики, которых там ещё нет. Раньше поиск был отдельной страницей «Найти идеи». Старые ссылки ведут во вкладку «Поиск», и запрос из ссылки подставляется в поле. Сам поиск без вашего нажатия не запускается. --- # Подборки routePath: /docs/research/collections Раздел: Подборки Описание: Сохраняйте ролики в подборки, разбирайте их вместе и выгружайте для команды. # Подборки Подборка хранит ролики по одной теме, клиенту или формату. Сохранение уже найденного ролика бесплатно. Импорт новой ссылки стоит 1 энергии за ролик. ## Создайте подборку 1. Откройте [Подборки](/explore/collections) и нажмите **«Создать подборку»**. 2. Дайте ей название, которое объясняет критерий отбора. Например, «Хуки для запуска». 3. В поиске идей или аналитике нажмите закладку на карточке ролика. Один ролик может находиться в нескольких подборках. Удаление из одной не меняет остальные. ## Добавьте ролики по ссылке Кнопка добавления в шапке принимает ссылки на TikTok, Instagram и YouTube. Вставляйте по одной ссылке на строку. Viralmaxing показывает распознанные и ошибочные ссылки до запуска. Плата списывается только за ролик, которого ещё нет в базе. После отправки импорт продолжается в фоне, поэтому метрики могут появиться не сразу. Итоговый отчёт показывает принятые ссылки и причины ошибок. ## Сравните подборку Используйте таблицу, когда нужно сопоставить VM Score, вирусность, ER и просмотры. Сетка лучше подходит для быстрого просмотра обложек и форматов. Фильтры работают только внутри текущей подборки. Они не запускают новый поиск и не расходуют энергию. Настроенный набор колонок сохраняется и используется при экспорте. ## Передайте результат Выгрузите текущую таблицу в CSV или Excel. Экспорт бесплатен. Если команда работает внутри Viralmaxing, отправьте ссылку на подборку и заранее договоритесь о критерии отбора. Удаление подборки необратимо, но не удаляет сами ролики из Viralmaxing. Они останутся в других подборках и разделах, где были сохранены. Когда выбор сделан, создайте сценарии через [План](/docs/scenarios/plan). --- # План и сценарии routePath: /docs/scenarios/plan Раздел: Сценарии Описание: Ведите сценарии на доске, в списке или календаре и сохраняйте версии текста. # План и сценарии [План](/plan) хранит сценарии, статусы и даты публикаций. Один набор данных можно смотреть как канбан, список или календарь. ## Создайте сценарий Кнопка **«+»** предлагает пустой сценарий или создание из ссылки. Сценарий также появляется после действия **«Адаптировать»** в поиске идей и аналитике. Создание стоит 1 энергии. Привязанный ролик сохраняет рядом обложку, метрики и доступную расшифровку. ## Подготовьте текст Сценарий пишется тремя частями: **Хук**, **Основа** и **Призыв**. У каждой части видно, сколько секунд она займёт в кадре. Над частями стоит длина всего ролика. Если выбрать цель 15, 30 или 60 секунд, будет видно, насколько ролик её перерос. Хук длиннее 5 секунд отмечается под полем. Текст одним куском раскладывается по частям кнопкой **«Разложить»**: по предложениям, без ИИ и бесплатно. Текст с метками «Хук:», «Тело:», «CTA:» раскладывается по частям сам. Текст с заголовками и план ролика открываются одним полем. У плана есть кнопка **«Написать текст»**: она ведёт в «Обсуждение», цена хода указана на кнопке. Вернуться к частям можно в меню **«⋯»**. ### Выберите отправную точку Начните с пустого текста, обсуждения с AI или расшифровки привязанного ролика. Ролик, взятый в план, расшифровывается бесплатно, до 40 роликов в день. Сверх этого расшифровка стоит 10 энергии, и цена видна на кнопке. ### Исправляйте фрагменты Выделите хук, абзац или призыв и отправьте конкретную задачу. Без выделения ассистент работает со всем сценарием. ### Проверьте разницу AI показывает добавленные и удалённые части. Нажмите **«Применить»** только после чтения предложения. ### Сохраните изменения Ручные правки не сохраняются автоматически. Индикатор «Изменено» означает, что AI пока видит последнюю сохранённую версию. AI-переписывание стоит 3 энергии. Точечная правка фрагмента стоит 1 энергии. Ручной набор и сохранение бесплатны. ## Восстановите версию Версии появляются сами. Перед переписыванием ИИ, восстановлением и правкой из «Обсуждения» текущий текст сохраняется версией. Текст, который записал ИИ-агент через коннектор или чат, сам становится версией. Ваш собственный текст становится версией, когда вы возвращаетесь к нему после перерыва больше 30 минут. Выберите старую версию, сравните её с текущей и нажмите **«Восстановить»**. Восстановление создаёт новую версию и не стирает историю. Архивирование переносит сценарий в отменённые и допускает возврат. Удаление необратимо. ## Организуйте работу - Канбан показывает этапы и позволяет менять статус перетаскиванием. - Список удобен для линейного просмотра и мобильного экрана. - Календарь показывает запланированные даты публикаций. Доска: колонки-статусы, карточки с датами и исходными роликами. В [настройках Плана](/settings/plan) можно управлять статусами, дорожками и тегами. Дорожки подходят для каналов, клиентов или серий. Категория статуса помогает системе понимать этап, а название можно адаптировать под процесс команды. Экспорт сохраняет текущие фильтры и видимые поля. Готовый текст также можно скопировать без таймкодов или скачать в `.txt`. Снимать по готовому тексту можно в [телесуфлёре](/docs/scenarios/teleprompter) приложения для iPhone. Если исходный ролик удалён на платформе, сценарий и сохранённый текст остаются доступными. Повторная расшифровка и загрузка медиа могут завершиться ошибкой. --- # Телесуфлёр routePath: /docs/scenarios/teleprompter Раздел: Сценарии Описание: Снимайте ролик на iPhone, читая сценарий или свой текст с суфлёра у объектива. # Телесуфлёр Телесуфлёр в [приложении для iPhone](/app) показывает текст у самого объектива и прокручивает его, пока вы записываете ролик на камеру телефона. Читать можно сценарий из Студии или любой свой текст. Суфлёр и запись работают на устройстве и не расходуют энергию. В веб-версии суфлёра нет: сценарий готовят на сайте в [Плане](/docs/scenarios/plan), а снимают в приложении. ## Откройте суфлёр Есть три входа. Выберите тот, который совпадает с источником текста. - **Со сценария.** Кнопка **«Записать видео»** на странице сценария открывает камеру с его текстом. Кнопка видна, когда в сценарии есть текст. - **Из читалки сценария.** Нажмите на текст сценария, чтобы открыть его целиком. Внизу экрана будут кнопки **«Суфлёр»** и **«Записать видео»**. «Суфлёр» прокручивает текст на экране без камеры, «Записать видео» открывает камеру. - **Без сценария.** Нажмите **«+»** и выберите **«Снять с суфлёром»** или откройте нижнее меню **«Ещё»** и выберите **«Телесуфлёр»**. ## Задайте текст Со страницы сценария суфлёр показывает его текст, и заменить этот текст на камере нельзя. При входе через «+» или меню нажмите на пустую полосу суфлёра или на кнопку **«Текст суфлёра»** и вставьте свой текст. Он сохраняется на телефоне до следующего раза. Сценарий из такого текста не создаётся. Кнопка **«Выбрать сценарий»** слева подставляет текст сценария из Студии, **«Без сценария»** возвращает ваш текст. Название выбранного сценария видно под текстом суфлёра. ## Настройте чтение и камеру Кнопка **«Настройки телесуфлёра»** слева открывает две настройки поверх камеры. Они запоминаются и действуют в читалке тоже. | Настройка | Варианты | | ------------------ | --------------------------------- | | Скорость прокрутки | Медленно, Обычная, Быстро | | Размер шрифта | Маленький, Средний, Большой | Справа находятся кнопки камеры. По умолчанию включена фронтальная камера, **«Перевернуть камеру»** переключает на основную. Качество съёмки меняется нажатием на чип: 720p, 1080p (по умолчанию) или 4K. Масштаб меняется щипком по экрану. На фронтальной камере превью зеркальное, как в зеркале. Сам ролик записывается без отражения, поэтому надписи в кадре читаются правильно. ## Запишите дубль ### Нажмите кнопку записи Начнётся обратный отсчёт 3, 2, 1. Повторное нажатие во время отсчёта отменяет запись. ### Читайте текст После отсчёта начинается запись, и текст прокручивается сам. Нажмите на полосу суфлёра, чтобы поставить прокрутку на паузу или продолжить. ### Остановите запись Нажмите кнопку записи ещё раз. Следующий дубль снова начнётся с начала текста. Пока открыт суфлёр, экран телефона не гаснет. Если свернуть приложение во время записи, запись остановится. Для съёмки приложению нужен доступ к камере и микрофону: без него суфлёр покажет кнопку перехода в настройки iPhone. ## Где найти дубли Куда попадает дубль, зависит от того, привязан ли сценарий. - **Со сценарием.** Дубли хранятся в приложении рядом со сценарием, свежие первыми. Отметьте удачный звёздочкой **«Лучший»** и нажмите **«Сохранить в Фото»**, чтобы забрать его для монтажа. Дубли не загружаются на сервер и удаляются вместе с приложением. - **Без сценария.** Дубль сразу сохраняется в Фото. Миниатюра последнего дубля открывает приложение Фото. Если сохранить не удалось, нажмите кнопку повтора, пока не закрыли экран. Сценарий для съёмки удобно подготовить в [Плане](/docs/scenarios/plan): выберите ролик-образец, перепишите текст под себя и откройте его в приложении. --- # AI-ассистент routePath: /docs/assistant/overview Раздел: AI-ассистент Описание: Работайте с аккаунтами, роликами и сценариями через чат в текущем пространстве. # AI-ассистент Ассистент отвечает по данным текущего пространства. Он может разобрать ролик, найти идеи и подготовить сценарий. Действия, которые меняют данные или расходуют энергию, требуют вашего подтверждения. ## Что ассистент умеет | Умеет | Не умеет | | ------------------------------------------------------------ | -------------------------------------------- | | искать идеи и разбирать ролики по вашим данным | публиковать и планировать посты в соцсетях | | создавать и править сценарии в Плане | менять тариф и управлять оплатой | | сравнивать ваши аккаунты и конкурентов за период | добавлять участников и менять роли | | создавать [простую воронку](/docs/automations/funnels) | отвечать по данным другого пространства | Тот же набор возможностей доступен внешним AI-агентам через [MCP и API](/developers): Claude или другой ассистент подключается к тем же данным с теми же подтверждениями. ## Дайте нужный контекст Откройте [AI-ассистент](/assistant) и сформулируйте результат. Например: `сравни мои лучшие ролики за месяц и предложи три темы для следующей недели`. К сообщению можно прикрепить аккаунт, ролик или поддерживаемый файл. Ссылку на видео можно вставить прямо в текст. AI-профиль в [настройках](/settings/ai) добавляет нишу, аудиторию и постоянные требования к стилю. Если подключённых данных нет, ассистент не сможет сравнить ваши результаты. Сначала добавьте профиль в [Аккаунтах](/analytics/accounts?scope=own). ## Выполните задачу - Для разбора прикрепите ролик и спросите, что сработало в хуке, структуре и реакции аудитории. - Для поиска назовите тему и платформу. Поиск идей стоит 30 энергии. - Для сценария опишите формат или приложите ролик. Создание сценария стоит 1 энергии. Большой результат открывается в отдельной панели. Оттуда его можно обсудить в чате, скопировать или продолжить в Плане. ## Подтвердите изменения Когда ассистент предлагает создать или изменить объект, появляется панель действий. **«Выполнить»** применяет предложение, **«Уточнить»** отправляет правку, **«Отменить»** закрывает действие. Текстовое сообщение «да» не заменяет кнопку подтверждения. Это защищает от случайного изменения данных и незаметного списания энергии. Проверяйте выбранное пространство перед выполнением действия. Ассистент использует его аккаунты, сценарии и баланс. ## Работайте с историей Чаты сохраняются автоматически. Их можно закрепить, переименовать, архивировать, экспортировать или удалить. Архивирование обратимо. Удаление восстановить нельзя. Начинайте новый чат при смене темы. Так контекст старой задачи не будет влиять на ответ. Практические шаблоны запросов собраны в разделе [Как писать запросы](/docs/assistant/effective-prompts). --- # Как писать запросы ассистенту routePath: /docs/assistant/effective-prompts Раздел: AI-ассистент Описание: Формулируйте результат, формат и ограничения, чтобы получать полезный ответ с первой попытки. # Как писать запросы ассистенту Хороший запрос называет результат, исходные данные и ограничения. Ассистент уже знает инструменты Viralmaxing, поэтому длинная ролевая инструкция ему не нужна. ## Шаблон запроса Соберите фразу из четырёх частей: 1. **Действие.** Что нужно сделать: найти, сравнить, разобрать или написать. 2. **Источник.** Какие аккаунты, ролики или период использовать. 3. **Формат.** Сценарий, таблица, список хуков или план публикаций. 4. **Ограничение.** Платформа, длительность, аудитория или число вариантов. ## Готовые формулировки под реальные задачи Скопируйте и подставьте свою тему. Рядом указано, что запрос стоит: чтение уже собранных данных бесплатно, создание нового расходует [энергию](/docs/reference/energy), и ассистент показывает цену до запуска. **Разбор своих результатов, бесплатно:** > Сравни мои ролики за последние 30 дней с предыдущими 30. Назови три вывода и один эксперимент на следующий период. Выводы покажи списком со ссылками на ролики. **Идеи с адаптацией, поиск 30 энергии плюс 1 энергии за сценарий:** > Найди десять роликов про уход за кожей в Instagram Reels, выбери три самых повторяемых формата и адаптируй каждый в сценарий до 30 секунд для косметолога. **Разбор чужого ролика, 10 энергии:** > Разбери этот ролик: что держит внимание в хуке и структуре, что из этого повторить в моей нише. Ссылка в сообщении. **Правка сценария, 1 энергии за фрагмент:** Откройте сценарий в [Плане](/plan), выделите фрагмент и напишите задачу: > Сократи хук до восьми слов и замени вопрос на утверждение. ## Давайте задачу целиком Если итог требует разбора и создания, объедините их в одном запросе. Это помогает ассистенту сохранить критерий отбора. Вместо двух сообщений «разбери ролики» и «теперь напиши сценарии» используйте: > Разбери десять лучших роликов конкурента за месяц, назови общие паттерны и напиши три сценария по самому устойчивому паттерну. ## Исправляйте конкретно После первого ответа назовите, что меняете. Например: - `сократи сценарий до 20 секунд`; - `замени вопрос в хуке на утверждение`; - `оставь структуру, но убери профессиональный жаргон`; - `покажи выводы таблицей и добавь ссылки на ролики`. Постоянные требования к голосу и стоп-словам лучше записать в [AI-профиле](/settings/ai). В чате оставляйте требования к текущей задаче. ## Используйте улучшение промпта Кнопка **«Улучшить промпт»** переписывает черновик до отправки. Проверьте предложенный вариант и выберите **«Оставить»** или **«Вернуть»**. Ничего не отправляется автоматически. ## Избегайте двух ошибок - Общий запрос вроде `помоги с контентом` не задаёт проверяемый результат. - Длинная роль вроде `действуй как эксперт с десятью годами опыта` занимает место, но не уточняет задачу. При смене темы начните новый чат. Если нужен полный рабочий маршрут, откройте [гайд от идеи до сценария](/docs/guides/getting-started). --- # Команда и пространства routePath: /docs/collaboration/team Раздел: Команда и пространства Описание: Разделите данные по пространствам и выдайте участникам подходящие роли. # Команда и пространства Пространство определяет, какие данные видит участник. Роль определяет, что он может с ними делать. Настраивайте оба параметра отдельно. ## Разделите клиентов Создайте пространство в [Настройках](/settings/workspaces), затем переключитесь в него и добавьте аккаунты клиента. Новое пространство пустое. Существующие данные остаются в прежнем контексте. Активное пространство используется в аналитике, Плане, ассистенте, а также в [MCP и API](/developers). Проверяйте его перед платной операцией или массовым изменением. Архивирование скрывает пространство и позволяет восстановить его. Удаление необратимо и требует точного подтверждения имени. Переключение, архивирование или удаление активного пространства перезагружает страницу. Сохраните сценарий и завершите текущий ответ ассистента заранее. ## Пригласите участника 1. Откройте [Команду](/settings/team) и нажмите **«Пригласить»**. 2. Укажите email. 3. Выберите роль. 4. Дайте доступ ко всем или только к выбранным пространствам. 5. Отправьте приглашение. Приглашение нужно принять под тем же email. Число участников ограничено тарифом: на Стандарте один участник, на Бизнесе без ограничений. Ожидающие и истёкшие приглашения занимают место в лимите, пока вы их не удалите. ## Выберите роль | Роль | Может делать | | ------------- | ---------------------------------------------- | | Наблюдатель | смотреть аналитику, План и сценарии | | Редактор | создавать контент и запускать рабочие операции | | Администратор | управлять командой, пространствами и оплатой | Администратор получает права аккаунта, даже если видит только одно пространство. Для клиента обычно подходит Наблюдатель, для внешнего автора Редактор, для совладельца Администратор. Удаление участника отзывает доступ сразу, но не удаляет созданные им сценарии. Снижение роли также сохраняет историю работы. ## Следите за расходом Команда использует общий баланс владельца. Редактор может запускать поиск, разбор и AI-правки, но не управляет оплатой. Планируйте лимит с учётом числа активных участников и проверяйте остаток в [настройках тарифа](/settings/billing). Что расходует энергию и что бесплатно, описано в разделе [Энергия и лимиты](/docs/reference/energy). Для агентского маршрута от создания клиента до проверки доступа откройте гайд [«Я веду клиентов»](/docs/guides/agency). --- # Подключение аккаунтов routePath: /docs/settings/accounts Раздел: Настройки Описание: Подключите свои профили и конкурентов и настройте сбор статистики. # Подключение аккаунтов Добавьте свои профили для анализа результатов и конкурентов для наблюдения за нишей. Экран [Аккаунты](/analytics/accounts?scope=own) управляет списком. Частота сбора настраивается отдельно в разделе [Обновление](/docs/analytics/refresh). ## Добавьте профиль 1. Выберите вкладку «Свои» или «Конкуренты». 2. Вставьте ссылку или ник, по одному профилю на строку. 3. Проверьте определённую платформу. 4. Выберите объём загружаемых роликов. 5. Проверьте итоговую стоимость и запустите сбор. Импорт стоит 1 энергии за новый ролик, для Facebook действует коэффициент ×2. Viralmaxing показывает сумму до подтверждения. Свой аккаунт, подключённый через вход в Instagram, импортируется и обновляется бесплатно. Публичные аккаунты Instagram, TikTok, YouTube и Facebook можно добавить без передачи пароля от соцсети. Отдельный вход владельца нужен для данных, которые платформа не отдаёт публично, например для части YouTube-удержания. ## Разделяйте свои и чужие аккаунты Свои профили попадают в общую аналитику результатов. Конкуренты используются в сравнении и ленте чужих роликов. Перемещение между вкладками меняет роль профиля, но сохраняет уже собранную статистику. Если вы не знаете конкретных конкурентов, [поиск похожих аккаунтов](/explore/discover) работает по выбранным источникам и стоит 200 энергии за каждый источник. ## Проверьте свежесть Цветная метка показывает дату последнего обновления: - зелёная, менее трёх дней; - жёлтая, от трёх до семи дней; - красная, более семи дней или ошибка; - серая, данных ещё нет. Аккаунты, свежесть данных и основные показатели. Клик по метке ведёт к расписанию. Там можно выполнить разовый сбор, выбрать пресет или включить ручной режим. У своего аккаунта, подключённого через вход в Instagram, частота не настраивается: он обновляется каждые 4 часа, и под датой обновления у него стоит «Каждые 4 часа · бесплатно». Подробнее в разделе [Обновление](/docs/analytics/refresh). Разовый запуск, частота и окно сбора профиля. ## Исправьте ошибку профиля | Состояние | Следующий шаг | | ------------------ | --------------------------------- | | Не найден | исправить ник или удалить профиль | | Приватный | открыть профиль и перепроверить | | Нет видео | расширить окно сбора | | Ограничен | повторить позже | | Нужна перепривязка | пройти подключение заново | После исправления используйте **«Перепроверить»**. Массовое обновление может пропускать профили с ошибкой. Снятие отслеживания убирает аккаунт и его ролики из вашей рабочей аналитики. Если нужно только остановить расходы, сначала переведите расписание в ручной режим. Свой аккаунт, подключённый через вход в Instagram, энергию на обновление не тратит, и ручного режима у него нет. --- # Энергия и лимиты routePath: /docs/reference/energy Раздел: Справочник Описание: Разберитесь, какие действия расходуют энергию, что входит в тариф и где проверить баланс. # Энергия и лимиты Энергия оплачивает создание нового: поиск, импорт данных, расшифровку и генерацию. Чтение уже собранного бесплатно. Это позволяет открывать аналитику, План и историю чатов сколько угодно раз без расхода. Перед каждым платным действием Viralmaxing показывает итоговую стоимость. Списание происходит только после вашего подтверждения. То же правило действует для ассистента и для [MCP и API](/developers): агент обязан назвать цену до запуска операции. ## Что расходует энергию - Поиск идей по слову, описанию или аккаунту стоит 30 энергии. - Поиск похожих аккаунтов стоит 200 энергии за каждый выбранный источник. - Разбор ролика или его расшифровка стоит 10 энергии, если она не бесплатна. - Полное AI-переписывание сценария стоит 3 энергии. - Создание сценария из ролика и точечная AI-правка фрагмента стоят 1 энергии. - Импорт и обновление статистики стоят 1 энергии за ролик, если они не бесплатны. Для Facebook действует коэффициент ×2. - Голосовой ввод стоит 1 энергии за сообщение. ## Что бесплатно - Расшифровка ролика, который вы сохранили во «Входящие», открыли в «Предложено» или поиске либо взяли в план: до 40 роликов в день, из них до 20 при открытии карточек. - Импорт и обновление статистики своего аккаунта, подключённого через вход в Instagram. Отдельный ролик, добавленный по ссылке, стоит энергию как обычно. - Просмотр аналитики, фильтры, сравнение периодов и экспорт. - Сохранение ролика в подборку. - Ручной набор и правка текста сценария, сохранение версий. - Анализ профиля аккаунта: темы, стили и сводка появляются без списания. - Уведомления в Telegram и их настройка. ## Где смотреть баланс Остаток, тариф и пополнение находятся в [настройках тарифа](/settings/billing). Актуальные условия и объём энергии по тарифам опубликованы на странице [Тарифы](/pricing). Документация не дублирует цены тарифов: источник правды продукт. Если энергии не хватает, платное действие не запускается, а продукт предлагает изменить тариф или пополнить баланс. Уже собранные данные при этом остаются доступными. ## Что входит в тариф Тарифов два: Стандарт для личной работы и Бизнес для команды. Тариф определяет, сколько людей и аккаунтов работает в продукте. Объём энергии на месяц выбирается отдельно и от тарифа не зависит. | Что входит | Стандарт | Бизнес | | ---------------------------------- | --------------- | --------------- | | Instagram-аккаунты с воронками | 2 | Без ограничений | | Участники команды, кроме владельца | 1 | Без ограничений | | Пространства | Без ограничений | Без ограничений | | Свои подключённые аккаунты | Без ограничений | Без ограничений | | Креаторы в ростере | Без ограничений | Без ограничений | | Выгрузки аналитики и диалогов | Есть | Есть | Для [воронок](/docs/automations/funnels) считаются аккаунты, на которых включена хотя бы одна воронка. Лимит общий для всех ваших пространств: на Стандарте это два аккаунта на все пространства вместе, а аккаунт, подключённый в двух пространствах, считается один раз. Число воронок на одном аккаунте не ограничено. Выключенная воронка место не занимает: на Стандарте можно выключить воронку на одном аккаунте и включить на другом. Тариф Лайт больше не продаётся. У тех, кто оформил его раньше, он продлевается и работает как Стандарт, но без участников команды. Без активной подписки платные действия, воронки, команда, ростер креаторов и выгрузки недоступны. ## Общий баланс команды Все участники пространства тратят энергию из баланса владельца аккаунта. Редактор может запускать поиск, разбор и AI-правки, поэтому планируйте лимит с учётом числа активных участников. Роли и модель доступа описаны в разделе [Команда и пространства](/docs/collaboration/team). Регулярный автоматический расход почти всегда создаёт [обновление аккаунтов](/docs/analytics/refresh). Если нужно остановить фоновые списания, переведите расписание профилей в ручной режим: данные сохранятся, а сбор прекратится. Свой аккаунт, подключённый через вход в Instagram, в этот расход не входит: он обновляется бесплатно. --- # Оплата и подписка routePath: /docs/reference/billing Раздел: Справочник Описание: Узнайте, как оплатить подписку рублями или другой валютой, есть ли пробный период и как отменить подписку. # Оплата и подписка Здесь собраны ответы про деньги: чем и в какой валюте платить, есть ли пробный период, как отменить подписку и куда писать про возврат. Подписка, энергия и история платежей живут в разделе [Настройки → Тариф и оплата](/settings/billing). ## Как оплатить рублями На сайте подписка оплачивается картой в рублях, долларах или белорусских рублях. На экране оплаты есть переключатель «Валюта оплаты»: выберите валюту своей карты. Если ни одна не подходит, выберите USD. | Валюта | Платёжная система | Карты | | ------ | ----------------- | ----- | | RUB | CloudPayments | Visa, MasterCard, МИР, Apple Pay, Samsung Pay | | USD | bePaid | Visa, MasterCard, БЕЛКАРТ | | BYN | bePaid | Visa, MasterCard, БЕЛКАРТ | Валюту по умолчанию продукт подбирает по часовому поясу устройства: в российском поясе это рубли, в остальных доллары. Если оплата не прошла, на экране ошибки можно сразу попробовать другую валюту. Цены тарифов опубликованы на странице [Тарифы](/pricing); итоговая сумма всегда видна на экране оплаты до подтверждения. ## Есть ли пробный период Бесплатного пробного периода сейчас нет, и стартовой энергии без подписки тоже нет. Бесплатно остаётся чтение уже собранного; что именно расходует энергию, описано на странице [Энергия и лимиты](/docs/reference/energy). ## Как отменить подписку ### Откройте раздел подписки Перейдите в [Настройки → Тариф и оплата](/settings/billing) и найдите блок «Платёжный метод». ### Нажмите «Отменить подписку» Выберите причину, нажмите «Продолжить», затем «Всё равно отменить подписку». После отмены новых списаний не будет, а доступ сохранится до конца оплаченного периода: дата видна на той же странице. Кнопки нет, если автопродление уже выключено. Отменить подписку может только тот, у кого есть права на оплату в пространстве. Возобновить отменённую подписку одной кнопкой нельзя. Когда до конца периода остаётся три дня или меньше, либо период уже закончился, появляется кнопка «Продлить подписку»: она открывает новую оплату. ## Подписка из App Store Подписку, оформленную в приложении для iPhone, продаёт и списывает Apple. Отменяйте её в настройках App Store на iPhone: кнопка на сайте не останавливает списания Apple. Тариф при этом тот же, что при оплате на сайте. ## Возврат денег В первые три дня после оплаты на сайте вернём деньги полностью. Напишите в поддержку: значок «Поддержка» в верхней панели продукта или почта support@viralmaxing.com. Укажите почту, на которую оформлен аккаунт; способ оплаты и номер карты присылать не нужно. Деньги возвращаются тем же способом, которым прошла оплата, обычно в течение 7 календарных дней: срок зависит от банка. Покупку в приложении для iPhone возвращает Apple: запрос на возврат подаётся через App Store. ## Докупить энергию Пока подписка активна, энергию можно докупить в блоке «Энергия» кнопкой «Докупить энергию». Докупленная энергия не сгорает и суммируется с энергией подписки. Как расходуется энергия, читайте в [Энергия и лимиты](/docs/reference/energy). --- # Developer documentation locale: en routePath: /developers Описание: Connect Viralmaxing to AI agents through MCP or to applications through the REST API. # Developer documentation Connect Viralmaxing to an AI agent through MCP or call the REST API from your application. Both interfaces work with data in the selected workspace. ## Choose an interface ### MCP for an AI agent Claude, Cursor, and Codex receive Viralmaxing tools after browser sign-in. There is no API key to copy. ### REST API for an application Create a key and access data over HTTP. API Reference contains the current methods and response schemas. ## How access works Each connection is scoped to one workspace. Accounts, videos, scenarios, and automations in other workspaces remain unavailable until the agent switches explicitly. Reading existing data is free. Operations that create a new result spend energy. An MCP tool returns the exact price and requires `confirm_cost`, so the agent must get your approval before calling it. ## Machine-readable documents | File | Purpose | | ------------------------------------------------------------------------ | ------------------------------------------- | | [`/developers/llms.txt`](/developers/llms.txt) | Map of developer documents | | [`/agents.md`](/agents.md) | When to use Viralmaxing and how to connect | | [`/llms-full.txt`](/llms-full.txt) | Full product documentation corpus | | [`/.well-known/mcp/server-card.json`](/.well-known/mcp/server-card.json) | MCP endpoint, authentication, and tool list | REST methods, parameters, and response schemas are published in [API Reference](https://docs.viralmaxing.com). --- # MCP quick start locale: en routePath: /developers/mcp/quick-start Описание: Add the Viralmaxing MCP server, sign in through the browser, and give the agent its first safe request. # MCP quick start MCP gives an AI agent tools for reading analytics, researching videos, and working with scenarios. The connection uses OAuth, so its configuration needs no secrets. ## Server address ```text https://api.viralmaxing.com/api/mcp ``` The server uses Streamable HTTP. ## Claude Code Run this command in the project directory: ```bash claude mcp add --transport http --scope project viralmaxing https://api.viralmaxing.com/api/mcp ``` Open `/mcp` in the session and start sign-in for `viralmaxing`. Choose a workspace in the browser and approve access. ## Claude, Cursor, and other clients If the client accepts JSON configuration, add the server without custom headers or keys: ```json { "mcpServers": { "viralmaxing": { "type": "http", "url": "https://api.viralmaxing.com/api/mcp" } } } ``` In Claude, open connector settings and add a custom connector at the same address. In Cursor, use MCP settings. The client opens Viralmaxing sign-in after saving the server. [Settings → API keys](/settings/api) contains a ready-to-use agent prompt. It asks the agent to add the server, complete OAuth, and check the tool list. ## First request Ask the agent to call `list_workspaces`, then `list_my_accounts`. Both calls only read data and spend no energy. Continue with [connection verification](/developers/mcp/verification) to confirm that the agent is using the intended workspace. --- # Verify the connection locale: en routePath: /developers/mcp/verification Описание: Check the tool list, current workspace, and data access without running a paid operation. # Verify the connection Verify a connection with read operations. This separates access problems from paid work and leaves workspace data unchanged. ## 1. Get the tool list Ask the client to call `tools/list`. The result should contain Viralmaxing tools such as `list_workspaces`, `list_my_accounts`, and `list_posts`. An empty list usually means that sign-in is incomplete or the client configured the server as `stdio` instead of HTTP. ## 2. Check the workspace Call `list_workspaces`. The result lists available workspaces and marks the current one. When the user names a client or brand, select its workspace through `switch_workspace` before reading data. An unexpectedly empty account list often means that the agent is in the wrong workspace. ## 3. Read data Call one safe tool: - `list_my_accounts` for the user's own profiles; - `list_competitors` for tracked competitors; - `get_energy_balance` for the plan and remaining balance. A successful result confirms the transport, authentication, and data scope. ## Before a paid call Research, transcription, and import tools return a price. State it to the user, wait for explicit approval, then call the tool again with the exact `confirm_cost`. Never loop a paid tool. --- # MCP troubleshooting locale: en routePath: /developers/mcp/troubleshooting Описание: Checks for missing tools, repeated sign-in, incorrect workspace data, and authorization errors. # MCP troubleshooting ### The client cannot see tools Check the address `https://api.viralmaxing.com/api/mcp` and use HTTP transport. Remove a trailing slash, custom headers, and API keys from the OAuth configuration. Reconnect the server and call `tools/list` again. ### Sign-in keeps opening The token may have expired or the connection may have been revoked. Open [Settings → API keys](/settings/api), check connected agents, and start sign-in again. If the client retains the old session, remove the server from the client and add it again. ### The agent sees the wrong data Call `list_workspaces` and check the current workspace. Switching through MCP changes context only for that connection. It does not change the workspace open in the user's app. ### A paid tool returns an error Read the quoted price first. Get the user's approval and pass the exact value as `confirm_cost`. A different amount is rejected. Retrying cannot fix an inactive plan or insufficient energy. ### The server returns 401 The client did not send a valid token. Refresh the OAuth session or sign in again. For unattended server automation, use an [API key](/developers/rest/authentication). ### The server returns 403 The connection is valid, but the workspace role does not allow this operation. Ask the workspace owner to perform the action or provide suitable access. If these checks do not resolve the problem, open support from the documentation header. Include the client name, error text, and request time. Do not send tokens or keys. --- # Viralmaxing skills for agents locale: en routePath: /developers/mcp/skills Описание: Five ready-made skills and the connector in one command: npx skills add Viralmaxing/skill. # Viralmaxing skills for agents The connector gives an agent tools. The skills explain **how to use them**: where to start when breaking down an account, how research differs from reading the plan, which calls cost energy, and when to ask before spending it. The repository is public and generated from the product's own source, so it cannot drift from it: [Viralmaxing/skill](https://github.com/Viralmaxing/skill). ## Install ```bash npx skills add Viralmaxing/skill ``` One command installs both the skills and the MCP server: the repository follows the Agent Plugins spec: `skills/` for the skills, `mcp.json` for the connector. You do not need to add the server separately afterwards. If you only want the connector, without the skills: ```bash claude mcp add --transport http --scope project viralmaxing https://api.viralmaxing.com/api/mcp ``` ## What is inside | Skill | What it covers | | --- | --- | | `viralmaxing-analytics` | Metrics for tracked accounts: views, engagement, movement over time | | `viralmaxing-research` | Comparison against competitors, discovery of new accounts and ideas | | `viralmaxing-video` | Transcript and metric detail for one video | | `viralmaxing-plan` | The content plan: take a video into work, write and move a scenario | | `viralmaxing-automations` | Instagram comment-to-Direct funnels | The split is deliberate: an agent loads only the skill a request needs instead of spending context on the rest. ## Sign-in and money The skills carry no secrets. Authorization goes through OAuth in the browser, same as the connector itself. See [MCP quick start](/developers/mcp/quick-start). Paid actions never run silently: the tool quotes its price and waits for confirmation. What costs what is in the [energy reference](/docs/reference/energy). --- # REST API quick start locale: en routePath: /developers/rest/quick-start Описание: Create an API key, store it in an environment variable, and make the first request. # REST API quick start The REST API suits server integrations, reports, and internal tools. For an AI client with a person present, [MCP](/developers/mcp/quick-start) is usually simpler. ## 1. Create a key Open [Settings → API keys](/settings/api), select Create, and give the key a recognizable name. Copy the full key immediately. It is not shown again after you close the dialog. ## 2. Store the secret Keep the key in an environment variable instead of source code: ```bash export VIRALMAXING_API_KEY='vmx_...' ``` Do not commit `.env` or put the key in a URL. ## 3. Make a request ```bash curl --request GET \ --url https://api.viralmaxing.com/api/users/api-keys/ \ --header "X-API-Key: $VIRALMAXING_API_KEY" ``` The request returns the key list without secret values. A `200` response confirms that the key was accepted. API base URL: ```text https://api.viralmaxing.com/api ``` Open [API Reference](https://docs.viralmaxing.com) to choose a method and inspect its parameters. --- # REST API authentication locale: en routePath: /developers/rest/authentication Описание: How to send, store, rotate, and revoke an API key without exposing it. # REST API authentication An API key starts with `vmx_` and grants access to one workspace. Send it with every request in one of two ways. ## X-API-Key header ```http X-API-Key: vmx_... ``` This is the primary and most explicit option. ## Bearer token ```http Authorization: Bearer vmx_... ``` Both headers are accepted equally. Do not send them together. ## Storage and rotation - keep the key in a secret manager or environment variable; - create a separate key for each integration; - review its last-used date in settings; - delete it after a leak, ownership change, or integration shutdown. Deletion revokes access immediately. A lost key cannot be recovered. Create a replacement and delete the old key. Do not embed a key in browser JavaScript, a mobile application, or a public repository. Requests carrying the secret must originate from your server. ## Access errors `401` means that the key is missing, invalid, expired, or revoked. `403` means the key is valid, but the user's workspace role does not allow the operation. --- # Your first REST request locale: en routePath: /developers/rest/first-request Описание: Verify a key with cURL or server-side JavaScript and handle common API responses. # Your first REST request Start with a read. It verifies authentication without changing workspace data. ## cURL ```bash curl --request GET \ --url https://api.viralmaxing.com/api/analytics/accounts/ \ --header "X-API-Key: $VIRALMAXING_API_KEY" \ --header "Accept: application/json" ``` ## Server-side JavaScript ```js const response = await fetch('https://api.viralmaxing.com/api/analytics/accounts/', { headers: { Accept: 'application/json', 'X-API-Key': process.env.VIRALMAXING_API_KEY, }, }); if (!response.ok) { throw new Error(`Viralmaxing API returned ${response.status}`); } const accounts = await response.json(); ``` ## Interpret the response - `200` means the request succeeded; - `400` points to invalid parameters or a business constraint; - `401` requires a valid key; - `403` points to an insufficient workspace role; - `429` requires a delay before retrying. Do not retry an unchanged request after `400`. Read the error body and correct the parameters. Use increasing backoff for `429`. All available paths and response schemas are in [API Reference](https://docs.viralmaxing.com). --- # Документация для разработчиков locale: ru routePath: /ru/developers Описание: Подключение Viralmaxing к AI-агентам через MCP и к приложениям через REST API. # Документация для разработчиков Подключите Viralmaxing к AI-агенту через MCP или вызывайте REST API из своего приложения. Оба интерфейса работают с данными выбранного пространства. ## Выберите интерфейс ### MCP для AI-агента Claude, Cursor и Codex получают инструменты Viralmaxing после входа через браузер. API-ключ копировать не нужно. ### REST API для приложения Создайте ключ и обращайтесь к данным по HTTP. Схемы методов и ответов находятся в API Reference. ## Как устроен доступ Каждое подключение привязано к одному пространству. Аккаунты, ролики, сценарии и автоматизации из других пространств не видны, пока агент не переключится в них явно. Чтение уже собранных данных бесплатно. Операции, которые создают новый результат, расходуют энергию. MCP-инструмент сообщает точную цену и требует `confirm_cost`, поэтому агент должен получить ваше согласие до вызова. ## Что читать агенту | Файл | Для чего нужен | | ------------------------------------------------------------------------ | ------------------------------------------------- | | [`/developers/llms.txt`](/developers/llms.txt) | Карта документов для разработчиков | | [`/agents.md`](/agents.md) | Когда использовать Viralmaxing и как подключиться | | [`/llms-full.txt`](/llms-full.txt) | Полный корпус документации продукта | | [`/.well-known/mcp/server-card.json`](/.well-known/mcp/server-card.json) | Адрес MCP, способ входа и список инструментов | Список методов REST, параметры и схемы ответов публикуются в [API Reference](https://docs.viralmaxing.com). --- # Быстрый старт с MCP locale: ru routePath: /ru/developers/mcp/quick-start Описание: Добавьте MCP-сервер Viralmaxing, войдите через браузер и дайте агенту первый безопасный запрос. # Быстрый старт с MCP MCP даёт AI-агенту инструменты для чтения аналитики, исследования роликов и работы со сценариями. Подключение использует OAuth, поэтому секреты в конфигурации не нужны. ## Адрес сервера ```text https://api.viralmaxing.com/api/mcp ``` Транспорт сервера: Streamable HTTP. ## Claude Code Выполните команду в каталоге проекта: ```bash claude mcp add --transport http --scope project viralmaxing https://api.viralmaxing.com/api/mcp ``` Откройте `/mcp` в сессии и запустите вход для `viralmaxing`. В браузере выберите пространство и подтвердите доступ. ## Claude, Cursor и другие клиенты Если клиент принимает JSON-конфигурацию, добавьте сервер без заголовков и ключей: ```json { "mcpServers": { "viralmaxing": { "type": "http", "url": "https://api.viralmaxing.com/api/mcp" } } } ``` В Claude откройте настройки коннекторов и добавьте свой коннектор по тому же адресу. В Cursor используйте настройки MCP. После сохранения клиент откроет страницу входа Viralmaxing. В [Настройки → API-ключи](/settings/api) есть готовый промпт для агента. Он просит добавить сервер, пройти OAuth и проверить список инструментов. ## Первый запрос Попросите агента выполнить `list_workspaces`, затем `list_my_accounts`. Оба вызова только читают данные и не расходуют энергию. Перейдите к [проверке подключения](/ru/developers/mcp/verification), чтобы убедиться, что агент находится в нужном пространстве. --- # Проверка подключения locale: ru routePath: /ru/developers/mcp/verification Описание: Проверьте список инструментов, текущее пространство и доступ к данным без платных операций. # Проверка подключения Проверяйте соединение чтением. Так вы отделите проблему доступа от платной операции и не измените данные пространства. ## 1. Получите список инструментов Попросите клиента вызвать `tools/list`. В ответе должны быть инструменты Viralmaxing, в том числе `list_workspaces`, `list_my_accounts` и `list_posts`. Если список пуст, клиент ещё не завершил вход или подключил сервер как `stdio` вместо HTTP. ## 2. Проверьте пространство Вызовите `list_workspaces`. Ответ показывает доступные пространства и отмечает текущее. Если пользователь назвал клиента или бренд, сначала выберите соответствующее пространство через `switch_workspace`. Пустой список аккаунтов часто означает, что агент смотрит не в то пространство. ## 3. Прочитайте данные Вызовите один из безопасных инструментов: - `list_my_accounts` для собственных профилей; - `list_competitors` для отслеживаемых конкурентов; - `get_energy_balance` для тарифа и доступного остатка. Успешный ответ подтверждает транспорт, авторизацию и область данных. ## Перед платным вызовом Инструменты исследования, расшифровки и импорта сообщают стоимость. Назовите её пользователю, дождитесь явного согласия и только после этого повторите вызов с точным `confirm_cost`. Не запускайте платный инструмент циклом. --- # Проблемы с MCP locale: ru routePath: /ru/developers/mcp/troubleshooting Описание: Что проверить, если клиент не видит инструменты, вход зациклился или данные пространства не совпадают. # Проблемы с MCP ### Клиент не видит инструменты Проверьте адрес `https://api.viralmaxing.com/api/mcp` и тип транспорта HTTP. Уберите слеш в конце, пользовательские заголовки и API-ключ из OAuth-конфигурации. Затем переподключите сервер и снова вызовите `tools/list`. ### Вход открывается повторно Токен мог истечь или подключение было отозвано. Откройте [Настройки → API-ключи](/settings/api), проверьте список подключённых агентов и запустите вход заново. Если клиент хранит старую сессию, удалите сервер из него и добавьте снова. ### Агент видит не те данные Вызовите `list_workspaces` и проверьте текущее пространство. Переключение внутри MCP меняет контекст только для этого подключения. Оно не меняет пространство, открытое у пользователя в приложении. ### Платный инструмент возвращает ошибку Сначала прочитайте цену из ответа. Затем получите согласие пользователя и передайте точное значение в `confirm_cost`. Другая сумма будет отклонена. Ошибка о тарифе или недостатке энергии не исправляется повторным вызовом. ### Сервер возвращает 401 Клиент не передал действующий токен. Обновите OAuth-сессию или пройдите вход заново. Для серверной автоматизации без браузера используйте [API-ключ](/ru/developers/rest/authentication). ### Сервер возвращает 403 Подключение действует, но роль в пространстве не разрешает операцию. Попросите владельца пространства выполнить действие или выдать подходящий доступ. Если проверка не помогла, откройте поддержку через кнопку в верхней панели документации. Приложите название клиента, текст ошибки и время запроса. Не отправляйте токены и ключи. --- # Навыки Viralmaxing для агентов locale: ru routePath: /ru/developers/mcp/skills Описание: Пять готовых навыков и коннектор одной командой: npx skills add Viralmaxing/skill. # Навыки Viralmaxing для агентов Коннектор даёт агенту инструменты. Навыки объясняют, **как ими пользоваться**: с чего начинать разбор аккаунта, чем отличается исследование от чтения плана, какие вызовы стоят энергии и когда спрашивать разрешение. Репозиторий публичный и собирается из исходников продукта, поэтому расходится с ним он не может: [Viralmaxing/skill](https://github.com/Viralmaxing/skill). ## Установка ```bash npx skills add Viralmaxing/skill ``` Одна команда ставит и навыки, и сам MCP-сервер: репозиторий оформлен по спецификации Agent Plugins: `skills/` для навыков, `mcp.json` для коннектора. Отдельно добавлять сервер после этого не нужно. Если нужен только коннектор, без навыков: ```bash claude mcp add --transport http --scope project viralmaxing https://api.viralmaxing.com/api/mcp ``` ## Что внутри | Навык | Для чего | | --- | --- | | `viralmaxing-analytics` | Метрики отслеживаемых аккаунтов: просмотры, вовлечение, динамика | | `viralmaxing-research` | Сравнение с конкурентами, поиск новых аккаунтов и идей | | `viralmaxing-video` | Транскрипт и разбор конкретного ролика | | `viralmaxing-plan` | Контент-план: взять видео в работу, написать и передвинуть сценарий | | `viralmaxing-automations` | Воронки «кодовое слово → Direct» в Instagram | Навыки разделены по задачам намеренно: агент подгружает только тот, который нужен запросу, и не тратит контекст на остальные. ## Вход и деньги Навыки не содержат секретов. Авторизация: через OAuth в браузере, как и у самого коннектора: см. [Быстрый старт с MCP](/developers/mcp/quick-start). Платные действия навыки не выполняют молча: инструмент называет цену и ждёт подтверждения. Что сколько стоит: в [справочнике по энергии](/docs/reference/energy). --- # Быстрый старт с REST API locale: ru routePath: /ru/developers/rest/quick-start Описание: Создайте API-ключ, сохраните его в переменной окружения и выполните первый запрос. # Быстрый старт с REST API REST API подходит для серверных интеграций, отчётов и внутренних инструментов. Для AI-клиента с человеком у экрана обычно проще [MCP](/ru/developers/mcp/quick-start). ## 1. Создайте ключ Откройте [Настройки → API-ключи](/settings/api), нажмите «Создать» и задайте понятное имя. Скопируйте полный ключ сразу. После закрытия окна он больше не показывается. ## 2. Сохраните секрет Положите ключ в переменную окружения, а не в исходный код: ```bash export VIRALMAXING_API_KEY='vmx_...' ``` Не коммитьте `.env` и не передавайте ключ в URL. ## 3. Выполните запрос ```bash curl --request GET \ --url https://api.viralmaxing.com/api/users/api-keys/ \ --header "X-API-Key: $VIRALMAXING_API_KEY" ``` Запрос возвращает список ключей без их секретных значений. Ответ `200` подтверждает, что ключ принят. Базовый адрес API: ```text https://api.viralmaxing.com/api ``` Откройте [API Reference](https://docs.viralmaxing.com), чтобы выбрать метод и увидеть его параметры. --- # Авторизация REST API locale: ru routePath: /ru/developers/rest/authentication Описание: Как передавать ключ, хранить его и отзывать без утечки секретов. # Авторизация REST API API-ключ начинается с `vmx_` и даёт доступ к одному пространству. Передавайте его в каждом запросе одним из двух способов. ## Заголовок X-API-Key ```http X-API-Key: vmx_... ``` Это основной и наиболее явный вариант. ## Bearer ```http Authorization: Bearer vmx_... ``` Оба заголовка принимаются одинаково. Не передавайте их одновременно. ## Хранение и ротация - храните ключ в менеджере секретов или переменной окружения; - создавайте отдельный ключ для каждой интеграции; - проверяйте дату последнего использования в настройках; - удаляйте ключ при утечке, смене владельца или остановке интеграции. Удаление отзывает доступ немедленно. Если приложение потеряло ключ, восстановить его значение нельзя. Создайте новый и удалите старый. Не вставляйте ключ в клиентский JavaScript, мобильное приложение или публичный репозиторий. Запросы с секретом должны идти с вашего сервера. ## Ошибки доступа `401` означает, что ключ отсутствует, недействителен, истёк или отозван. `403` означает, что ключ принят, но роль пользователя в пространстве не разрешает операцию. --- # Первый REST-запрос locale: ru routePath: /ru/developers/rest/first-request Описание: Проверьте ключ через cURL или JavaScript и разберите типовые ответы API. # Первый REST-запрос Начните с чтения. Такой запрос проверяет авторизацию и не меняет данные пространства. ## cURL ```bash curl --request GET \ --url https://api.viralmaxing.com/api/analytics/accounts/ \ --header "X-API-Key: $VIRALMAXING_API_KEY" \ --header "Accept: application/json" ``` ## JavaScript на сервере ```js const response = await fetch('https://api.viralmaxing.com/api/analytics/accounts/', { headers: { Accept: 'application/json', 'X-API-Key': process.env.VIRALMAXING_API_KEY, }, }); if (!response.ok) { throw new Error(`Viralmaxing API returned ${response.status}`); } const accounts = await response.json(); ``` ## Как читать ответ - `200` означает, что запрос выполнен; - `400` указывает на неверные параметры или бизнес-ограничение; - `401` просит заменить или добавить ключ; - `403` указывает на недостаточную роль; - `429` требует паузы перед повтором. Не повторяйте запрос без изменений после `400`. Прочитайте тело ошибки и исправьте параметры. Для `429` используйте задержку с увеличением интервала. Все доступные пути и структуры ответов находятся в [API Reference](https://docs.viralmaxing.com).