Как добавить пользователя в проект

Перед началом

Добавлять пользователей должен администратор проекта или компании. Не выдавайте ADMIN по умолчанию: это повышает риск случайного изменения тарифов, доменов, интеграций и пользователей.

[ТУТ СКРИНШОТ: модальное окно добавления пользователя в проект]

Порядок действий

1. Откройте настройки проекта.
2. Перейдите в пользователей или доступы.
3. Введите email пользователя.
4. Выберите роль.
5. Сохраните изменения.
6. Попросите пользователя войти и открыть проект.

Как выбрать роль

• для просмотра отчётов — viewer/read-only;
• для SEO-работ — доступ к SEO и файлам;
• для маркетолога — автопостинг, ссылки, отчёты;
• для администратора — настройки проекта, пользователи, домены, тарифы.

Проверка

После добавления откройте проект под пользователем или попросите его прислать скриншот доступного меню. Важно проверить не только вход в проект, но и отсутствие лишних разделов.

Важно. Если пользователь видит кнопку редактирования Help/Documentation, значит у него есть ADMIN-роль или frontend считает его администратором. Это нужно проверять отдельно.

Контрольный чек-лист

• Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
• Проверьте роль пользователя: часть кнопок видна только администратору.
• Откройте DevTools → Network и найдите запрос к /v1/....
• Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
• Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.

Что приложить к задаче разработчику

Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.

[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]

Что именно решает эта статья

Эта инструкция помогает создать и подготовить проект к работе. После выполнения шагов пользователь должен понимать, где находится нужный экран, какую кнопку нажать, какие поля заполнить и по какому признаку проверить, что действие завершилось успешно.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ страницу проектов с карточкой проекта, настройками домена и участниками, при этом стрелками или рамками выделены главный раздел меню и основная кнопка действия]

Пошаговый сценарий

1. Откройте проект. Перейдите в рабочий проект CDP, потому что большинство действий привязаны к projectUuid и правам пользователя.
2. Найдите нужный раздел. Откройте пункт меню, который относится к теме статьи: Help.
3. Проверьте обязательные поля. Не запускайте действие, пока не заполнены поля, без которых система не сможет сохранить настройку или выполнить проверку.
4. Запустите действие. Нажмите основную кнопку создания, запуска, проверки или сохранения. Если кнопка неактивна, вернитесь к обязательным полям и правам доступа.
5. Проверьте результат. Убедитесь, что появилась карточка, строка в таблице, статус успешного выполнения или понятное сообщение об ошибке.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ модальное окно или форма из этой статьи, заполненные примерными корректными данными; обязательные поля отмечены рамками]

Как читать результат

Смотрите не только на общий статус. В CDP важны детали: дата запуска, пользователь, проект, статус обработки, текст ошибки, связанные сущности и действия, которые можно выполнить дальше. Если результат связан с лимитами тарифа, проверяйте страницу лимитов и сообщение 402. Если результат связан с внешним сервисом, проверяйте подключение, ключи и журнал выполнения.

• Успешный статус означает, что CDP приняла действие и сохранила результат.
• Предупреждение означает, что действие выполнено, но есть риск неполного результата или неправильной настройки.
• Ошибка требует исправления входных данных, прав доступа, лимита тарифа или внешнего подключения.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ готовый результат после выполнения действия: таблица, карточка или отчёт со статусом, датой, кнопкой открытия деталей и блоком ошибок]

Частые ошибки

• Действие запускают не в том проекте, поэтому данные не появляются там, где их ожидают.
• Пользователь не имеет нужной роли или доступа к проекту.
• Не заполнено обязательное поле, но пользователь пытается сохранить форму.
• Ожидается мгновенный результат там, где проверка или сбор данных выполняется асинхронно.
• Ошибка 402 воспринимается как техническая поломка, хотя чаще всего это лимит тарифа или неподключённая возможность.

Контрольный список перед обращением в поддержку

1. Сделайте скрин страницы с ошибкой и открытыми деталями.
2. Скопируйте точный текст ошибки и время возникновения.
3. Укажите projectUuid, если он отображается в адресе страницы.
4. Проверьте, повторяется ли проблема после обновления страницы.
5. Если проблема связана с файлом, отчётом или логами, скачайте файл результата и приложите его к задаче.