Настройка телефонии

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

Создание внутренних номеров, привязка к сотрудникам и запуск браузерного софтфона.

6 минДля администратора

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

Внутренний номер это рабочая точка сотрудника внутри 4phone. На него можно направлять DID, включать его в очередь, использовать в IVR, подключать к браузерному софтфону через WebRTC и регистрировать на внешнем SIP-устройстве или софтфоне.

Когда нужен внутренний номер

Внутренний номер нужен почти всегда, если сотрудник:

  1. принимает входящие напрямую;
  2. участвует в очереди;
  3. работает через софтфон в браузере;
  4. должен быть целью перевода из IVR или другого сценария.

Что настраивается в карточке номера

Обычно вы задаете:

  1. сам номер;
  2. отображаемое имя;
  3. пароль SIP и WebRTC;
  4. привязку к сотруднику;
  5. активность номера;
  6. WebRTC;
  7. запись звонков;
  8. голосовую почту.

Как работает WebRTC

Когда у номера включен WebRTC и он привязан к текущему сотруднику, софтфон в браузере может подключиться и принимать звонки.

Проверьте

Софтфон работает только с вашим номером. Если номер привязан к другому сотруднику, подключиться к нему не получится.

Как устроен SIP адрес номера

В 4phone внутренний номер живет не сам по себе, а внутри SIP-домена тенанта. Поэтому рабочий адрес выглядит так:

101@my-company.sip.4phone.uz

Здесь:

  1. 101 это сам внутренний номер;
  2. my-company.sip.4phone.uz это SIP-домен конкретного тенанта;
  3. sip.4phone.uz это общий SIP-сервер платформы.

Важно

Одинаковые внутренние номера у разных компаний это нормальная ситуация. Например, 101@company-a.sip.4phone.uz и 101@company-b.sip.4phone.uz не конфликтуют, потому что у них разные домены.

Как подключить внешний софтфон или IP телефон

Если сотрудник работает не только через браузер, номер можно зарегистрировать во внешнем SIP-клиенте или IP-телефоне.

Используйте такие параметры:

  1. SIP сервер: sip.4phone.uz
  2. Домен / Realm: <tenant-domain>.sip.4phone.uz
  3. Логин / Username / Auth ID: сам внутренний номер, например 101
  4. SIP адрес: 101@<tenant-domain>.sip.4phone.uz
  5. Пароль: пароль внутреннего номера
  6. Порт SIP UDP или TCP: 5060
  7. Порт SIP TLS: 5061
  8. WebSocket для браузера: wss://sip.4phone.uz:7443

Автоконфигурация IP-телефонов

Если вы используете аппаратные IP-телефоны, 4phone может настроить их автоматически. Поддерживаются три семейства устройств:

  1. Panasonic KX-TGP600 -- DECT база с provisioning через Standard File URL и Master File URL;
  2. Yealink T3/T4/T5 -- настольные IP-телефоны с provisioning через Server URL;
  3. Grandstream GRP26xx -- настольные IP-телефоны с provisioning через Config Server Path.

Как это работает

  1. Администратор создает профиль устройства в разделе Автоконфигурация телефонов, выбирает модель и привязывает внутренний номер.
  2. Система генерирует уникальный токен и набор URL для provisioning.
  3. Эти URL вводятся в Web-интерфейс телефона один раз.
  4. Телефон обращается по указанному адресу, получает готовый конфигурационный файл и настраивает SIP-аккаунт автоматически.
  5. При любом изменении номера, пароля или домена телефон получит обновленные данные при следующем provisioning-цикле.

Пошаговая настройка

Panasonic KX-TGP600:

  1. Откройте Web-интерфейс базы и войдите под admin.
  2. Перейдите в Maintenance > Provisioning Maintenance.
  3. Вставьте Standard File URL и Master File URL из кабинета 4phone.
  4. Сохраните настройки и перезагрузите базу.
  5. Проверьте регистрацию линии в Status > VoIP Status.

Yealink T3/T4/T5:

  1. Откройте Web-интерфейс телефона.
  2. Перейдите в Settings > Auto Provision.
  3. Вставьте Server URL из кабинета 4phone.
  4. Сохраните настройки и запустите Auto Provision или перезагрузите аппарат.
  5. Проверьте, что аккаунт зарегистрировался в разделе Account.

Grandstream GRP26xx:

  1. Откройте Web-интерфейс телефона.
  2. Перейдите в Maintenance > Upgrade and Provisioning > Config File.
  3. Укажите HTTPS в Config Upgrade via и вставьте Config Server Path из кабинета.
  4. Нажмите Save and Apply, дождитесь перезагрузки и проверьте статус линии.

Важно

Токен provisioning можно перегенерировать в любой момент. Старый URL перестанет работать, и в телефон нужно будет ввести новый.

Совет

MAC-адрес устройства можно указать в профиле, но это не обязательно. Основная идентификация идет через уникальный токен в URL.

Где брать данные для регистрации

После создания номера откройте его карточку в списке внутренних номеров и нажмите кнопку с информацией. Внутри карточки появится готовый блок с параметрами подключения:

  1. сервер;
  2. домен;
  3. логин;
  4. пароль;
  5. SIP-порты;
  6. WebSocket URL, если включен WebRTC.

Каждое поле можно скопировать прямо из интерфейса.

Практический порядок настройки

  1. Создайте внутренний номер.
  2. Привяжите его к сотруднику.
  3. Включите WebRTC, если сотрудник работает через браузер.
  4. Сохраните пароль или оставьте поле пустым для автогенерации.
  5. Если сотрудник работает с внешнего устройства, скопируйте SIP-настройки из карточки номера.
  6. Попросите сотрудника открыть виджет софтфона или зарегистрировать внешний SIP-клиент.

Когда включать запись звонков

Если запись включена на внутреннем номере, 4phone старается писать звонки, связанные с этим сотрудником.

Это особенно полезно, если:

  1. нужен контроль качества;
  2. важно сохранять договоренности;
  3. отдел работает со спорными запросами.

Важно

Факт включенного флага записи еще не означает мгновенное появление файла. Запись становится видимой после завершения звонка и последующей обработки.

Когда включать голосовую почту

Если сотрудник может не успеть взять трубку, голосовая почта помогает сохранить сообщение клиента. Это особенно полезно для отдельных персональных DID-маршрутов.

Как понять, что номер настроен правильно

Признаки рабочей настройки

  1. номер активен и виден в списке;
  2. он привязан к нужному сотруднику;
  3. WebRTC включен, если сотрудник работает через браузер;
  4. сотрудник может подключиться к софтфону или внешнему SIP-клиенту;
  5. в карточке номера видны и копируются параметры SIP-регистрации;
  6. входящий или внутренний тестовый звонок доходит до номера.

Частые причины проблем

  1. номер создан, но не привязан к сотруднику;
  2. WebRTC выключен;
  3. сотрудник пытается подключиться чужим номером;
  4. номер отключен;
  5. в SIP-клиенте указан только общий сервер, но не указан tenant-specific домен;
  6. логин указан как полный SIP-адрес, хотя клиент ожидает только номер;
  7. пароль был изменен, а в браузере или SIP-клиенте остались старые данные.

Следом полезно открыть Как пользоваться софтфоном.