Документация для разработчиков
Темная тема

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

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

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

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

card1.png

Чтобы изменить титульник карточки (область 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 card01-02.png Для принятия входящих звонков
  • Ответить - BackgroundCallCard::answerButtonClick
  • Пропустить - BackgroundCallCard::skipButtonClick
transferIncoming card01-02.png Для принятия перенаправленного входящего вызова
  • Ответить - BackgroundCallCard::answerButtonClick
  • Пропустить - BackgroundCallCard::skipButtonClick
outgoing card03.png Для показа карточки исходящего звонка
  • Позвонить - BackgroundCallCard::makeCallButtonClick
connectingIncoming card04-05-09.png Для показа карточки в момент подключения к входящему звонку
  • Завершить - BackgroundCallCard::hangupButtonClick
connectingOutgoing card04-05-09.png Для показа карточки в момент подключения к исходящему звонку
  • Завершить - BackgroundCallCard::hangupButtonClick
connected card06.png Для показа после подключения к звонку
  • Завершить - 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 card07.png Для подтверждения перенаправления звонка на другого оператора
  • Перенаправить - BackgroundCallCard::completeTransferButtonClick
  • Вернуться к звонку - BackgroundCallCard::cancelTransferButtonClick
transferFailed card08.png Если перенаправить звонок не получилось
  • Вернуться к звонку - BackgroundCallCard::cancelTransferButtonClick
transferConnected card04-05-09.png Если перенаправление завершилось успешно и требуется выйти из карточки звонка
  • Завершить - BackgroundCallCard::hangupButtonClick
error card010.png Если произошла некоторая ошибка
  • Закрыть - BackgroundCallCard::closeButtonClick
moneyError card011.png Если на счету закончились деньги и требуется проиформировать об этом администратора портала
  • Уведомить администратора - BackgroundCallCard::notifyAdminButtonClick
  • Закрыть - BackgroundCallCard::closeButtonClick
redial card012.png Если абонент занят, дать возможность оператору повторно позвонить на этот номер, не скрывая карточку звонка
  • Перезвонить - BackgroundCallCard::makeCallButtonClick
Таймер в карточке звонка

По умолчанию, при переходе на состояние connected автоматически включается таймер звонка. Данное поведение можно отключить, передав помимо uiState: 'connected' еще свойство disableAutoStartTimer со значением true. При переходе же на другие состояния таймер будет останавливаться.



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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2023, «1С-Битрикс», 2023
Наверх