​
Что такое managed SIP

В управляемом развёртывании Агентика сама хранит и применяет конфигурацию SIP-транка: вы выбираете опубликованный шаблон оператора, передаёте учётные данные подключения, контрактные номера и входящий воркфлоу, а платформа размещает подключение на своей cell — изолированной PBX-ячейке — и применяет сгенерированную конфигурацию Asterisk. Входящий и исходящий SIP идут напрямую между оператором и Asterisk. Подключения создаются и изменяются через API managed-sip-connections. Создание доступно из сессии панели управления: запросы с X-API-Key отклоняются — credentials управляемого транка не делегируются API-ключам.

​
Статусы подключения

API может возвращать и служебные статусы, которые разбирает оператор платформы: drain_stuck (зависшая остановка — конфигурация ячейки не удаляется вслепую) и reconcile_required (требуется сверка после повторных сбоев применения; такое подключение можно и удалить — DELETE переводит его в draining, как обычное активное). DELETE работает и из activating — без ожидания таймаута применения.

​
Ожидание мощности (202)

Если при создании свободной мощности нет, API отвечает 202, а подключение получает статус queued. В теле ответа приходят операция и status_url — опрашивайте GET /api/v1/managed-sip-connections/operations/{operation_id}, пока статус терминальный. Тот же URL доступен в списке подключений и в панели управления. В списке и карточке подключения есть поле registration_state (registered, registering, failed, unknown или null). Статус active означает, что конфигурация применена, но не гарантирует, что линия зарегистрирована у оператора — ориентируйтесь на registration_state. Когда мощность появляется, подключение размещается автоматически — в порядке очереди, без повторного создания; ожидающая операция превращается в обычную активацию. Ожидание ограничено политикой класса (по умолчанию 24 часа): после этого подключение переходит в failed с типизированной ошибкой managed_sip_capacity_timeout.
Ожидающее подключение можно отменить: DELETE завершается синхронно — cell для него никогда не провижинилась. Повторное создание с тем же Idempotency-Key и тем же телом возвращает то же подключение (202 или 201), а не дубликат.

​
Ответы при создании

«Нет мощности» — это 202 или 503, но не 409: managed_sip_did_unavailable означает только реальный конфликт номера. Ответы 503 безопасно повторять.

​
Лимиты одновременных звонков

В управляемом развёртывании могут быть включены лимиты одновременных звонков managed-SIP (по умолчанию включены не во всех развёртываниях — уточните у оператора платформы):
  • на подключение — отдельно входящие и исходящие, по 16 по умолчанию;
  • на пользователя — суммарно по всем подключениям (входящие + исходящие); стандартное значение задаётся при включении лимитов.
Значения меняет администратор платформы индивидуально для каждого подключения и пользователя. Семантика отказов при исчерпании лимитов: После завершения звонков занятые слоты освобождаются — счётчики возвращаются к нулю автоматически.

​
Дальше