Коды ошибок CRM (mpbx-crm)

Возвращаются маршрутами интеграции с CRM под /api/v1/integrations/crm (W7-INT-01a). Сообщения никогда не содержат учётных данных, URL запроса или ответа CRM; в них указываются не более чем идентификаторы, имена полей, правила, коды статусов и машинные коды. Руководство: шаблоны CRM.

Код	HTTP	Значение	Что делать
MPBX-CRM-NOT-FOUND	404	В этой компании нет такой интеграции (интеграция другой компании не видна).	Проверьте идентификатор.
MPBX-CRM-JOB-NOT-FOUND	404	В этой компании нет такого задания журнала либо оно удалено (выполненные задания хранятся 7 дней, неудачные — 30 дней).	Проверьте идентификатор.
MPBX-CRM-TEMPLATE-INVALID	400	Текст шаблона некорректен. Сообщение перечисляет первые пять проблем с их местом в документе; POST /integrations/crm/validate перечисляет все.	Исправьте шаблон; см. руководство.
MPBX-CRM-NAME-TAKEN	409	Другая интеграция компании имеет это имя.	Выберите другое имя.
MPBX-CRM-FIELD-INVALID	400	Поле вне допустимого диапазона: name (от 1 до 80 символов); учётные данные, которые не объявлены в шаблоне, либо значение которых пусто, длиннее 4096 байт или содержит управляющие символы; тестовая переменная, которой нет у операции или которая имеет другой тип; number для поиска, не состоящий из 3–20 цифр (возможно, с ведущим +); query поиска длиной не от 2 до 100 символов или limit вне диапазона от 1 до 20.	Исправьте указанное поле.
MPBX-CRM-CHANGED	409	Интеграция изменилась между вашим чтением и записью.	Перечитайте её и повторите с новым ETag.
MPBX-CRM-LIMIT-REACHED	409	В компании уже 10 интеграций.	Удалите одну.
MPBX-CRM-CREDENTIALS-REQUIRED	400	Шаблон называет учётные данные, для которых нет значения, а вы пытались включить интеграцию, запустить настоящий (не пробный) тест либо для вызова нужны учётные данные. Также возникает, если после изменения шаблона base_url перешёл на другой адрес: сохранённые учётные данные тогда намеренно удаляются (учётные данные только для записи не должны отправляться на адрес, который их владелец не утвердил).	Задайте недостающие учётные данные (PUT /integrations/crm/{id}/credentials).
MPBX-CRM-CREDENTIALS-UNREADABLE	500	Зашифрованные учётные данные нельзя открыть (мастер-ключ заменён без перешифровки или строка повреждена).	Задайте учётные данные заново.
MPBX-CRM-DISABLED	409	Интеграция выключена (для создания контакта её нужно включить).	Включите её.
MPBX-CRM-OPERATION-UNSUPPORTED	400	В шаблоне нет такой операции.	Добавьте операцию в шаблон или выберите другую.
MPBX-CRM-RATE-LIMITED	429	Более 20 пробных запусков или более 600 поисков, запросов по номеру и созданий контактов в минуту для компании.	Подождите минуту (Retry-After: 60).
MPBX-CRM-NOT-RETRYABLE	409	Повторить можно только неудачное задание.	Дождитесь завершения ожидающего задания.
MPBX-CRM-CALL-BLOCKED	503	Защита исходящих запросов отклонила адрес CRM после разрешения имени: адрес не https либо приватный, loopback, link-local (метаданные облака), carrier-grade NAT, документационный, многоадресный или зарезервированный (включая формы IPv4-mapped и NAT64), либо внутреннее имя.	Используйте публичный адрес https.
MPBX-CRM-CALL-TIMEOUT	503	CRM не ответила в пределах лимита времени операции.	Проверьте CRM; увеличьте timeout_ms (от 500 до 15000), если она медленная.
MPBX-CRM-CALL-REFUSED	503	CRM ответила кодом ошибки; сообщение указывает статус.	Проверьте учётные данные и запрос в тестовой консоли (пробный запуск).
MPBX-CRM-CALL-BAD-RESPONSE	503	Ответ CRM не является JSON либо шаблон не читает из него ничего.	Сравните сопоставление ответа с реальным ответом.
MPBX-CRM-CALL-FAILED	503	До CRM не удалось достучаться (разрешение имени, соединение, TLS) либо её ответ больше 256 КиБ.	Проверьте адрес и доступность CRM.

Журнал обращений (GET /integrations/crm/{id}/log) и неудачные задания журнала содержат короткий машинный код сбоя вместо проблемы HTTP: blocked, dns, network, timeout, too_large, http_status, bad_response, template_error (шаблон не смог построить запрос) и credentials_missing.