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

Почему агент не видит инструменты заявок?

Проверьте, что плагин установлен в MCP, а у используемого токена выданы нужные права в блоке «Заявки». Права отдельных инструментов собраны в шесть групп. Для чтения формы нужны «Список форм» и «Форма целиком», для её изменения — соответствующие права группы «Конструктор форм».

Что означает app_outdated?

Установленное приложение «Заявки» не предоставляет методы, необходимые инструменту. Обновите его до версии 2026.09.16 или новее. Минимальная версия MCP — 1.3.0. Проверка совместимости выполняется до записи инструментом, который её требует.

Почему не создаётся заявка в выключенной форме?

Обычное создание учитывает активность и период приёма формы. При выключенной форме возможен form_inactive, при закрытом периоде — form_closed. Для осознанного создания или переноса в такую форму есть аргумент allow_closed_form: true; он не включает форму для посетителей.

Почему имя поля не принимается?

Имя должно однозначно соответствовать полю этой формы. Ошибка ambiguous_field возникает также при неизвестном имени или идентификаторе. Получите requests_get_form и используйте field_id; перечень полей есть и в ответе ошибки. При validation_error проверьте отдельные ошибки в validation_errors.

Почему скрыты контакт и автор комментария?

Без полного доступа пользователя токена к «Заявкам» либо доступа к Контактам, CRM или Команде блок contact и имя автора author возвращаются как null. Номер contact_id остаётся видимым. Это не скрывает значения, введённые в саму заявку: поля с именем, телефоном и email могут читаться по правам на заявку.

Явная привязка через contact_id без необходимых прав возвращает forbidden, а отдельный поиск контактов — access_denied. Вместо явной привязки при создании можно использовать автоподбор формы или no_contact: true.

Как отключить письма о заявках от агента?

В MCP → Плагины → Заявки для MCP выключите «Уведомления по заявкам от агента». Это управляет уведомлениями при requests_create_request. Импорт всегда выполняется без уведомлений, а отдельная тестовая отправка — самостоятельное действие с подтверждением.

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

Можно ли повторить вызов после обрыва связи?

requests_create_request при повторе может создать ещё одну заявку. Сначала проверьте результат чтением заявок. Для переноса предназначен requests_import_requests со стабильным external_id: повтор в той же форме обычно возвращает exists.

При импорте обязательно проверяйте предупреждения. Если запись создана, но ответ сообщает, что external_id не сохранён, повторять её нельзя. created_with_error означает, что заявка уже создана и её нужно проверить по идентификатору.

Почему удаление или проверка уведомлений просит подтверждение?

Эти операции требуют confirm: true. Без него возвращается confirm_required. Удаление формы уносит все её заявки; удаление поля сохраняет старые значения в заявках. Снятие вложения при правке тоже требует подтверждения и удаляет файл с сайта. Тестовое уведомление отправляется настоящим получателям.

Почему токен формы показан как три звёздочки?

*** — маска непустой секретной настройки в ответе requests_get_form. Её имя перечислено в masked_settings. Не записывайте маску обратно: при обычной правке исключайте скрытые ключи, а для замены передавайте новое настоящее значение.

Почему не добавляется файл?

Передавайте список объектов файлов по каждому полю, даже для одного вложения. В объекте должен быть ровно один источник: url, content_base64 или file_path. Для base64 обязательно имя с расширением; предел — 500 КиБ после декодирования. Для ссылки и серверного пути предел плагина — 20 МиБ, а правила поля могут быть строже.

file_path принимается только из каталога загрузок MCP на сервере. Для правки используйте files.add и files.remove: формат создания в requests_update_request не подходит.

Почему CSV содержит меньше заявок, чем ожидалось?

В текущей реализации выборка CSV ограничена 100 заявками, хотя схема инструмента и описание указывают предел 1000. Проверяйте rows, total и truncated. Сужайте фильтры до полной выборки либо читайте список постранично. Подробнее — в статье «Заявки, файлы и перенос».

Копия формы выключена, а получатели после переноса не заполнены — это ошибка?

Копирование и импорт создают выключенную форму. При переносе исключаются токены, ключи и настройки конкретной установки, включая получателей. Проверьте omitted_settings в выгрузке и warnings после импорта, заполните недостающие значения и затем включите форму. Заявки при копировании и переносе структуры не переносятся.