Быстрый старт для администратора

На этой странице новая компания проходит путь от пустой установки до первого рабочего вызова: мастер настройки, транк, номер (DID), входящий маршрут, IVR, пользователи и подключение софтфона. Каждый шаг указывает страницу консоли. Соответствующий API описан в разделе Начало работы с API, полный справочник находится по адресу /api/docs.

Перед началом завершите одну установку: Docker Compose, виртуальную машину Ubuntu или Kubernetes. Подготовьте ключ восстановления и реквизиты подключения у оператора связи.

:::info Статус Всё, что описано на этой странице, есть в основной ветке. То, что ещё не реализовано, отмечено как будет в Alpha. MonoPbx не проверяет настройки оператора связи: шаблоны транков — это ориентировочные отправные точки, которые нужно сверить с документами оператора. :::

1. Мастер настройки

Откройте одноразовую ссылку настройки, которую напечатал установщик. На виртуальной машине команда sudo mpbx-ctl setup-url выдаёт новую. Мастер:

1. создаёт System Owner (владельца системы): e-mail, имя и пароль по вашему выбору;
2. подключает приложение-аутентификатор владельца (TOTP). Этот шаг использует ссылку;
3. показывает коды восстановления один раз. Храните их вместе с ключом восстановления;
4. задаёт название компании и язык по умолчанию, запрашивает сертификат для адреса установки (ACME, если настроен, иначе загрузка файла), показывает предлагаемый транк из [setup.trunk] и приглашает первых пользователей.

Каждый шаг можно пропустить и завершить позже в консоли. Мастер читает ответы, подготовленные в mpbx.toml в разделе [setup], поэтому вам остаётся их подтвердить. См. руководство по мастеру настройки.

Общесистемные настройки (резервные копии, сертификаты установки) требуют свежего кода из приложения-аутентификатора. Откройте Безопасность учётной записи, затем Администрирование всей установки.

2. Компания, отделы и роли

• Администрирование > Отделы. У каждой компании есть отдел по умолчанию. Создавайте новые, только если нужны отдельные роли или маршрутизация вызовов для групп.
• Администрирование > Роли. Новым пользователям назначается встроенная роль Пользователь (свои вызовы, голосовая почта, справочник). Дополнительные права выдаются для компании или отдела. API проверяет каждый запрос, а консоль показывает только те кнопки, которыми пользователь вправе пользоваться.
• Держите не менее двух человек с ролью Владелец. Последнего Владельца нельзя отключить или лишить роли.

3. Транк

Транк соединяет компанию с оператором связи.

1. Администрирование > Транки > Новый транк. Выберите шаблон провайдера, если он подходит, или общий шаблон регистрации или IP. Шаблоны не проверены: заполните каждое поле из портала оператора.
2. Выберите register (PBX регистрируется у оператора с учётными данными digest) или ip (оператор присылает вызовы с известных адресов; задайте список разрешённых адресов).
3. Введите хост, порт, транспорт и учётные данные аккаунта. Секреты только для записи: консоль больше их не показывает.
4. Задайте максимум каналов равным вашему контрактному лимиту вызовов и основной номер (E.164), который используется для определения номера вызывающего.
5. Проверьте текущее состояние в списке (up, registering, registration failed и так далее). При сбое последняя ошибка показывается словами.

Каждое поле описано в разделе SIP-транки.

4. Номер (DID)

Администрирование > Номера DID. Добавьте каждый купленный номер в формате E.164 (например, +525512345678) и назначьте его транку, по которому он приходит. Номер принадлежит одной компании. Номер, который уже занят другой компанией, отклоняется (MPBX-TRUNK-DID-TAKEN).

5. Входящий маршрут

Администрирование > Маршрутизация > Входящие. Входящий маршрут направляет номер DID в назначение:

• внутренний номер пользователя, группу вызова (Администрирование > Группы вызова), очередь (Администрирование > Очереди), IVR (см. ниже) или reject;
• маршрут без номера является общим для всех номеров, для которых маршрута нет. Точный номер DID на этом транке побеждает точный номер DID на любом транке, который побеждает общий маршрут транка, который побеждает общий маршрут компании.

Перед приёмом реальных вызовов используйте Администрирование > Маршрутизация > Проверка (тестер правил). Он работает тем же маршрутизатором, что и живые вызовы, поэтому показывает, куда попадёт вызов с заданного номера на заданный DID.

Экстренные номера настраиваются в разделе Администрирование > Экстренные номера. Проверьте их перед запуском: консоль объясняет, когда изменение требует одобрения.

6. Исходящие правила

Администрирование > Маршрутизация > Исходящие. Исходящие правила определяют, какой транк несёт набранный номер, в каком порядке и с переключением при сбое. Начните с одного правила для вызовов внутри страны и одного для международных вызовов, затем проверьте оба в тестере правил. Руководство по плану набора описывает правила защиты от мошенничества с телефонией (toll fraud). Прочитайте их, прежде чем открывать международные направления.

7. Меню IVR

Администрирование > Меню IVR. IVR — это меню: приветствие из до 16 голосовых сообщений, до 12 клавиш, каждая из которых ведёт к назначению, число попыток, время ожидания нажатия и сообщения, которые воспроизводятся после неверной клавиши или её отсутствия. Опубликуйте меню, когда оно будет готово. Опубликованная версия никогда не меняется; дальнейшее редактирование создаёт новый черновик.

Чтобы использовать меню, направьте на него входящий маршрут.

Рабочие часы (Администрирование > Часы работы, праздники — в Администрирование > Часы работы > Праздники) могут направлять вызовы на другое назначение, когда компания закрыта или на перерыве. Группы вызова, очереди и настройки переадресации по умолчанию задаются в разделах Администрирование > Группы вызова, Администрирование > Очереди и Администрирование > Переадресация по умолчанию.

8. Внутренние номера, пользователи и приглашения

1. Администрирование > Внутренние номера. У каждого пользователя есть внутренний номер. Почтовые ящики голосовой почты принадлежат внутренним номерам пользователей. Они создаются автоматически, если компания включила автоматическое создание в параметрах голосовой почты по умолчанию (Администрирование > Система > Параметры голосовой почты по умолчанию).
2. Администрирование > Пользователи > Новый пользователь. Введите имя, e-mail, отдел и роли. Оставьте пароль пустым и отправьте приглашение. Пользователь получает одноразовую ссылку по e-mail и выбирает пароль. Пароль никогда не отправляется по e-mail.
3. Пользователей можно также импортировать из CSV (до 2000 строк в файле) на странице «Пользователи». Экспорт использует тот же формат.
4. Отключение пользователя сразу завершает его сеансы. Администратор может сбросить двухфакторную регистрацию или пароль пользователя.

Политика паролей требует не менее 12 символов. Пять неудачных входов блокируют учётную запись на 15 минут.

9. Устройства и подключение софтфона

Каждое устройство регистрируется с собственными учётными данными SIP. Никто не делится паролем внутреннего номера.

• Браузерный телефон. Ничего устанавливать не нужно. Пользователь, который входит в веб-клиент, получает браузерное устройство, и панель софтфона регистрирует его.
• Настольные телефоны. Администрирование > Телефоны показывает шаблоны телефонов для моделей, которые вы используете. Привяжите каждое устройство к внутреннему номеру пользователя в Администрирование > Устройства, затем следуйте указаниям по автоматической настройке (provisioning) из шаблона.
• Мобильные и настольные приложения. Веб-клиент показывает QR-код для устройства. Код действует 10 минут и работает один раз. Приложение сканирует его, получает новые учётные данные только для этого устройства и сохраняет их в хранилище ключей устройства. Сам QR-код не содержит пароля. Подробности см. в руководстве по учётным данным SIP.
• Push-уведомления о входящих вызовах на мобильных устройствах настраиваются в Администрирование > Телефоны > Push. Проверьте состояние push там после настройки.

Перевыпуск или отзыв устройства сразу завершает его регистрации.

10. Первый тестовый вызов

1. Войдите как тестовый пользователь в браузерном телефоне и позвоните на другой внутренний номер.
2. Позвоните на номер DID с внешнего телефона. Проверьте входящий маршрут, сообщения IVR и звонок.
3. Проверьте вызовы в Администрирование > История, а изменения конфигурации — в Администрирование > Журнал аудита.
4. Запустите sudo mpbx-ctl selftest (ВМ) или scripts/smoke.sh (Compose), когда поднят первый транк.

Если вызов не проходит, тестер правил и история вызовов показывают причину. Коды ошибок перечислены в разделе коды ошибок.

Будет в Alpha

• Обновление и откат работающей установки (mpbx upgrade). Пока этой команды нет, пакет другой версии отклоняется, если не передан --force-bundle.
• Опубликованные каналы загрузки для установщика ВМ. Домен загрузки в команде в одну строку сейчас является заглушкой.