Используйте HTTPS и аутентификацию HTTP Basic с одобренными учетными данными API. Храните учетные данные на сервере приложений. Эти конечные точки Hosted PBX используют /hpbx/ на api.multitel.net; не вставляйте /v3. Проверяйте как результат HTTP, так и статус приложения в ответе JSON.
Выберите номер и PBX
Формат конечной точки: POST /hpbx/dids/{operation}/{billing_code}. Поддерживаются операции создания, изменения и удаления. Код биллинга должен указывать на PBX, принадлежащую аутентифицированной учётной записи. Запись маршрутизации не приобретает новый публичный телефонный номер.
Поля маршрутизации
| Поле | Назначение |
|---|---|
| number / fullnumber | DID, представленный записью маршрутизации PBX. |
| comment | Описание для администратора. |
| maxchannels | Максимальное число одновременных вызовов маршрута PBX. |
| destination | Упорядоченные значения назначений для выбранной PBX. |
| unconditional | Место назначения безусловной переадресации при использовании. |
| cnam | Настройка поиска имени вызывающего абонента; может взиматься плата за использование. |
| recording | Политика записи: no, yes, yeschange или nochange. |
| di_emailrecording / di_minemailrecording | Адрес электронной почты для записей и минимальная продолжительность. |
| allowemergency / emergencynotes | Настройки идентификатора вызывающего абонента для экстренных вызовов; они не регистрируют адрес для экстренных вызовов. |
| didprefix / didnameprefix | Префиксы номера/имени вызывающего абонента. |
| fax / faxprotocol / faxstore / faxemail | Обнаружение факса, протокол и варианты доставки/хранения. |
| sms_destination / di_smstofield / di_sms_store | Включенные настройки доставки и хранения сообщений. |
Подготовьте допустимые назначения
Значения назначения должны браться из выбранной PBX; прежний пример Array() не был JSON-данными или полезной нагрузкой формы. Определите внутренние номера, IVR или группы перед формированием запроса. Используйте актуальную схему маршрутизации номеров для интерфейса API, с которой вы интегрируетесь.
Проверьте результат
Проверьте статус операции на уровне API в ответе JSON, повторно откройте конфигурацию номера и выполните контрольный входящий вызов. Проверьте отдельно сценарии занятости, отсутствия ответа, тайм-аута и пути записи/факса/сообщений. Следуйте руководству по маршрутизации в портале для пошаговой настройки.