Частые вопросы

Где страница настроек плагина?

У плагина нет собственной формы настроек. В приложении MCP выберите права токена в разделе «Команда», сгруппированные как «Чтение», «Приглашения» и «Запись». Названия пунктов перечислены в настройке доступа.

Почему агент не видит нужный инструмент?

Проверьте, установлен ли плагин и разрешено ли токену отдельное право с именем этого инструмента. Например, для карточки нужно team_get_user, для изменения профиля — другое право, team_update_user.

Почему список сотрудников пуст или в нём не все люди?

Список ограничен видимостью сотрудников для пользователя, от имени которого работает MCP. По умолчанию запрашиваются действующие сотрудники (state=active); для других состояний предусмотрены banned и all. Проверьте также группу и пагинацию: по умолчанию возвращается 20 записей.

Почему поиск по имени или e-mail не работает вместе с группой?

В team_list_users при переданном group_id фильтр группы имеет приоритет, а search не применяется. Выполните поиск без group_id. Строка с @ ищется по e-mail, остальные строки — по имени.

Почему «Права доступа» возвращают отказ, хотя право токена включено?

team_get_access дополнительно требует администратора приложения «Команда». Передайте ровно один объект: contact_id сотрудника или group_id группы. Оба параметра одновременно, как и отсутствие обоих, дают invalid_arguments.

Можно ли одним запросом получить события за несколько лет?

Нет. Для событий, свода отсутствий и журнала период ограничен 366 днями за вызов. Передавайте обе границы date_from и date_to; длинный период разделите на части. Превышение даёт period_too_long.

Почему в событиях нет дней рождения, а отпуск за январь короче полной длительности?

Дни рождения приложение формирует на лету без записи события, поэтому team_list_events их не возвращает. Свод отсутствий учитывает только пересечение события с выбранным периодом. Отсутствие с 25 декабря по 15 января в отчёте за январь даёт 15 дней.

Почему срок приглашения отличается от страницы «Приглашённые»?

При нескольких живых приглашениях одного сотрудника team_list_invitations выбирает приглашение с самым поздним сроком истечения. В описании инструмента отмечено известное отличие от страницы «Приглашённые», которая может показывать более ранний срок. Принятые и просроченные приглашения в выдачу инструмента не входят.

Что означает confirm_required и всегда ли изменение требует подтверждения?

Без confirm=true не выполняются team_disable_user, team_delete_group, team_revoke_access, team_delete_event. Сам плагин не показывает диалог: согласование в разговоре организует агент. Другие изменения, включая замену состава группы и уровень 0 через team_grant_access, этого параметра не требуют.

Как добавить одного сотрудника в группу и можно ли очистить группу пустым списком?

team_set_group_members принимает полный новый состав: сначала получите текущий список, затем передайте всех нужных участников вместе с новым сотрудником. Пропущенные участники будут исключены. Пустой массив не принимается; допустимо от 1 до 200 контактов.

Почему после отзыва прав доступ может сохраниться?

team_revoke_access записывает сотруднику личный уровень 0 по приложению. Доступ также может приходить от групп или административных прав. Проверьте итоговую матрицу через team_get_access, особенно is_admin и from_groups. Изменение прав по обычным приложениям у контакта с личным глобальным административным правом блокируется обработчиком.

Почему в журнале нет входов и почему повтор создания дал два события?

Журнал намеренно исключает login, logout и login_failed, в том числе из свода. Создание событий и отсутствий не защищено от повторного создания: каждый вызов добавляет новую запись. После сбоя связи проверьте список событий до повтора.