Внутренние номера и устройства

Маршруты: /extensions и /devices (полный справочник см. в /api/docs).

Внутренние номера

Страница внутренних номеров со списком номеров, имён, владельцев и статусов.

Страница «Внутренние номера».

Внутренний номер — это номер для набора внутри компании.

Поле	Значение
`number`	От 1 до 16 цифр, уникален в пределах компании.
`kind`	Куда ведёт номер: `user`, `queue`, `ivr`, `ringgroup`, `conference`, `park`, `paging` или `fax`. По умолчанию `user`.
`user_id`	Владелец, только для `kind = user`. У пользователя не более одного внутреннего номера.
`display_name`	Отображается на телефонах и в справочнике. Для номера с владельцем по умолчанию берётся имя пользователя.
`enabled`	Отключённые внутренние номера не маршрутизируются.
`target_flow_id`	Только для `kind = ivr`: меню IVR или сценарий вызова, который запускается при внутреннем вызове на номер (см. Меню IVR). `null` означает, что сценария нет.

Права: extensions:read и extensions:write, оба ограничены отделом.

Внутренний номер принадлежит отделу своего владельца. Номер без владельца (очередь, IVR, группа вызова или зарезервированный номер) относится ко всей компании, поэтому для работы с ним нужно право на уровне компании. Чтобы отвязать владельца, отправьте PATCH с remove_owner: true. Удаление внутреннего номера также удаляет его устройства.

Назначение внутреннего номера учётной записи, которая имеет системную роль, или снятие его с такой учётной записи отклоняется для субъектов компании (MPBX-ACCOUNT-SYSTEM).

Устройства

Страница устройств со значками статуса, например «Есть учётные данные» и «Нужны новые учётные данные».

Страница «Устройства». Имена пользователей SIP размыты; пароли SIP никогда не показываются.

Устройство — это одна SIP-идентичность (настольный телефон, софтфон или приложение) внутреннего номера.

Поле	Значение
`extension_id`	Внутренний номер, которому оно принадлежит.
`name`	Метка устройства.
`sip_username`	Формируется сервером.
`transport_policy`	Какие транспорты SIP может использовать устройство.
`mac`, `model`, `provisioning_template`	Необязательные сведения об оборудовании. Пустая строка в `PATCH` очищает их.
`has_credentials`	Есть ли у устройства учётные данные SIP. Сами учётные данные маршруты устройств никогда не показывают.
`revoked_at`	Заполняется, когда устройство отозвано.

Права: devices:read и devices:write, ограниченные отделом через владельца внутреннего номера.

POST /devices/{id}/revoke удаляет учётные данные устройства и запрещает ему регистрацию. Создание и смена учётных данных выполняются отдельным процессом для каждого устройства, который не входит в эти маршруты.

Текущие регистрации публикуются как события device в WebSocket событий для тех, у кого есть право devices:read.

Автоматическая настройка телефонов

Настольные телефоны (Yealink, Fanvil, Snom, Grandstream) настраиваются автоматически по своему MAC-адресу. См. Автоматическая настройка настольных телефонов. Чтобы подключить приложение или браузер, см. Добавление пользователей, внутренних номеров и телефонов.