Приём звонков от АТС: WebRTC и SIP-подключение

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Приём звонков от АТС: WebRTC и SIP-подключение

Чтобы принимать звонки в TesLab, сотруднику нужен собственный SIP-аккаунт на АТС с поддержкой WebRTC. Сначала администратор назначает подключение, затем сотрудник проверяет регистрацию, устройства и контрольный разговор. Карточка входящего и звук могут приходить разными каналами, поэтому проверяйте их отдельно.

В этой статье

Подготовить станцию и рабочее место

  • Попросите администратора АТС подтвердить поддержку SIP через WebRTC и защищённый WebSocket, адрес станции, фактический WSS-порт и доступность пути /ws.
  • Получите личные логин и пароль SIP-аккаунта. Это реквизиты станции, они отличаются от входа в TesLab.
  • Проверьте сертификат и доступность станции из рабочей сети. Для разговоров между разными сетями отдельно согласуйте прохождение медиа, NAT и межсетевой экран.
  • Подготовьте микрофон и аудиовыход. Откройте TesLab по HTTPS и разрешите использование микрофона в браузере или настройках приложения.
  • Для назначения подключения нужен администратор TesLab или право «Виртуальная АТС сотрудника». Сам сотрудник затем принимает звонки под своей учётной записью.

Подключение сотрудника не создаёт внешнюю телефонную линию и не меняет правила распределения звонков на станции. Внешние номера описаны в инструкции телефонных линий, подробности назначения учётной записи в инструкции виртуальной АТС сотрудника.

Открыть подключение сотрудника

  1. Откройте «Компания → Сотрудники» и найдите нужного человека.
  2. Сверьте сотрудника и выберите в контекстном меню «Виртуальная АТС».
  3. Дождитесь окна «Подключение к виртуальной АТС» и загрузки сохранённых значений.
  4. При отказе чтения закройте окно и разберите причину. Не используйте пустые поля как подтверждение того, что подключение отключено.

Сверить четыре параметра

  1. «Сервер»: отдельное DNS-имя или IPv4 станции, например pbx.example.invalid. Не добавляйте схему, порт или путь.
  2. «Порт»: WSS-порт вашей станции. 8089 является примером, а не универсальным значением.
  3. «Логин»: SIP-имя аккаунта, например 100. Копируйте его из настроек АТС без пробелов и случайных символов.
  4. «Пароль»: SIP-секрет этого аккаунта, а не пароль TesLab. Не передавайте его в URL и не включайте в снимки для обращения в поддержку.
  5. Нажмите «Сохранить», дождитесь результата, затем откройте окно повторно и сверьте параметры.
Параметры SIP-подключения сотрудника: сервер, порт, логин и скрытый пароль
1: адрес станции. 2: WSS-порт. 3: SIP-логин. 4: пароль аккаунта.

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

Как получается адрес подключения

Из примера выше клиент строит wss://pbx.example.invalid:8089/ws и SIP-адрес sip:100@pbx.example.invalid. Путь /ws фиксирован. Эти поля не задают произвольный адрес SIP-сервиса, отдельное имя авторизации или IPv6. WSS нельзя заменить адресом API TesLab или портом его уведомлений.

Проверить регистрацию

  1. Сотрудник входит в TesLab под своей учётной записью.
  2. Откройте телефонную панель в верхней части окна. Если подключение отключено вручную, нажмите «Подключить».
  3. Дождитесь статуса «Подключено» с нужными логином и станцией. «Подключаемся» ещё не означает готовность.
  4. Проверьте, нет ли сообщения о недоступном микрофоне. Регистрация возможна и без него, но говорить не получится.

«Отключить» в панели отключает софтфон на этом рабочем месте, сохраняя параметры сотрудника. Повторное открытие страницы само не отменяет ручное отключение. Чтобы вернуться к приёму звонков, нажмите «Подключить».

Настроить звук и микрофон

  1. В блоке «Уведомления» выберите, где должен звучать входящий звонок. Установите громкость и нажмите кнопку проверки звука.
  2. В блоке «Динамик» выберите, где будете слышать собеседника. Проверьте этот выход и его громкость отдельно.
  3. В поле «Микрофон» выберите устройство записи. Его работу проверяйте контрольным разговором.
  4. После подключения другой гарнитуры снова откройте панель и проверьте выбор. Если прежнее устройство исчезло, программа выбирает «По умолчанию» и сообщает об этом.

Устройства и громкость сохраняются в этом браузере на рабочем месте. Выбор микрофона используется при новом открытии голосового потока; он не переключает уже идущий разговор. Если выбранный микрофон недоступен, браузер может использовать другой. Проверяйте, что собеседник слышит именно нужный источник.

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

Телефонная панель со статусом регистрации, проверкой динамика и выбором микрофона
1: открыть панель. 2: проверить регистрацию. 3: проверить звук динамика. 4: выбрать микрофон.

Принять контрольный звонок

  1. Согласуйте пробный звонок на номер, который станция направляет этому сотруднику. Оставьте TesLab открытым и дождитесь входящего.
  2. Проверьте абонента в карточке. Нажмите «Ответить» и дождитесь перехода к разговору.
  3. Скажите короткую фразу и попросите собеседника ответить. Убедитесь, что обе стороны слышат друг друга.
  4. При необходимости отключите микрофон или поставьте разговор на удержание. После проверки верните разговор в обычное состояние.
  5. Нажмите «Завершить» и проверьте завершение вызова. Если сотрудники работают из разных сетей, повторите проверку для каждого рабочего места.
Карточка входящего звонка с кнопками Ответить и Отклонить
1: ответить на входящий. 2: отклонить SIP-вызов.

У входящей SIP-сессии кнопка «Отклонить» отказывает в приёме вызова. У карточки, пришедшей только как уведомление станции, кнопка «Скрыть» закрывает карточку и не равна отклонению вызова на АТС. Возможность ответа по такой карточке зависит от настроенного перевода или перехвата. Подробности находятся в инструкции уведомлений станции.

Карточка разговора с управлением микрофоном, удержанием и завершением звонка
1: отключить микрофон. 2: удержание. 3: завершить разговор.

Действия диспетчера и работа с заявкой разобраны в инструкции телефона диспетчера. Локальная история панели не является архивом аудиозаписей АТС и не обещает их скачивание. Приём звонков в закрытом или выгруженном приложении проверяется отдельно для конкретного устройства.

Отличить уведомление от разговора

  • SIP через WSS: регистрация аккаунта и управление вызовом.
  • Медиа WebRTC: передача голоса. Доступный WSS сам по себе не подтверждает прохождение медиа между сетями.
  • HTTP-события и AMI: сведения о звонке, его участниках и состоянии. Они не передают звук разговора.

В «Конфигурация → АТС» администратор может задать STUN/STUNS. Пустое поле не добавляет внешние ICE-серверы. Этот список не настраивает TURN с логином и паролем. Не подставляйте случайный публичный STUN вместо проверки сети; нужную схему согласуйте с администратором АТС. Общая настройка описана в инструкции интеграции станции и AMI.

Разобрать отказ

  • Нет телефонной панели. Проверьте, что сотруднику назначены все четыре SIP-параметра и он вошёл под своей учётной записью.
  • Нет команды настройки сотрудника. Проверьте право «Виртуальная АТС сотрудника» и обратитесь к администратору.
  • Нет регистрации. Сверьте хост, WSS-порт, путь, сертификат и SIP-аккаунт. Различайте потерю соединения и ответ станции с отказом регистрации.
  • Подключено, но микрофон недоступен. Разрешите доступ, подключите устройство либо закройте программу, которая заняла микрофон. Затем повторите ответ или набор номера.
  • Выбранный выход не применился. Прочитайте сообщение, проверьте фактическое устройство и повторите локальную пробу. При ограничении браузера используйте настройки ОС.
  • Карточка есть, разговора нет. Проверьте SIP/WebRTC и маршрутизацию станции отдельно от HTTP/AMI. Одна карточка не подтверждает голосовое соединение.
  • Звук только в одну сторону. Проверьте локальные устройства, затем попросите администратора АТС проверить NAT, межсетевой экран и прохождение медиа.
  • Параметры уже изменены. Закройте форму и откройте её снова, сверьте актуальные значения.
  • Результат сохранения не подтверждён. Повторно откройте параметры и проверьте их перед новой попыткой. При обычном отказе введённые значения остаются в окне.

Для обращения передайте действие, время, станцию, добавочный и последний успешный этап. Пароль SIP в сообщение не включайте.