При нажатии на кнопку закрытия карточки звонка BackgroundCallCard::closeButtonClick

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: placement — регистрация точки встраивания, telephony — регистрация звонка, поднимающего карточку

Кто может подписаться: любой пользователь

Событие BackgroundCallCard::closeButtonClick возникает, когда оператор нажимает кнопку «Закрыть» в карточке звонка.

Кнопка есть в исходном виде карточки звонка приложения, а также в состояниях error и moneyError, которые приложение включает командой CallCardSetUiState.

Сразу после события Битрикс24 закрывает карточку сам. Отменить закрытие из обработчика нельзя. Звонок закрытие карточки не завершает, для этого приложение вызывает метод telephony.externalCall.finish. Команда CallCardClose закрывает карточку со стороны приложения, и это событие при ней не возникает.

Событие работает в контексте приложения, открытого в точке встраивания PAGE_BACKGROUND_WORKER. Это событие js-интерфейса, а не событие REST: подписаться на него запросом к /rest/ нельзя.

Что получает обработчик

В обработчик события данные не передаются.

Параметры подписки

Обработчик регистрируют из виджета методом BX24.placement.bindEvent.

Обязательные параметры отмечены *

Название
тип

Описание

event*
string

Имя события интерфейса.

Для данного события — BackgroundCallCard::closeButtonClick

callback*
callable

Функция, которую Битрикс24 вызывает при наступлении события. Аргументы в обработчик не передаются

Примеры кода

Как использовать примеры в документации

BX24.ready(function () {
    BX24.init(function () {
        BX24.placement.bindEvent('BackgroundCallCard::closeButtonClick', function () {
            // код обработчика
        });
    });
});

// $b24 — инициализированный экземпляр SDK, см. руководство по началу работы
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

await $b24.placement.bindEvent('BackgroundCallCard::closeButtonClick', () => {
  // код обработчика
})

<!-- Загрузка SDK в UMD-сборке, глобальный объект B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', async () => {
    const $b24 = await B24Js.initializeB24Frame()

    await $b24.placement.bindEvent('BackgroundCallCard::closeButtonClick', () => {
      // код обработчика
    })
  })
</script>

Ошибки

Проверьте условия.

  • Виджет открыт в точке встраивания PAGE_BACKGROUND_WORKER. В других точках встраивания события BackgroundCallCard::* не зарегистрированы, и подписка молча не сработает
  • Имя события передано без опечаток и с учетом регистра. Список событий, доступных в текущей точке встраивания, возвращает BX24.placement.getInterface
  • Звонок поднят приложением методом telephony.externalCall.register. Для звонков самого Битрикс24 события BackgroundCallCard::* не эмитятся вовсе

Продолжите изучение

Предыдущая
При нажатии на кнопку удержания звонка
Следующая
При выборе оператора для перевода звонка