Карточка звонка

Для управления карточкой звонка желательно ознакомиться со сценариями.

Общее описание

Рассмотрим карточку звонка:

Чтобы изменить титульник карточки (область 1), требуется вызвать метод CallCardSetCardTitle и передать объект со свойством title.

Пример:

BX24.placement.call('CallCardSetCardTitle', {title: 'Card Title'}, () => { //some code });

Чтобы изменить текст в области 2, требуется вызвать метод CallCardSetStatusText и передать объект со свойством statusText.

Пример:

BX24.placement.call('CallCardSetStatusText', {statusText: 'Status Text'}, () => { //some code });

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

Пример:

BX24.placement.call('CallCardGetListUiStates', (data) => { console.log(data); });

Переход на другое состояние карточки осуществляется вызовом метода CallCardSetUiState с передачей туда объекта со свойством uiState.

Пример:

BX24.placement.call('CallCardSetUiState', { uiState: 'connected'}, () => { //some code });

Чтобы обрабатывать нажатия оператором кнопок в карточке звонка, требуется подписаться на соответствующие события.

Состояния карточки

Состояние	Описание	Обрабатывается нажатие кнопок
incoming	Для принятия входящих звонков	Ответить - `BackgroundCallCard::answerButtonClick` Пропустить - `BackgroundCallCard::skipButtonClick`
transferIncoming	Для принятия перенаправленного входящего вызова	Ответить - `BackgroundCallCard::answerButtonClick` Пропустить - `BackgroundCallCard::skipButtonClick`
outgoing	Для показа карточки исходящего звонка	Позвонить - `BackgroundCallCard::makeCallButtonClick`
connectingIncoming	Для показа карточки в момент подключения к входящему звонку	Завершить - `BackgroundCallCard::hangupButtonClick`
connectingOutgoing	Для показа карточки в момент подключения к исходящему звонку	Завершить - `BackgroundCallCard::hangupButtonClick`
connected	Для показа после подключения к звонку	Завершить - `BackgroundCallCard::hangupButtonClick` Поставить на удержание - `BackgroundCallCard::holdButtonClick` Выключить микрофон - `BackgroundCallCard::muteButtonClick` Перенаправить на другого оператора - `BackgroundCallCard::transferButtonClick` Нажатие на кнопки цифровой клавиатуры - `BackgroundCallCard::dialpadButtonClick` Оценить качество связи - `BackgroundCallCard::qualityMeterClick` Также, в этом состоянии вы можете со стороны приложения вызывать нажатие на кнопки выключения микрофона и удержания звонка с помощью вызова методов `CallCardSetMute` и `CallCardSetHold` соответственно. Пример: BX24.placement.call('CallCardSetMute', { muted: true }, () => { // some code }); // значение true указывает на выключение микрофона, false - на включение BX24.placement.call('CallCardSetHold', { held: true }, () => { // some code }); // значение true указывает на постановку на удержание, false - на снятие с удержания
transferring	Для подтверждения перенаправления звонка на другого оператора	Перенаправить - `BackgroundCallCard::completeTransferButtonClick` Вернуться к звонку - `BackgroundCallCard::cancelTransferButtonClick`
transferFailed	Если перенаправить звонок не получилось	Вернуться к звонку - `BackgroundCallCard::cancelTransferButtonClick`
transferConnected	Если перенаправление завершилось успешно и требуется выйти из карточки звонка	Завершить - `BackgroundCallCard::hangupButtonClick`
error	Если произошла некоторая ошибка	Закрыть - `BackgroundCallCard::closeButtonClick`
moneyError	Если на счету закончились деньги и требуется проиформировать об этом администратора портала	Уведомить администратора - `BackgroundCallCard::notifyAdminButtonClick` Закрыть - `BackgroundCallCard::closeButtonClick`
redial	Если абонент занят, дать возможность оператору повторно позвонить на этот номер, не скрывая карточку звонка	Перезвонить - `BackgroundCallCard::makeCallButtonClick`
Таймер в карточке звонка	По умолчанию, при переходе на состояние connected автоматически включается таймер звонка. Данное поведение можно отключить, передав помимо `uiState: 'connected'` еще свойство `disableAutoStartTimer` со значением `true`. При переходе же на другие состояния таймер будет останавливаться.

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.